Ad Hoc Distribution — o que é, limitações de teste iOS

O que é Ad Hoc Distribution?

Ad Hoc Distribution é um método de distribuição de aplicativos iOS disponível para todos os membros do Apple Developer Program ($99/ano). Ele permite instalar aplicativos diretamente em dispositivos sem passar pela moderação da App Store. O objetivo principal são os testes pré-lançamento: desenvolvedores, testadores e clientes podem instalar o aplicativo em seus dispositivos antes do lançamento oficial.

Ad Hoc Distribution usa um Provisioning Profile que inclui uma lista de UDIDs de dispositivos permitidos. Ao assinar o aplicativo, o Xcode ou Fastlane cria um arquivo IPA que só pode ser instalado em dispositivos desta lista. Cada UDID é adicionado através do Apple Developer Portal, e o total não pode exceder 100 dispositivos por conta de desenvolvedor.

De acordo com a Apple (2025), o Ad Hoc Distribution continua sendo demandado para testes pré-lançamento quando o aplicativo ainda não passou pela moderação da App Store, mas já precisa ser mostrado ao cliente ou testado em dispositivos reais. No entanto, a Apple recomenda usar o TestFlight para testes beta em grande escala, deixando o Ad Hoc para grupos pequenos e casos especiais.

Como funciona a distribuição Ad Hoc?

A distribuição Ad Hoc funciona através de instalação OTA (Over-The-Air) ou via iTunes/Finder. O desenvolvedor cria um Ad Hoc Provisioning Profile com os UDIDs selecionados, assina o aplicativo com este perfil e exporta o arquivo IPA. O usuário instala o aplicativo através do Safari por um link ou através do Finder no macOS.

Tecnicamente, a distribuição Ad Hoc envolve várias etapas. Primeiro, o administrador coleta os UDIDs dos dispositivos de teste — cada UDID é um identificador único de 40 caracteres para um dispositivo iOS. Em seguida, os UDIDs são adicionados ao Apple Developer Portal, um Provisioning Profile é criado e um IPA assinado é gerado. A validade de um perfil Ad Hoc é de um ano, após o qual os aplicativos param de abrir.

# Fastlane — automatize a distribuição Ad Hoc
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Para instalar um aplicativo Ad Hoc, o usuário deve confiar no certificado do desenvolvedor em seu dispositivo. Para isso, nas configurações do iOS vá em "Geral" → "VPN e Gerenciamento de Dispositivos" → "Perfil" e toque em "Confiar". Sem esta etapa, o aplicativo não será iniciado.

Registro de UDID e limite de 100 dispositivos

UDID (Unique Device Identifier) é um identificador único para cada dispositivo iOS. Para a distribuição Ad Hoc, você precisa coletar os UDIDs de todos os dispositivos de teste e adicioná-los ao Apple Developer Portal. O máximo é de 100 dispositivos por conta de desenvolvedor por ano. Este limite se aplica a todos os aplicativos do desenvolvedor, não a cada aplicativo individualmente.

O limite de 100 dispositivos é redefinido no final do ano calendário — a redefinição ocorre em 1º de janeiro. No entanto, a Apple recomenda usar o TestFlight para testes em grande escala, que suporta até 10 000 testadores externos. O Ad Hoc Distribution desde 2022 continua relevante para casos em que o aplicativo ainda não passou pela Beta App Review ou quando os testes exigem acesso ao arquivo IPA original.

Configuração do Ad Hoc Distribution

A configuração do Ad Hoc Distribution é feita através do Apple Developer Portal e do Xcode. O processo inclui o registro de dispositivos, criação de um Provisioning Profile, assinatura do aplicativo e exportação do IPA para distribuição. Para desenvolvimento em equipe, recomenda-se usar Fastlane ou automação via CI/CD.

1. Coletar UDIDs dos dispositivos de teste via udid.io ou um perfil de configuração
2. Adicionar UDIDs ao Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Criar um Ad Hoc Provisioning Profile para o Bundle ID necessário, incluindo os dispositivos registrados
4. Assinar o aplicativo com o perfil Ad Hoc no Xcode: Product → Archive → Distribute Ad Hoc
5. Exportar o arquivo IPA e distribuir o link via um servidor OTA ou Firebase App Distribution
6. Para o usuário: abrir o link no dispositivo, instalar o aplicativo, confiar no certificado nas configurações

Para simplificar o processo, são usados serviços de distribuição: Firebase App Distribution, Microsoft App Center ou BuddyBuild. Esses serviços gerenciam automaticamente os UDIDs, criam perfis Ad Hoc e enviam convites aos testadores. O Firebase App Distribution também se integra com pipelines CI/CD via Gradle ou Fastlane.

Uma nuance importante — atualização de UDID. Se precisar adicionar um novo dispositivo ao perfil, você terá que recriar o Provisioning Profile e reassinar o aplicativo. Os dispositivos que já instalaram o aplicativo continuarão usando-o até o vencimento do perfil (1 ano). Após isso, é necessária uma reinstalação com um novo perfil.

Ad Hoc vs TestFlight e Enterprise

Ad Hoc Distribution é apenas um dos três métodos de distribuição de aplicativos iOS sem a App Store. O TestFlight (gratuito, até 10 000 testadores externos) e o Enterprise Distribution (sem limite de dispositivos, para aplicativos corporativos) resolvem tarefas semelhantes com diferentes limitações e requisitos.

O TestFlight é o método preferido da Apple para testes beta. Ele não exige coleta de UDIDs, suporta até 100 testadores internos e 10 000 externos, gerencia versões automaticamente e fornece análises de instalação. No entanto, o TestFlight exige a aprovação da Beta App Review para testadores externos, o que pode levar de 1 a 2 dias. O Ad Hoc Distribution não requer nenhuma moderação.

O Enterprise Distribution é adequado para aplicativos corporativos com número ilimitado de dispositivos, mas exige inscrição no Apple Developer Enterprise Program ($299/ano) com um número D-U-N-S. O Ad Hoc está disponível para todos os membros do programa padrão ($99/ano) e não exige verificação legal da empresa. Para equipes pequenas e projetos, o Ad Hoc continua sendo a forma mais simples de distribuição sem a App Store.