O Que é Provisioning Profile e Para Que Serve

Explicação simples do que é, os tipos existentes e como resolver os erros mais comuns no Xcode.

4 min 2025

Definição simples

Um provisioning profile é um arquivo que a Apple usa para autorizar um app a rodar em determinados dispositivos ou a ser distribuído na App Store. Ele combina três elementos: sua identidade como desenvolvedor (certificado), o app específico (App ID) e os dispositivos autorizados.

Pense nele como um "passe de segurança" que a Apple exige para cada app que você distribui.

Tipos de Provisioning Profile

Desenvolvimento

Development Provisioning Profile

Usado para testar o app em dispositivos físicos durante o desenvolvimento. Lista os dispositivos específicos que podem instalar o app.

Distribuição

Distribution Provisioning Profile

Usado para enviar o app para a App Store ou para o TestFlight. Não limita dispositivos — qualquer pessoa pode baixar na loja.

Ad Hoc

Ad Hoc Provisioning Profile

Distribuição direta para até 100 dispositivos específicos. Usado para testes externos sem passar pelo TestFlight.

Enterprise

Enterprise Provisioning Profile

Distribuição interna em empresas, sem passar pela App Store. Exige conta Apple Developer Enterprise ($299/ano).

Erros comuns e como resolver

"No matching provisioning profiles found"

O Xcode não encontrou um provisioning profile para o Bundle ID do seu app. Solução: ative "Automatically manage signing" nas configurações do target no Xcode, ou crie o profile manualmente no developer.apple.com.

"Provisioning profile expired"

Profiles de desenvolvimento expiram em 1 ano. Profiles de distribuição também. Solução: revogue o profile expirado no developer.apple.com e crie um novo.

"The executable was signed with invalid entitlements"

O profile não inclui as capabilities que o app usa (ex: Push Notifications, iCloud). Solução: habilite as capabilities necessárias no App ID antes de gerar o profile.

Como o Xcode gerencia automaticamente

A forma mais simples de lidar com provisioning profiles é ativar o Automatic Signing no Xcode:

1

Abra o projeto no Xcode

Selecione o target principal do app.

2

Vá em Signing & Capabilities

Marque a opção "Automatically manage signing".

3

Selecione seu Team

O Xcode vai criar e gerenciar os profiles automaticamente.

✓ Automatic Signing funciona bem para a maioria dos casos. Só configure manualmente se tiver necessidades específicas de capabilities ou distribuição.

Não quer lidar com isso tudo?

A AtlasTech configura certificados, provisioning profiles e publica seu app em até 7 dias.

Solicitar publicação