O que há dentro de um IPA antes de instalá-lo
Última atualização:
Um arquivo .ipa é um ZIP contendo um único pacote de app iOS — e quase tudo o que importa sobre o app está escrito antes de uma única linha do seu código ser executada. Renomeie-o para .zip e qualquer descompactador o abrirá: uma pasta Payload, um pacote .app, e dentro dele o executável do app, seus recursos, seus frameworks e sua assinatura. Duas listas de propriedades contam a história. O Info.plist é a carteira de identidade do app — nome, bundle ID, versões, o iOS mais antigo no qual ele será instalado, e as palavras exatas que ele mostrará ao pedir sua câmera ou sua localização. O embedded.mobileprovision é o perfil de provisionamento: quem pode assinar o código, em quais dispositivos ele pode rodar, quando expira, e quais capacidades ele pode reivindicar. Este artigo ensina você a ler ambas, além dos frameworks e dos hashes da assinatura — e o Analisador de IPA as lê por você, no seu navegador, sem enviar o arquivo.
O que é um .ipa — um ZIP com um Payload
Cada app iOS que você já instalou chegou como um .ipa, tenha vindo da App Store, do TestFlight ou da pasta de compilação de um desenvolvedor. O formato não tem mistério: é um arquivo ZIP, e seu layout é fixado por convenção. No topo há uma pasta chamada Payload, e dentro dela exatamente um diretório terminado em .app — o pacote do aplicativo. Tudo o que o app precisa para rodar vive nesse pacote: o executável Mach-O, o Info.plist, o catálogo de recursos, as cadeias localizadas, os frameworks que ele vincula, e o diretório _CodeSignature que guarda o inventário de hashes da assinatura. Pacotes da App Store acrescentam alguns irmãos — SwiftSupport, Symbols, Watch — mas o pacote Payload é o app, e tem a mesma forma em todos os canais de distribuição.
A parte ZIP importa porque torna o pacote inspecionável sem nenhuma ferramenta da Apple. Você não precisa de Xcode, de um Mac ou de um ID Apple para olhar dentro: qualquer descompactador abre o arquivo, e os arquivos interessantes são listas de propriedades — o formato chave-valor da Apple, guardado como XML legível ou como uma forma binária compacta que precisa de um leitor. Essa é toda a premissa do analisador deste site: o arquivo já é um livro aberto, e o único trabalho é ler as duas listas de propriedades, o diretório de frameworks e os hashes da assinatura, tudo localmente. Nada sobre o pacote é criptografado — o executável é assinado por código, não embaralhado — então o que você vê ao abri-lo é o que o iOS vê ao decidir se o app pode ser instalado e iniciado.
Info.plist: a carteira de identidade do app
O primeiro arquivo que o iOS lê é o Info.plist, e ele responde às perguntas que você faria sobre qualquer app antes de confiar nele. O CFBundleIdentifier é o bundle ID — o nome de domínio reverso, como com.sysosx.ipa-analyzer-demo, que identifica o app para atualizações, para o chaveiro e para o perfil de provisionamento. Dois campos de versão viajam juntos e significam coisas diferentes: o CFBundleShortVersionString é a versão de marketing que as pessoas veem (“1.2.3”), enquanto o CFBundleVersion é o número da compilação que os desenvolvedores acompanham (“42”) — a compilação é o que incrementa a cada upload, então duas compilações podem compartilhar uma versão de marketing e ainda ser software diferente. O MinimumOSVersion declara o iOS mais antigo no qual o app afirma ser instalado, e o UIDeviceFamily diz para qual hardware ele foi construído, em números: 1 é iPhone, 2 é iPad.
O resto da carteira de identidade trata do comportamento antes do lançamento. O CFBundleExecutable nomeia o binário Mach-O que o iOS executará; o LSRequiresIPhoneOS confirma que o pacote é mesmo um app iOS; o UIRequiredDeviceCapabilities lista o hardware sem o qual o app se recusa a rodar, como arm64; o UIBackgroundModes lista o trabalho em segundo plano que ele pode fazer, como buscar conteúdo ou receber notificações remotas; o CFBundleURLTypes lista os esquemas de URL aos quais o app responde — os links personalizados que outros apps podem usar para abri-lo. Os metadados de compilação também viajam junto: DTPlatformName, DTSDKName e DTXcodeBuild registram qual plataforma, SDK e compilação do Xcode produziram o binário, e é assim que se distingue uma compilação feita na semana passada de uma feita há dois anos sem perguntar ao desenvolvedor.
Os diálogos de permissão que você verá
As chaves mais consequentes do Info.plist são aquelas que os usuários realmente encontram: as cadeias NS*UsageDescription. Cada vez que um app iOS pede um recurso protegido — a câmera, a fototeca, o microfone, a localização, os contatos, os calendários — o iOS mostra a própria cadeia de descrição do app no diálogo, e o app não pode mudar esse texto em tempo de execução. O NSCameraUsageDescription é a frase sob “Permitir que o Demo App acesse sua câmera?”; o NSLocationWhenInUseUsageDescription é o do diálogo de localização. Essas cadeias não são decoração. São a razão declarada do app, escrita pelo desenvolvedor e mostrada literalmente pelo sistema — e lê-las antes de instalar é a revisão de privacidade mais barata que existe.
A regra que as torna dignas de leitura é rigorosa: no iOS moderno, uma permissão sem cadeia de descrição de uso não pode ser solicitada, e a Apple rejeita a compilação na revisão se uma API protegida for usada sem uma. Assim, uma tabela de permissões com quatro entradas — câmera, fototeca, localização durante o uso, microfone — diz exatamente quais diálogos o app está preparado para mostrar, e uma entrada ausente diz que o app não pode pedir aquela coisa mesmo que seu código tente. O app de demonstração deste site declara exatamente essas quatro, com razões em linguagem simples: a câmera escaneia documentos, a fototeca anexa fotos, a localização mostra lugares próximos enquanto você usa o app, o microfone grava notas de voz. Uma lanterna com descrição de microfone, ou uma calculadora com descrição de localização, se destacaria na mesma tabela — o texto do diálogo é o lugar onde o exagero fica escrito com as próprias palavras do desenvolvedor.
O perfil de provisionamento, em cinco perguntas
Cada app iOS é distribuído com uma segunda lista de propriedades, o embedded.mobileprovision, e ela responde a outro conjunto de perguntas — não o que o app é, mas se a Apple autoriza sua execução. A própria nota técnica da Apple sobre o assunto, a TN3125, descreve o perfil como a resposta a cinco perguntas. Quem pode assinar o código: a propriedade DeveloperCertificates guarda os certificados de cada desenvolvedor autorizado a assinar o código coberto pelo perfil, e a compilação deve ser assinada por um deles. O que eles podem assinar: um App ID, codificado em Entitlements como application-identifier — um prefixo de equipe mais o bundle ID. Onde ele pode rodar: o ProvisionedDevices lista os identificadores de dispositivo autorizados a instalá-lo; perfis da App Store não têm lista de dispositivos, porque aquela compilação é enviada, nunca instalada diretamente.
Quando ele pode rodar: cada perfil traz uma ExpirationDate, normalmente não mais que um ano, e apenas sete dias em uma Equipe Pessoal gratuita — um perfil expirado significa que o app não será iniciado, por mais recente que tenha sido sua instalação. Como ele pode ser autorizado: a propriedade Entitlements é uma lista de permissões das capacidades que o app pode reivindicar — notificações push (aps-environment), grupos de chaveiro, App Groups, domínios associados — e cada entitlement que o app reivindica deve estar nela. Dois detalhes importam ao ler um. Primeiro, o arquivo é uma lista de propriedades envolta em uma assinatura CMS, então lê-la significa desembrulhar essa assinatura — em um Mac, o security cms -D faz isso; o analisador deste site faz o mesmo desembrulhamento no navegador. Segundo, desde o iOS 15 o perfil também traz um DER-Encoded-Profile que é a nova fonte da verdade, enquanto a lista XML continua legível; o analisador observa quando há um presente e mostra os valores da lista XML do mesmo arquivo.
Frameworks e a lista de arquivos: o que vem dentro
Além das duas listas de propriedades, o pacote é um manifesto daquilo de que o app é feito. O diretório Frameworks guarda os frameworks dinâmicos que o app vincula — frequentemente bibliotecas de terceiros como Alamofire ou SnapKit, às vezes o próprio código compartilhado do desenvolvedor. Cada framework é em si um pequeno pacote, e sua presença diz do que o app depende sem descompilar nada: uma biblioteca de rede, um banco de dados, um SDK de análise. A lista completa de arquivos acrescenta o resto: o catálogo de recursos (Assets.car) com as imagens do app, os arquivos de ícone, as cadeias localizadas .lproj, as extensões de app (.appex) como widgets ou folhas de compartilhamento, e o próprio executável. Uma lista de arquivos é também onde vai o tamanho: o total é o download que você está aceitando, e um único framework maior que o próprio código do app é um fato digno de nota.
A lista de arquivos é mais útil quando lida junto à assinatura. O _CodeSignature/CodeResources é uma lista de propriedades que registra um hash para cada arquivo do pacote — hash é SHA-1, hash2 é SHA-256 — para que o iOS possa verificar que nada mudou após a assinatura. O analisador cruza as duas: cada arquivo do app deveria aparecer no CodeResources, e qualquer arquivo que não apareça é relatado em vez de silenciosamente presumido. Essa verificação trata de integridade, não de segurança — um arquivo malicioso corretamente assinado continua corretamente assinado — mas é a verificação que detecta um pacote adulterado depois de sair do assinante, ou um pacote montado à mão e nunca assinado corretamente.
O que o Analisador de IPA mostra — e o que ele não pode mostrar
Solte o .ipa de demonstração no Analisador de IPA e a página lê o pacote do jeito que este artigo faz: o resumo do app (Demo App, 1.2.3, compilação 42, iOS mínimo 17.0, iPhone e iPad), os quatro textos de permissão literalmente, os entitlements do perfil (push de produção, um grupo de chaveiro, get-task-allow falso — uma compilação de lançamento, não depurável), os dois frameworks vinculados, o perfil de provisionamento com expiração em 2027-11-21, o certificado de assinatura com sua impressão digital SHA-256, e a cobertura do CodeResources — oito arquivos com hash, oito listados. O arquivo nunca sai do seu dispositivo: o ZIP, as listas e o invólucro CMS são todos analisados na página, e as três exportações CSV (lista de arquivos, permissões, frameworks) são geradas localmente como downloads.
O que ele não pode fazer importa tanto quanto o que faz. Ele não verifica a assinatura de código criptograficamente — lê o inventário de hashes e os certificados, mas não confere os hashes com os arquivos nem a assinatura com os servidores da Apple, então um perfil expirado ou revogado é relatado a partir de suas próprias datas, não de uma consulta ao vivo. Ele não analisa o superblob de assinatura de código embutido no binário Mach-O; os certificados mostrados vêm dos DeveloperCertificates do perfil de provisionamento, que são as identidades de assinatura que o perfil autoriza. Ele não descompila código, não executa o app, nem julga se o app é malware — um resultado limpo aqui significa “nada do que foi declarado parece errado”, nunca um certificado de segurança. Para o equivalente Android desta verificação, o Analisador de APK lê pacotes Android do mesmo modo, e para abrir qualquer plist à mão — binário ou XML — o Plist Workbench lê e edita ambos os formatos.
O Info.plist do app de demonstração, como XML
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDisplayName</key>
<string>Demo App</string>
<key>CFBundleName</key>
<string>DemoApp</string>
<key>CFBundleIdentifier</key>
<string>com.sysosx.ipa-analyzer-demo</string>
<key>CFBundleShortVersionString</key>
<string>1.2.3</string>
<key>CFBundleVersion</key>
<string>42</string>
<key>CFBundleExecutable</key>
<string>DemoApp</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>MinimumOSVersion</key>
<string>17.0</string>
<key>UIDeviceFamily</key>
<array>
<integer>1</integer>
<integer>2</integer>
</array>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>NSCameraUsageDescription</key>
<string>Demo App uses the camera to scan documents.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Demo App accesses your photo library so you can attach pictures.</string>
</dict>
</plist>