App Bundle ID — o que é, identificador de aplicativo e registro

O que é App Bundle ID

Bundle Identifier é uma string que identifica exclusivamente um aplicativo no sistema operacional e na loja de aplicativos. No iOS e macOS é chamado de Bundle ID, no Android — Package Name, embora funcionalmente ambos desempenhem o mesmo papel: garantir a exclusividade do aplicativo no dispositivo e na loja.

Propósito do Bundle ID

O sistema operacional usa o Bundle ID para diferenciar aplicativos no dispositivo. Dois aplicativos com o mesmo identificador não podem ser instalados simultaneamente — o sistema os trata como o mesmo produto. As lojas de aplicativos também verificam a exclusividade do Bundle ID durante a publicação.

História e padrões de nomenclatura

A Apple introduziu o Bundle ID com o lançamento do iOS SDK em 2008. O formato de notação reversa de domínio foi emprestado do Java (convenção de nomenclatura de pacotes), onde é usado para evitar conflitos de nomes de classes. O Google adotou essa prática para o Android, garantindo consistência em ambos os ecossistemas móveis.

Como funciona o formato Bundle ID

O Bundle ID consiste em vários segmentos separados por pontos. A primeira parte é o identificador do desenvolvedor ou empresa (com, org, net). A segunda é o domínio da empresa (example, google, apple). Os segmentos seguintes especificam o nome do aplicativo e a plataforma.

Estrutura do Bundle ID

Um Bundle ID típico tem o formato com.company.appname. A Apple recomenda usar a notação reversa de domínio para garantir exclusividade global. Se a empresa não tiver domínio, é permitido usar email: com.example.myapp ou org.example.myapp.

• Segmento 1 — TLD em ordem inversa: com, org, io, net
• Segmento 2 — domínio da empresa ou desenvolvedor: google, apple, mycompany
• Segmento 3 — nome do aplicativo: maps, mail, notes
• Adicional — plataforma ou extensão: watchkit, todaywidget

Wildcard Bundle ID

A Apple oferece suporte a Wildcard Bundle ID — um modelo de identificador com asterisco: com.example.*. Este modelo permite usar um mesmo App ID para vários aplicativos da mesma empresa. O Wildcard ID é conveniente durante o desenvolvimento, mas não é recomendado para produção, pois limita o uso de alguns serviços da Apple.

Limitações do wildcard: Notificações Push, CloudKit, Compras no Aplicativo (In-App Purchase) e Game Center exigem um Bundle ID explícito. Ao usar o modelo com.example.*, esses serviços ficam indisponíveis. Para aplicativos em produção, use sempre um Bundle ID explícito para garantir a funcionalidade completa de todos os serviços da Apple.

Além do wildcard, a Apple oferece suporte a identificadores com prefixo que são atribuídos à equipe de desenvolvimento ao se registrar no Apple Developer Program. O prefixo (Team ID) é adicionado automaticamente a todos os App IDs e perfis de provisionamento. Dois Team IDs diferentes podem criar o mesmo Bundle ID, mas no dispositivo são considerados aplicativos distintos.

Registro de Bundle ID em consoles

O registro do Bundle ID é uma etapa obrigatória antes de publicar um aplicativo. No ecossistema Apple, o registro é feito no Apple Developer Portal através da seção Certificates, Identifiers & Profiles. No Google Play, o Bundle ID é especificado ao criar o aplicativo no console do desenvolvedor.

Registro no Apple Developer Portal

No portal Apple Developer, selecione a seção Identifiers, clique no botão Register e especifique o tipo de App ID. Insira o nome exato do Bundle ID e selecione os recursos necessários: Push Notifications, CloudKit, Sign in with Apple. Após o registro, o identificador fica disponível para criar perfis de provisionamento.

// Verificação de Bundle ID no código do aplicativo
let bundleID = Bundle.main.bundleIdentifier
print("Current Bundle ID: \(bundleID ?? "unknown")")

// Verificação de Bundle ID para condições de compilação
if bundleID == "com.example.app.production" {
    // Configuração de produção
    Analytics.shared.configure(.production)
}

Registro no Google Play Console

