Assine seu app iOS: certificados, perfis e a solicitação de configuração do AppPresser
Publish and Grow · Docs AppPresser
Assine seu app iOS: certificados, perfis e a solicitação de configuração do AppPresser
The English version of this article has changed since it was translated, so this translation may be out of date.
Para que serve
A Apple só permite que um app seja executado em um iPhone se o app tiver uma “assinatura” digital que comprova quem o criou. Pense nisso como um envelope lacrado com o selo da sua empresa. Sem o selo, os iPhones se recusam a abrir o app.
Para colocar esse selo no seu app, a Apple precisa de alguns arquivos e dados da sua conta do Apple Developer. O AppPresser os verifica antes de compilar seu app iOS. Se faltar algum, você pode pedir à equipe do AppPresser que os configure para você.
Este artigo mostra como:
- Verificar se a sua configuração do iOS está pronta.
- Entender o que significam os resultados.
- Pedir à equipe do AppPresser que configure seus certificados.
- Adicionar ou substituir perfis de provisionamento.
- Verificar novamente e compilar.
Por que sua compilação do iOS ainda não pode começar
Seu app iOS não pode ser compilado até que seus certificados e perfis de provisionamento estejam prontos. Até lá, cada compilação do iOS na página Builds (Development, Ad Hoc e App Store) mostra Not Validated, e a compilação não é executada. Isso é normal em um app novo e não significa que haja algum problema com o app que você projetou.
O Android é diferente. As compilações do Android não precisam de certificados da Apple, então você pode compilar e testar seu app Android enquanto aguarda a configuração do iOS.
Quando você tiver feito os passos abaixo e Validate Setup mostrar que tudo está pronto, suas compilações do iOS poderão começar.
Termos que você verá
Você não precisa memorizá-los. Volte aqui sempre que um termo não estiver claro.
Conta do Apple Developer (Apple Developer Program) Sua associação paga com a Apple que permite colocar apps nos iPhones e na App Store. A Apple cobra US$ 99 por ano (os preços podem variar conforme o país). O login é feito em developer.apple.com.
Conta da Apple (Apple ID) O e-mail e a senha que você usa com a Apple. Sua associação do Apple Developer está vinculada a uma conta da Apple.
Organization ou Individual As duas formas de entrar no Apple Developer Program. Organization significa uma empresa ou outra pessoa jurídica. Individual significa uma pessoa ou um profissional autônomo. Daqui vem o nome do vendedor do seu app na App Store. O formulário pergunta qual você tem.
App Store Connect O site da Apple para gerenciar seus apps na App Store: listagens da loja, versões de teste e envios. O login é feito em appstoreconnect.apple.com com a mesma conta da Apple.
Nome de usuário do App Store Connect O endereço de e-mail da conta da Apple que você usa para fazer login no App Store Connect.
Autenticação de dois fatores Uma etapa extra de segurança. Ao fazer login, a Apple envia um código para o seu celular ou outro dispositivo Apple, e você o digita. A Apple exige isso para as contas de desenvolvedor.
App-specific password Uma senha separada que a Apple cria para você, apenas para um serviço externo. Ela permite que esse serviço faça login na sua conta da Apple sem conhecer sua senha real. Você pode excluí-la a qualquer momento. Ela é criada em account.apple.com (passos abaixo).
ID da equipe da Apple Um código de 10 caracteres (letras e números, por exemplo AB12CD34EF) que a Apple atribui à sua associação de desenvolvedor. É como um número de conta da sua equipe de desenvolvimento.
Nome da equipe da Apple O nome da sua equipe de desenvolvimento como a Apple o mostra. Costuma ser o nome da sua empresa ou o seu próprio nome.
Certificado Uma carteira de identidade digital que comprova que você (ou sua empresa) criou o app. Há dois tipos: – Certificado de desenvolvimento: é usado para versões de teste que rodam nos seus próprios celulares. – Certificado de distribuição: é usado para versões que você compartilha com testadores (Ad Hoc) ou envia à App Store.
Arquivo .p12 (certificado com a chave privada)
Um único arquivo que reúne seu certificado com sua “chave privada” secreta. O certificado sozinho é como a metade pública de uma assinatura, e a chave privada é a metade que só você deve ter. Os apps só podem ser assinados quando as duas metades estão juntas, então o .p12 é o arquivo de que um serviço de compilação realmente precisa. Algumas coisas que vale saber:
- A Apple só permite baixar a parte do certificado (um arquivo .cer). A chave privada é criada no computador que solicitou o certificado, então o .p12 deve ser exportado a partir desse computador (em um Mac, pelo app Acesso às Chaves).
- Ao exportar um .p12, você escolhe uma senha para ele. Quem enviar o arquivo também vai precisar dessa senha, então guarde os dois juntos em um lugar seguro, como um gerenciador de senhas.
- Trate um .p12 como uma chave do seu app. Não o envie por e-mail nem o publique.
- Se o .p12 for perdido, não é possível baixá-lo novamente da Apple. Em vez disso, crie um certificado novo.
- Você verá .p12 em dois lugares: seus certificados de assinatura (desenvolvimento e distribuição) e seu certificado push.
Perfil de provisionamento Uma permissão da Apple. Indica qual app, criado por qual equipe, pode rodar em qual iPhone. Há três tipos: – Perfil Development: para compilações de teste nos seus próprios celulares registrados. – Perfil Ad Hoc: para compartilhar uma versão de teste com uma pequena lista de celulares registrados, sem a App Store. – Perfil da App Store: para a versão que você envia à App Store.
Dispositivos de teste registrados Os iPhones que você informou à Apple (pelo ID do dispositivo) para que possam instalar compilações Development e Ad Hoc.
Certificados push Arquivos que permitem que seu app receba notificações push (as mensagens pop-up que você envia pelo AppPresser). Fazem parte da mesma configuração da Apple, por isso o formulário do AppPresser diz “Signing and Push Certificates.”
Development Build, Ad Hoc Build, App Store Build Os três tipos de compilação do iOS da página Builds. Development é para os seus próprios celulares de teste. Ad Hoc é para um grupo de celulares de teste registrados. App Store é a versão que você envia à Apple para a App Store.
Validate Setup and Re-Validate Botões da página Builds. Eles verificam se tudo de que a Apple precisa está pronto antes que você gaste tempo com uma compilação. Não compilam nada nem alteram nada. Re-Validate é a mesma verificação, executada novamente depois de corrigir algo.
Bitrise O serviço de compilação que o AppPresser usa internamente para transformar seu app em um arquivo para iPhone. Você não precisa da sua própria conta do Bitrise. A solicitação de configuração de US$ 99 o menciona porque a equipe do AppPresser o configura para você.
O que significam as mensagens “Missing …”
Depois de validar, você pode ver linhas como estas. Em palavras simples:
Swipe sideways to see the rest of this table.
| Mensagem na tela | O que significa |
|---|---|
| Missing APP_DEVELOPMENT_TEAM environment variable. | O AppPresser ainda não tem o ID da sua equipe da Apple. |
| Missing APP_STORE_TEAM_NAME environment variable. | O AppPresser ainda não tem o nome da sua equipe da Apple. |
| Missing APP_DEVELOPMENT_PROFILE environment variable. | O AppPresser não tem nenhum perfil de provisionamento Development registrado. |
| Missing APP_ADHOC_PROFILE environment variable. | O AppPresser não tem nenhum perfil de provisionamento Ad Hoc registrado. |
| Missing APP_RELEASE_PROFILE environment variable. | O AppPresser não tem nenhum perfil de provisionamento da App Store registrado. |
| Missing valid development certificate. | Não há nenhum certificado de desenvolvimento válido (ainda não há nenhum, ou ele expirou). |
| Missing valid distribution certificate. | Não há nenhum certificado de distribuição válido (ainda não há nenhum, ou ele expirou). |
| Missing valid development provisioning profile. | O perfil Development está faltando ou expirou. |
| Missing valid Ad Hoc provisioning profile. | O perfil Ad Hoc está faltando ou expirou. |
| Missing valid App Store provisioning profile. | O perfil da App Store está faltando ou expirou. |
| Missing APP_STORE_USERNAME secret for App Store authentication. | O AppPresser não tem o nome de usuário do App Store Connect de que precisa para enviar seu app à Apple. |
| Missing APP_SPECIFIC_PW secret for App Store authentication. | O AppPresser não tem a senha específica de app de que precisa para enviar seu app à Apple. |
Uma “variável de ambiente” (environment variable) ou um “segredo” (secret) é simplesmente uma configuração salva que a compilação usa. Um “segredo” é uma configuração salva que fica oculta, como uma senha.
Antes de começar
Tenha isto pronto:
- Uma associação paga do Apple Developer Program (US$ 99 por ano, como Organization ou Individual). Se você não tiver uma, consulte primeiro o artigo de configuração da Apple sobre a inscrição.
- O e-mail e a senha da sua conta da Apple proprietária da associação.
- Seu celular por perto. A Apple usa a autenticação de dois fatores, então você vai receber códigos de login. A equipe do AppPresser também pode precisar de um código seu mais tarde (consulte o campo Timezone abaixo).
- Acesso de administrador ao App Store Connect, para que você possa adicionar a equipe de suporte do AppPresser como usuário.
- Uma forma de pagamento na sua conta do AppPresser, se você for pedir à equipe do AppPresser que faça a configuração (US$ 99 por solicitação, veja abaixo).
- Seu app aberto no AppPresser. Na barra lateral, em Publishing, clique em Builds.
Passo 1: Verifique sua configuração do iOS (Validate Setup)
- Na página Builds, procure o cartão iOS . Ele indica “Validate your setup before building.”
- Cada tipo de compilação (Development Build, Ad Hoc Build, App Store Build) mostra Not Validated e “Run validation to check setup.”
- Clique em Validate Setup na parte superior do cartão do iOS.
- O botão muda para Validating… e os botões Build ficam cinza por alguns segundos. Aguarde.
Dica: se você clicar em um botão Build antes de validar, o AppPresser executa primeiro a verificação em vez de iniciar uma compilação. Isso é esperado; nada é compilado ainda.
Passo 2: Leia os resultados
Quando a verificação termina:
- Se tudo estiver pronto, cada tipo de compilação está pronto para compilar. (Ainda não vimos esta tela de “tudo certo” em staging.)
- Se algo estiver faltando, o cartão indica "Some checks failed. Review issues before building.", o botão muda para Re-Validatee cada tipo de compilação mostra uma etiqueta vermelha Issues Found com uma lista de problemas.
Em um app totalmente novo sem nada configurado, você verá:
- Development Build: 4 issues. Team ID, perfil Development, certificado de desenvolvimento, perfil de provisionamento de desenvolvimento.
- Ad Hoc Build: 4 issues. Team ID, perfil Ad Hoc, certificado de distribuição, perfil de provisionamento Ad Hoc.
- App Store Build: 7 issues. Team ID, nome da equipe, perfil da App Store, certificado de distribuição, perfil de provisionamento da App Store, nome de usuário da App Store, senha específica de app.
Abaixo de cada lista há links que abrem a solução adequada:
- Certificados de assinatura e push do iOS: pedir à equipe do AppPresser que configure os certificados (passo 3).
- Perfis de provisionamento: enviar perfis Development ou Ad Hoc (passo 4).
- App Store submission credentials (apenas App Store Build): a lista Repair Utilities o descreve como “Update the Apple ID or app-specific password used for automatic App Store submissions.”
As mesmas três ferramentas também aparecem no final da página Builds, em Repair Utilities.
Observe também: depois de uma verificação com falha, a janela iOS App Signing and Push Certificates pode abrir sozinha. É o formulário do passo 3.
Passo 3: Peça à equipe do AppPresser que configure seus certificados
A equipe do AppPresser pode criar seus certificados e configurar o serviço de compilação para você. Você preenche um formulário, dá à equipe acesso ao App Store Connect e aprova uma cobrança de US$ 99.
3a. Abra o formulário
- Em qualquer tipo de compilação do iOS com problemas, clique em Certificados de assinatura e push do iOS. (Ou role até Repair Utilities e clique em Certificados de assinatura e push do iOS.)
- Uma janela chamada iOS App Signing and Push Certificatesabre, com a linha “Request certificate setup or renewal when iOS signing certificates are missing or expired.”
- Uma caixa amarela, Validation needs attention, repete o que está faltando.
- Leia a linha abaixo: “Our team can manage your app’s iOS build and push certificates. After you submit a request, someone from our team will reach out to handle your setup within 1-2 business days.”
3b. Preencha cada campo
Apple account type 1. Escolha Organization ou Individual na lista. 2. Não tem certeza? Clique em How do I check? ao lado do campo. Ele indica: faça login na sua conta do Apple Developer, selecione a equipe do seu app se solicitado, abra Membership detailse consulte Entity Type. Escolha Organization para “Company / Organization”, ou Individual para “Individual / Sole Proprietor”.
Nome de usuário do App Store Connect 1. Digite o endereço de e-mail com que você faz login no App Store Connect.
App Store Connect password 1. Digite a senha dessa conta da Apple. O formulário indica que ela é “Stored temporarily for certificate setup.”
App-specific password 1. Crie uma senha específica de app na Apple (passos abaixo) e cole-a aqui.
Como criar uma senha específica de app (passos da Apple): 1. Acesse account.apple.com e faça login. 2. Em Sign-In and Security, selecione App-Specific Passwords. 3. Selecione Generate an app-specific password, dê a ela um nome que você reconheça (por exemplo, “AppPresser”) e siga os passos. 4. Copie a senha que a Apple mostra e cole-a no formulário.
Vale saber: sua conta da Apple precisa ter a autenticação de dois fatores ativada para criar uma. Se você alterar sua senha principal da Apple, a Apple cancela todas as senhas específicas de app e você terá que criar uma nova.
ID da equipe da Apple 1. Faça login em developer.apple.com e abra sua conta. 2. Clique em Membership details. Se você fizer parte de mais de uma equipe, escolha primeiro a equipe certa. 3. Copie o Team ID (10 letras e números) e cole-o aqui.
Nome da equipe da Apple 1. Na mesma página Membership details, copie o nome da sua equipe exatamente como a Apple o mostra e cole-o aqui.
Timezone 1. Escolha seu fuso horário. O formulário explica: “We may need an SMS verification code. Your timezone helps us arrange a suitable time.” Ou seja, a Apple pode enviar um código por SMS para o seu celular quando a equipe fizer login, e eles vão precisar que você o informe.
3c. Dê ao AppPresser acesso ao App Store Connect
A equipe precisa de acesso próprio à sua conta do App Store Connect para criar os certificados. Dar a eles um usuário próprio é mais seguro do que compartilhar o seu, e você pode excluí-lo depois.
- Faça login em appstoreconnect.apple.com.
- Abra Users and Access. (Você precisa da função Account Holder, Admin ou App Manager para adicionar pessoas.)
- Em People, clique no plus (+) .
- Informe um nome, um sobrenome e o e-mail support@apppresser.com.
- Escolha a função e o acesso de que a equipe do AppPresser precisa, incluindo o acesso a Certificates, Identifiers & Profiles.
- Clique em Nexte depois Invite. Os convites da Apple expiram em 3 dias, então faça isso pouco antes de enviar o formulário.
- De volta ao formulário do AppPresser, marque "I've added support@apppresser.com to App Store Connect with certificate access."
3d. Aprove a cobrança de US$ 99
- Leia a caixa laranja Certificate setup · $99. Ela indica: “Certificate creation or renewal and Bitrise configuration are charged separately for reseller accounts.”
- Marque "I authorize AppPresser to charge my current payment method $99 for this certificate creation/renewal and Bitrise configuration request."
3e. Envie a solicitação
- Clique em Request certificate setup para enviá-la à equipe do AppPresser.
- Ou clique em Save certificate details para manter o que você digitou e enviar mais tarde.
- Aguarde a equipe do AppPresser entrar em contato com você, em até 1 a 2 dias úteis. Tenha o celular por perto caso eles precisem de um código da Apple.
Passo 4: Adicione ou substitua perfis de provisionamento
Use esta opção se você tiver seus próprios arquivos de perfil (terminam em .mobileprovision), se um perfil expirou ou se você adicionou novos celulares de teste.
- Em um tipo de compilação, clique em Perfis de provisionamento. (Ou em Repair Utilities, clique em Perfis de provisionamento.)
- Uma janela abre: Replace iOS Provisioning Profiles, “Replace an expired development or Ad Hoc profile, or add registered test devices.”
- A caixa amarela indica quais perfis estão faltando e diz “After making changes, validate again from the Builds page.”
- Para um perfil Development: em Perfil Development, clique em Choose File, escolha o arquivo e depois clique em Upload Development Profile.
- Para um perfil Ad Hoc: em Perfil Ad Hoc, clique em Choose File, escolha o arquivo e depois clique em Upload Ad Hoc Profile.
- Os botões Upload ficam cinza até você escolher um arquivo.
Passo 5: Após a configuração, verifique novamente e compile
- Quando a equipe do AppPresser disser que sua configuração está pronta (ou depois de enviar os perfis), abra Builds novamente.
- No cartão do iOS, clique em Re-Validate.
- Confira se os problemas desapareceram para o tipo de compilação que você deseja.
- Clique em Build nessa linha (por exemplo, Development Build para o seu próprio celular de teste).
- Acompanhe a compilação em Recent Builds And Logs.
E se algo estiver faltando?
Swipe sideways to see the rest of this table.
| O que você vê | O que significa | O que fazer |
|---|---|---|
| Missing APP_DEVELOPMENT_TEAM | Não há nenhum ID de equipe da Apple registrado | Solicite a configuração de certificados (passo 3) e informe seu Team ID |
| Missing APP_STORE_TEAM_NAME | Não há nenhum nome de equipe da Apple registrado | Solicite a configuração de certificados (passo 3) e informe o nome da sua equipe |
| Missing valid development certificate | Não há nenhum certificado de desenvolvimento válido | Solicite a configuração de certificados (passo 3) |
| Missing valid distribution certificate | Não há nenhum certificado de distribuição válido (necessário para Ad Hoc e App Store) | Solicite a configuração de certificados (passo 3) |
| Missing APP_DEVELOPMENT_PROFILE or valid development provisioning profile | Não há perfil Development, ou ele expirou | Envie um (passo 4), ou inclua-o na sua solicitação de configuração |
| Missing APP_ADHOC_PROFILE or valid Ad Hoc provisioning profile | Não há perfil Ad Hoc, ou ele expirou, ou um celular de teste novo não está incluído | Envie um (passo 4), ou inclua-o na sua solicitação de configuração |
| Missing APP_RELEASE_PROFILE or valid App Store provisioning profile | Não há perfil da App Store | Inclua-o na sua solicitação de configuração (passo 3). Ainda não há um lugar para enviá-lo |
| Missing APP_STORE_USERNAME secret | Não há nome de usuário do App Store Connect para enviar seu app à Apple | Use App Store submission credentials em App Store Build |
| Missing APP_SPECIFIC_PW secret | Não há senha específica de app para enviar seu app à Apple | Crie uma em account.apple.com e depois use App Store submission credentials |
| Uma caixa do formulário mostra a palavra “false” | Um erro conhecido de staging | Apague “false” e digite o valor real |
| Você clicou em Build e aparece Validating… | O AppPresser verifica sua configuração antes de qualquer compilação | Aguarde os resultados e siga este artigo |
| Sua senha específica de app parou de funcionar | Você alterou sua senha principal da Apple, o que cancela as senhas específicas de app | Crie uma senha específica de app nova e atualize-a |
- Campos do formulário pré-preenchidos com “false” (Username, Team ID, Team name, Timezone). AP5-163.
- Ao clicar em Build em uma linha do iOS sem validar, a validação é executada sem aviso. Nota sobre AP5-043.
- As mensagens de validação usam nomes de configurações de desenvolvimento. AP5-164.
- A caixa de US$ 99 diz “reseller accounts”, mas a caixa de seleção aparece para todos. Quem paga? AP5-165.
- Não há lugar para enviar o perfil da App Store. AP5-166.
- Não é possível enviar certificados em lugar nenhum. Os clientes podem configurar os certificados por conta própria, ou apenas pela solicitação de US$ 99?
- O link “Instructions” (adicionar support@apppresser.com) não foi aberto. Qual função do App Store Connect é necessária?
- A janela “App Store submission credentials” não foi aberta.
- O título diz “Push Certificates”, mas o formulário não tem nenhum campo de push. O certificado push (ou a chave push da Apple) é criado como parte da solicitação da equipe? A tela Push Notifications tem suas próprias opções iOS Managed (US$ 99) e Manual (AP5-095). São os mesmos US$ 99 ou uma segunda cobrança?
- O que habilita os botões Save e Request, e o que acontece depois do envio (e-mail, status em Builds, acompanhamento)?
- Ainda não se viu em staging nenhuma validação nem compilação do iOS bem-sucedida. Além disso, os comandos de compilação do iOS no Bitrise ainda não incluem “staging”, então as compilações do iOS em staging podem falhar depois de corrigir a assinatura.
Isto foi útil?
Os resultados atualizam enquanto você digita. Pressione barra para ir à pesquisa.
Não encontrou?
Nossa equipe de suporte pode ajudar com configuração, builds e dúvidas sobre lojas.