Google Play Console não exige registro prévio do Bundle ID. O identificador é especificado no arquivo build.gradle do módulo do aplicativo e deve ser único em todo o Google Play. Após criar o aplicativo, é impossível alterar o Package Name, portanto escolha o identificador cuidadosamente e verifique sua exclusividade através de uma pesquisa no Google Play. O Google não libera identificadores de aplicativos removidos, portanto um Bundle ID uma vez ocupado permanece indisponível para outros desenvolvedores.

Ao se registrar no App Store Connect, você deve especificar um Bundle ID do conjunto existente de identificadores registrados. Se o identificador ainda não estiver registrado no portal Apple Developer, o sistema oferecerá criá-lo automaticamente. Após o registro, o Bundle ID é vinculado à equipe e não pode ser transferido para outra conta de desenvolvedor sem entrar em contato com o suporte da Apple. Cada Bundle ID pode ter vários perfis de provisionamento para diferentes ambientes: Development, Ad Hoc, App Store.

Ao registrar um Bundle ID para um aplicativo iOS com extensões, cada componente deve ser registrado separadamente. Extensões de widgets, teclados, Notification Service e Watch App têm seus próprios identificadores derivados do principal. O App Store Connect os agrupa ao criar um App Record, permitindo publicar todos os componentes como um único aplicativo.

Configuração de Bundle ID no projeto Xcode

A configuração do Bundle ID no Xcode é feita em vários lugares: Info.plist, Build Settings e Signing & Capabilities. O campo central é Bundle Identifier no target do aplicativo. Todos os serviços da Apple, desde notificações Push até CloudKit, são vinculados a este identificador. Um Bundle ID especificado incorretamente causa erros de assinatura e a impossibilidade de publicar na App Store.

Alteração de Bundle ID no Xcode

<!-- Info.plist — Bundle ID base do projeto -->
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>

<!-- Build Settings — variável PRODUCT_BUNDLE_IDENTIFIER -->
<!-- Debug: com.example.app.dev -->
<!-- Release: com.example.app -->

O Xcode usa a variável PRODUCT_BUNDLE_IDENTIFIER nas Build Settings. Valores diferentes podem ser definidos para diferentes configurações de compilação: com.example.app.dev para Debug e com.example.app para Release. Isso é conveniente para instalar uma versão de desenvolvimento junto com a versão de produção no mesmo dispositivo para testes.

Configuração multi-target

Se o aplicativo tiver extensões (Notification Service, Widget, Watch App), cada extensão recebe seu próprio Bundle ID com um sufixo. Aplicativo principal: com.example.app. Extensão de widget: com.example.app.widget. Watch App: com.example.app.watchkit. Cada identificador é registrado separadamente no Apple Developer Portal e recebe seu próprio perfil de provisionamento. O Xcode gerencia automaticamente essas dependências durante a compilação.

Diferenças entre App Bundle ID e Package Name

App Bundle ID (Apple) e Package Name (Google) são entidades semelhantes com o mesmo propósito, mas com regras de uso diferentes nos ecossistemas iOS e Android. Ambos os identificadores usam notação reversa de domínio e não podem ser alterados após a publicação em lojas oficiais de aplicativos.

Diferenças funcionais

No ecossistema Apple, o Bundle ID está vinculado ao perfil de provisionamento e aos certificados. Ao mudar de equipe de desenvolvimento, o Bundle ID pode ser transferido entre contas através do App Store Connect. No Android, o Package Name está estritamente vinculado ao aplicativo no Google Play e não pode ser transferido entre contas de desenvolvedor.

Apesar das diferenças, ambos os identificadores desempenham um papel crítico: sem eles é impossível publicar um aplicativo em uma loja oficial. Recomendação para projetos multiplataforma — use o mesmo identificador nas versões iOS e Android para simplificar a integração com Firebase, Analytics e outros serviços. Isso também simplifica a navegação para a equipe de desenvolvimento: um identificador para ambos os projetos reduz a confusão ao configurar CI/CD e a configuração de ambientes.

Ao desenvolver com Flutter ou React Native, um identificador único é especialmente importante, pois a base de código é compartilhada e muitas ferramentas de compilação automatizada esperam o mesmo nome de pacote para ambas as plataformas. Um projeto Firebase também é vinculado a um único identificador para iOS e Android, simplificando a configuração de análises e relatórios de falhas.