End of Year Sale: 30% off your first year on annual plans. Use code AP5-30-OFF See plans

Crie seus próprios certificados e perfis do iOS (passo a passo)

Publish and Grow · Docs AppPresser

Crie seus próprios certificados e perfis do iOS (passo a passo)

The English version of this article has changed since it was translated, so this translation may be out of date.

Comece aqui: Leia o artigo de introdução, “Get your iOS app signed: certificates, profiles and the AppPresser setup request”. Leia-o primeiro se termos como “certificado” ou “perfil de provisionamento” forem novos para você. Ele também explica a opção de US$ 99 em que a equipe do AppPresser faz tudo isso por você.

Para que serve

Este artigo é o caminho “Faça você mesmo”. Em vez de pagar à equipe do AppPresser para configurar a assinatura do iOS, você cria os arquivos no site do Apple Developer. Na primeira vez leva cerca de 30 minutos.

Ao terminar, você terá:

  • Um App ID para o seu app, com as notificações push ativadas.
  • Uma certificado push para o seu app, salvo como arquivo .p12 com senha.
  • Uma certificado de desenvolvimento, salvo como arquivo .p12 com senha.
  • Uma certificado de distribuição salvo como arquivo .p12 com senha. (Talvez você já tenha um. Consulte “Reutilize seu certificado de distribuição” abaixo.)
  • Um Perfil de provisionamento da App Store (um arquivo .mobileprovision).
  • Uma Perfil de provisionamento Development (um arquivo .mobileprovision).
  • Um Perfil de provisionamento Ad Hoc (um arquivo .mobileprovision). As verificações do AppPresser o consideram opcional, mas sua compilação de teste (Development) precisa dele no momento. Consulte o passo 7b.

Os três certificados explicados de forma simples

Pense em um certificado como uma carteira de identidade digital da sua empresa. A Apple usa três tipos para um app:

Swipe sideways to see the rest of this table.

CertificadoPara que serveQuantos você precisa
DevelopmentAssina as compilações de teste para que possam ser instaladas nos seus próprios iPhones e iPads registrados.Um por pessoa é suficiente. Serve para todos os apps da sua equipe.
DistributionAssina a versão que você envia ao TestFlight (o app de testes beta da Apple) e à App Store.Um para toda a equipe. Reutilize-o em cada app.
Push (Apple Push Notification service)Permite que as notificações push (as mensagens pop-up que você envia pelo AppPresser) cheguem a este app.Um por app. Cada app precisa do seu.

Reutilize seu certificado de distribuição

A Apple só permite que uma equipe tenha um número reduzido de certificados de distribuição ao mesmo tempo (3 no momento em que escrevemos). A boa notícia: um certificado de distribuição pode assinar todos os apps da sua equipe. Então, se sua equipe já tem um e você tem o arquivo .p12 e a senha dele, não crie um novo. Reutilize-o.

Se você criar um certificado de distribuição novo toda vez que compilar um app, vai atingir o limite da Apple e terá que revogar (cancelar) um antigo. Revogar um certificado pode quebrar outros apps que ainda o usam.

No exemplo do Mighty Foxes, não criamos um certificado de distribuição novo. Reutilizamos o que a equipe já tinha.

Um certificado push é por app

Cada certificado push é criado para um bundle ID (por exemplo, com.mightyfoxes.app). Se você tem três apps, precisa de três certificados push. Eles não contam para o limite de distribuição.

O que é um arquivo .p12

Quando você cria um certificado, a Apple lhe dá um arquivo .cer . Isso é só metade do que você precisa. A outra metade é uma chave privada secreta que foi criada no seu próprio computador ao criar a solicitação (a CSR, consulte o passo 2).

Uma .p12 O arquivo

  • reúne as duas metades: Keychain Access Ele é exportado a partir do computador que criou a solicitação. Em um Mac, é exportado pelo app
  • . senha Ao exportá-lo, você escolhe uma
  • Guarde o .p12 e a senha dele juntos no seu gerenciador de senhas. para ele. Quem enviar o .p12 também precisa dessa senha.
  • Você vai reutilizá-los no seu próximo app (distribuição e desenvolvimento) ou ao renová-los.
  • Trate-o como uma chave do seu app. Não o publique nem o envie por e-mail.

Antes de começar

Tenha isto pronto:

  1. Um Mac Se você perder o .p12, a Apple não pode devolvê-lo. Em vez disso, crie um certificado novo. Keychain Access com o app
  2. Uma associação paga do Apple Developer Program. (vem em todos os Macs). Nele você vai criar as solicitações de certificado e os arquivos .p12. Use o mesmo Mac em todos os passos. Certificates, Identifiers & Profiles.
  3. A função adequada na equipe. Faça login em developer.apple.com e abra
  4. Os contratos da Apple aceitos. O Account Holder ou um Admin podem criar todos esses itens. Account Holder Quando a Apple atualiza o Program License Agreement, aparece um aviso na sua conta de desenvolvedor e a Apple não deixa você continuar até que ele seja aceito. Só o
  5. O bundle ID do seu app. pode aceitá-lo. Se você vir esse aviso, peça ao Account Holder que faça login e o aceite primeiro.
  6. Seu .p12 de distribuição existente e a senha deleÉ o nome exclusivo do seu app em formato de domínio invertido, por exemplo com.mightyfoxes.app.
  7. Um gerenciador de senhas, se sua equipe já tem um certificado de distribuição.
  8. Pelo menos um iPhone ou iPad registrado. , para guardar cada senha .p12 à medida que você a cria.

Tanto o perfil Development (passo 7) quanto o perfil Ad Hoc (passo 7b) precisam de um. O passo 7 mostra como registrar um dispositivo se você ainda não tiver nenhum.

Passo 1: Registre seu App ID

  1. Em Certificates, Identifiers & Profiles, clique em Identifiers O App ID informa à Apple sobre o seu app e os recursos (como as notificações push) que ele usa.
  2. no menu à esquerda. plus (+) Clique no botão azul Identifiers.

  1. Escolha App IDsao lado de Continue.

  1. Escolha App e depois clique em Continue.

  1. Em Description(não App Clip) e depois clique em
  2. Em Bundle ID, digite o nome do seu app, por exemplo Mighty Foxes. A Apple não permite aqui caracteres especiais como @, & ou *. Explicit , deixe App ID Prefixselecionado e digite seu bundle ID, por exemplo com.mightyfoxes.app. (Você também verá seu

  1. , que é o seu Team ID. Ele é preenchido automaticamente.) Capabilities Role a lista Push Notifications.

  1. Clique em Continuee marque Confirm your App ID . Revise o resumo na página Register.

  1. e depois clique em

Seu app agora aparece na lista Identifiers.

Passo 2: Crie uma solicitação de certificado (CSR) no seu Mac Certificate Signing Request A Apple precisa de um arquivo

  1. (CSR) para cada certificado novo. Ao criá-lo, a chave privada também é criada no seu Mac, por isso o .p12 deve ser exportado depois a partir do mesmo Mac. Keychain Access No seu Mac, abra o
  2. (em Aplicativos > Utilitários, ou procure-o com o Spotlight). Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.
  3. Na barra de menus, escolha
  4. Informe seu endereço de e-mail e um nome comum (por exemplo, o nome da sua empresa e do app, como “Mighty Foxes Push”). Saved to diskDeixe CA Email Address vazio, escolha Continue.
  5. e clique em

Salve o arquivo .certSigningRequest em um lugar fácil de encontrar, como a sua Mesa.

Crie uma CSR para o certificado push e outra para o certificado de desenvolvimento, e dê a elas nomes que permitam diferenciá-las (nós usamos mf-push.certSigningRequest e mf-development.certSigningRequest).

  1. Em Certificates, Identifiers & Profiles, clique em CertificatesPasso 3: Crie o certificado push para o seu app plus (+).

  1. Em Services, escolha Apple Push Notification service SSL (Sandbox & Production)ao lado de Continuee depois clique no botão azul

  1. Na coluna App ID . (Sandbox & Production serve tanto para compilações de teste quanto para compilações da App Store.) Continue.

  1. Em Upload a Certificate Signing Request, clique em Choose File, escolha seu app (ele mostra seu Team ID seguido do seu bundle ID) e depois clique em Continue.

  1. , escolha sua CSR push e clique em Download your certificateEm Apple Push Services, revise os detalhes: o nome é o seu bundle ID, o tipo é Download, e há uma data de expiração daqui a cerca de 13 meses. Clique em

  1. . Você vai obter um arquivo chamado aps.cer. Apple Push Services.

  1. De volta à lista Certificates, seu novo certificado push aparece com o tipo

Converta-o em um .p12 (passo 8). Guarde o .p12 e a senha dele no seu gerenciador de senhas, identificados com o nome do app e “push”.

Passo 4: Crie um certificado de desenvolvimento e Pule este passo se você já tem um certificado de desenvolvimento que não expirou

  1. Em Certificatestem o .p12 e a senha dele. plus (+) novamente.
  2. Em Software, escolha Apple Developmentao lado de Continue.

  1. Clique em Choose File, clique no botão azul Continue.

  1. , escolha sua CSR push e clique em Download your certificate, escolha sua CSR de desenvolvimento e clique em Developmentao lado de Download, confira se o tipo é

  1. . Você vai obter um arquivo chamado development.cer. Ele expira um ano depois de ser criado. Development.

  1. A lista Certificates agora mostra o novo certificado com o tipo

Converta-o em um .p12 (passo 8) e guarde-o com a senha. Você pode reutilizar este certificado de desenvolvimento para os seus outros apps da mesma equipe.

  1. Em CertificatesPasso 5: Reutilize seu certificado de distribuição (não crie um novo) Distribution , procure linhas com o tipo Expiration e confira a coluna
  2. Se um não expirou e você tem o .p12 e a senha dele, use-o. Você não precisa fazer mais nada neste passo.
  3. Só se você não tiver nenhum certificado de distribuição utilizável: clique em plus (+), escolha Apple Distribution, envie uma CSR nova, baixe distribution.cer e converta-o em um .p12 (passo 8).

Dica: os certificados de distribuição costumam levar o nome da sua equipe, então dois podem parecer exatamente iguais. Diferencie-os pela data de expiração. Anote a data de expiração ao lado do .p12 no seu gerenciador de senhas para poder associá-los depois.

Passo 6: Crie o perfil de provisionamento da App Store

O perfil da App Store permite que seu certificado de distribuição assine este app para o TestFlight e a App Store.

  1. Em Certificates, Identifiers & Profiles, clique em ProfilesPasso 3: Crie o certificado push para o seu app plus (+).
  2. Em Distribution, escolha App Store Connectao lado de Continue.

  1. Na coluna App ID , escolha seu app e depois clique em Continue.

  1. Em Select Certificates, escolha seu certificado de distribuição. Se os nomes parecerem idênticos, escolha aquele cuja data coincide com o .p12 que você está reutilizando. Depois clique em Continue.

  1. Em Provisioning Profile Name, digite um nome que inclua a palavra exata AppStore, escrita como uma só palavra sem espaço, por exemplo “Your App AppStore” (o nosso é “Mighty Foxes AppStore”). Revise o resumo (Type: App Store, seu App ID, 1 certificado selecionado) e depois clique em Generate.

Importante: por enquanto, o AppPresser só reconhece um perfil da App Store se o nome dele contiver AppStore sem espaço. Um nome como “Your App App Store” falha depois na validação com “Missing valid App Store provisioning profile”, mesmo que o perfil esteja correto.

  1. Clique em Download. Você vai obter um arquivo .mobileprovision. A página mostra quando ele expira. Um perfil não pode durar mais que o certificado, então ele expira quando o seu certificado de distribuição expira (2027/10/11 no nosso exemplo).

Já criou seu perfil da App Store com outro nome? Você pode renomeá-lo:

  1. Clique em Profilese depois clique no seu perfil da App Store.
  2. Clique em Edit, altere o Name para que contenha AppStore (por exemplo, “Your App AppStore”), e mantenha o mesmo App ID e certificado de distribuição.
  3. Clique em Savee depois Download o arquivo novo. Renomear cria uma nova versão do perfil com um UUID novo, então o arquivo .mobileprovision antigo deixa de valer. De agora em diante, use o arquivo novo em todos os lugares.

Passo 7: Crie o perfil de provisionamento Development

O perfil Development permite que as compilações de teste sejam executadas em iPhones e iPads específicos. Só funciona em dispositivos registrados na sua conta do Apple Developer.

Primeiro, confira seus dispositivos:

  1. Clique em Devices no menu à esquerda. Confirme que os celulares em que você vai testar estão na lista. Cada dispositivo aparece com o nome e um ID de dispositivo longo.

Vale saber: no início de cada ano de associação, a Apple mostra um aviso amarelo pedindo que você revise sua lista de dispositivos. Nesse momento, você pode excluir os dispositivos antigos.

No devices yet? Register one. Um “dispositivo registrado” é simplesmente um iPhone ou iPad em que você informou à Apple que deseja instalar compilações de teste, por exemplo o seu próprio celular e os da sua equipe. A Apple identifica cada celular pelo UDID, um código longo exclusivo desse dispositivo. Para registrar um:

  1. Encontre o UDID do celular. Conecte o iPhone ao seu Mac com um cabo, abra o Findere clique no iPhone na barra lateral esquerda. Abaixo do nome do celular, clique na linha cinza de detalhes (modelo, armazenamento, número de série) até que ela mostre UDID. Clique com o botão direito e escolha Copy UDID.
  2. Em Certificates, Identifiers & Profiles, clique em Devicese depois o botão azul plus (+).
  3. Escolha a plataforma iOS (abrange iPhone e iPad), digite um Device Name que você reconheça (por exemplo, “My iPhone”) e cole o UDID em Device ID (UDID).
  4. Clique em Continuee depois Register.

Repita para cada celular em que deseja testar.

Depois, crie o perfil:

  1. Clique em Profilese depois o botão azul plus (+).
  2. Em Development, escolha iOS App Developmentao lado de Continue.

  1. Na coluna App ID , escolha seu app e depois clique em Continue.

  1. Em Select Certificates, marque o certificado de desenvolvimento que você criou no passo 4 (ou aquele cujo .p12 você tem) e depois clique em Continue. Os certificados levam o nome da pessoa que os criou, então dois podem parecer iguais. Se não tiver certeza de qual é qual, confira primeiro as datas na lista Certificates.

  1. Em Select Devices, marque Select All para incluir todos os dispositivos registrados (ou marque apenas aqueles em que vai testar). Deixe Include Mac Devices desativado. Depois clique em Continue. No nosso exemplo, Select All incluiu 34 dispositivos.

  1. Digite um nome, por exemplo “Mighty Foxes Development”. Revise o resumo (Type: Development, seu App ID, 1 certificado, o número de dispositivos) e depois clique em Generate.

  1. Clique em Download para salvar o arquivo .mobileprovision. Um perfil Development expira um ano depois de ser criado.

  1. Os dois perfis novos já estão na lista Profiles . (Você vai adicionar um terceiro, o perfil Ad Hoc, no passo 7b.)

Importante: se depois você registrar um dispositivo novo, o perfil Development não o inclui sozinho. Edite o perfil para adicionar o dispositivo, baixe-o novamente e envie o arquivo novo.

Passo 7b: Crie o perfil de provisionamento Ad Hoc (necessário por enquanto para as compilações de teste)

Um perfil Ad Hoc permite que seu certificado de distribuição assine uma versão do seu app que é instalada em iPhones registrados específicos sem passar pela App Store. Ele é gratuito, como qualquer outro perfil.

Importante: crie este perfil agora, mesmo que o AppPresser diga que é opcional. Ao validar sua configuração (passo 13), o AppPresser marca a compilação Ad Hoc como opcional. Mas, por enquanto, a compilação Development (de teste) do iOS também precisa de um perfil Ad Hoc. Sem ele, sua compilação Development falha em poucos minutos e o painel não diz por quê. Criar o perfil Ad Hoc agora evita esse problema.

  1. Em Certificates, Identifiers & Profiles, clique em ProfilesPasso 3: Crie o certificado push para o seu app plus (+).
  2. Em Distribution, escolha Ad Hocao lado de Continue.
  3. Na coluna App ID , escolha seu app (por exemplo, com.mightyfoxes.app) e depois clique em Continue.
  4. Em Select Certificates, escolha o mesmo certificado de distribuição que você usou para o perfil da App Store no passo 6. Se os nomes parecerem idênticos, escolha aquele cuja data de expiração coincide com o .p12 que você está usando. Depois clique em Continue.
  5. Em Select Devices, marque os iPhones e iPads em que deseja instalar compilações de teste, ou marque Select All. Não toque em Include Mac Devices desativado. Depois clique em Continue. Um perfil Ad Hoc precisa de pelo menos um dispositivo registrado. Se a lista estiver vazia, registre primeiro um dispositivo (consulte “Ainda não tem dispositivos? Registre um.” no passo 7) e comece este passo novamente.
  6. Em Provisioning Profile Name, digite um nome que inclua a palavra exata AdHoc, escrita como uma só palavra sem espaço e com A e H maiúsculos, por exemplo “Your App AdHoc” (o nosso seria “Mighty Foxes AdHoc”). Revise o resumo (Type: Ad Hoc, seu App ID, 1 certificado, o número de dispositivos) e depois clique em Generate.

Importante: o AppPresser deduz qual é o tipo de perfil a partir do nomedo perfil, e a correspondência é exata, incluindo maiúsculas. Ele procura as palavras Development, AdHoc, AppStore ou Distribution. Um nome como “Your App Ad Hoc” (com espaço) ou “Your App adhoc” não será reconhecido.

  1. Clique em Download. Você vai obter um arquivo .mobileprovision. Assim como o perfil da App Store, ele expira quando o seu certificado de distribuição expira.

Importante: assim como no perfil Development, se depois você registrar um celular novo, edite o perfil Ad Hoc para adicioná-lo, baixe-o novamente e envie o arquivo novo.

Passo 8: Converta cada .cer em um .p12 (no seu Mac)

Faça isso no mesmo Mac que criou a CSR, porque a chave privada está lá.

  1. Clique duas vezes no arquivo .cer que você baixou (aps.cer ou development.cer). O Acesso às Chaves abre e o adiciona às suas chaves login .
  2. No Acesso às Chaves, clique em My Certificates (em versões anteriores: as chaves login , categoria My Certificates).
  3. Encontre o certificado. Ele tem uma pequena seta ao lado. Clique na seta para confirmar que há uma chave privada abaixo. Se não houver chave, você está em um Mac diferente do que criou a CSR.
  4. Clique com o botão direito no certificado (a linha com a chave abaixo) e escolha Export.
  5. Escolha o formato de arquivo Personal Information Exchange (.p12), dê a ele um nome claro (por exemplo, MightyFoxes-push.p12) e clique em Save.
  6. Digite um senha para o .p12 e confirme-a. Seu Mac também pode pedir a senha de login do Mac para permitir a exportação.
  7. Guarde imediatamente o arquivo .p12 e a senha dele juntos no seu gerenciador de senhas.

Repita para cada certificado (push, desenvolvimento e distribuição, se você criou um novo).

Passo 9: Adicione os arquivos ao AppPresser

Push certificate: Push Notifications > iOS > Manual

  1. No seu app, abra a página Push Notifications , escolha iOSe depois Manual.
  2. Envie seu .p12 push em Push certificate .p12.
  3. Envie um perfil de provisionamento em Provisioning profile .mobileprovision.
  4. Digite a senha do .p12 push em Certificate password.
  5. Clique em Save changes.

Arquivos de assinatura de compilação (arquivos .p12 de desenvolvimento e distribuição, as senhas deles e os perfis)

O painel do AppPresser ainda não tem um lugar para enviar seus certificados de assinatura de compilação. Guarde os arquivos .p12, as senhas deles e os três arquivos .mobileprovision (App Store, Development e Ad Hoc) com segurança no seu gerenciador de senhas até que ele tenha.

Depois de enviá-los, abra Builds e clique em Validate Setup (ou Re-Validate) no cartão do iOS, como descrito no artigo de introdução.

Passo 10: Ative as notificações push

Seu certificado push está pronto, mas as notificações push continuam desativadas para o seu app até que você as ative.

  1. No seu app, abra a página Push Notifications . No canto superior direito, você verá a chave Enable Push Notifications . Ela começa desativada.

  1. Clique na chave para ativá-la. Não há botão de salvar. Ela é salva na hora e mostra uma mensagem verde: Push notifications enabled. O botão Send já está pronto, então você pode enviar mensagens às pessoas que instalarem seu app.

Vale saber: a etiqueta verde Valid do cartão do iOS só significa que seu certificado push está correto. Ela pode indicar Valid mesmo com as notificações push desativadas, então sempre confira se a chave Enable Push Notifications está ativada.

Passo 11: Adicione seus arquivos de assinatura ao seu serviço de compilação (por enquanto, um passo da equipe do AppPresser)

Por enquanto, você não pode enviar seus arquivos de assinatura de compilação (os dois arquivos .p12 e os três perfis de provisionamento) no painel do AppPresser. Até que essa opção seja adicionada, o suporte do AppPresser os adiciona ao serviço que compila seu app para você. Neste passo você não precisa fazer nada, exceto fazer os arquivos chegarem ao suporte com segurança.

O que o suporte precisa de você:

  • Seu App Store perfil de provisionamento (.mobileprovision)
  • Seu Development perfil de provisionamento (.mobileprovision)
  • Seu Ad Hoc perfil de provisionamento (.mobileprovision). Não o omita. Sua compilação de teste (Development) precisa dele no momento (consulte o passo 7b).
  • Seu distribuição arquivo .p12 e a senha dele
  • Seu desenvolvimento arquivo .p12 e a senha dele

Dica: nunca envie a senha de um .p12 no mesmo e-mail que o arquivo .p12. Qualquer pessoa que obtenha os dois pode assinar apps em seu nome. Envie a senha por outro canal seguro (o suporte vai indicar como) e guarde todas as senhas no seu gerenciador de senhas.

Informe ao serviço de compilação sua equipe e quais perfis usar

Enviar os arquivos não basta por si só. O serviço de compilação também precisa saber a qual equipe da Apple seu app pertence e qual perfil usar para cada tipo de compilação. O suporte do AppPresser preenche isso para você. Você só precisa enviar ao suporte seu Team ID (site do Apple Developer, Membership details) e o nome da sua equipe exatamente como a Apple o mostra.

Passo 12: Adicione seu Apple ID e uma senha específica de app

Para enviar seu app pronto à Apple, o AppPresser precisa do seu Apple ID (o e-mail com que você faz login na Apple) e de uma senha específica de app.

O que é uma senha específica de app: é uma senha separada que a Apple cria para você, para que outro serviço possa fazer login em seu nome sem nunca conhecer a senha real do seu Apple ID. Você pode cancelá-la a qualquer momento sem alterar sua senha normal.

Crie uma senha específica de app:

  1. Acesse account.apple.com (opens in a new tab) e faça login com o Apple ID que tem acesso à sua equipe do Apple Developer.
  2. Abra Sign-In and Securitye depois App-Specific Passwords.
  3. Clique no item plus (+), digite um rótulo que você reconheça (por exemplo, “AppPresser”) e clique em Create.
  4. A Apple mostra a senha uma única vez. Ela tem o formato xxxx-xxxx-xxxx-xxxx. Copie-a imediatamente para o seu gerenciador de senhas. Se perdê-la, basta criar uma nova.

Vale saber: uma senha específica de app serve para todos os apps da sua conta da Apple, então você pode reutilizar a mesma para todos os seus apps do AppPresser. Crie senhas separadas apenas se quiser poder cancelar o acesso de um serviço sem afetar os demais.

Adicione-os no AppPresser (grátis):

  1. No seu app, abra a página Builds e role até Repair Utilities.
  2. Em iOS, clique em App Store submission credentials. A janela Apple App Store Credentials abre.
  3. Digite o e-mail do seu Apple ID em Apple ID email e clique em Save Apple ID. Você verá Apple credentials updated successfully.

Importante: use o endereço de e-mail completo da sua conta da Apple. O campo Apple ID deve ser o endereço de e-mail completo com que você faz login na Apple (por exemplo, you@yourcompany.com). Não digite seu nome, o da sua empresa nem o da sua equipe. O AppPresser salva o que você digitar e a validação pode continuar indicando Ready, mas o envio à Apple então falha com Your Apple Account or password was entered incorrectly. 4. Cole sua senha específica de app em App-specific password e clique em Save Password. Este botão não mostra nenhuma mensagem própria, então não se preocupe se parecer que nada acontece. A próxima validação confirma que foi salvo. 5. Feche a janela.

Cada campo tem seu próprio botão de salvar, então certifique-se de clicar nos dois.

Passo 13: Valide sua configuração do iOS

A validação verifica se tudo de que suas compilações do iOS precisam está pronto antes de iniciar uma.

  1. No seu app, abra a página Builds . No cartão iOS , as três compilações (Development, Ad Hoc e App Store) indicam Not Validated. Clique em Validate Setup.

  1. Se ainda faltar algo, uma janela chamada iOS App Signing and Push Certificates pode abrir sozinha. Ela mostra uma caixa amarela Validation needs attention com o que falta, além de um formulário para pedir à equipe do AppPresser que configure seus certificados por você. Você pode fechar esta janela se já enviou seus arquivos ao suporte.

  1. Se você validar antes de o suporte concluir o passo 11 (ou antes de você fazer o passo 12), o cartão do iOS indica Some checks failed. Review issues before building. e cada compilação mostra Issues Found. Isso é normal neste ponto. Aguarde o suporte confirmar que o passo 11 foi feito, conclua o passo 12 e depois clique em Re-Validate.

  1. Depois de concluir os passos 11 e 12, clique em Re-Validate. Isto é o que você deve ver:

Swipe sideways to see the rest of this table.

CompilaçãoResultadoO que significa
DevelopmentReadyVocê pode compilar uma versão de teste e instalá-la nos seus próprios iPhones registrados.
App StoreReadyVocê pode compilar a versão para o TestFlight e a App Store.
Ad HocReady assim que o seu perfil Ad Hoc estiver pronto. Sem ele, Issues Found (2)O AppPresser marca esta compilação como opcional. Ela serve para compartilhar compilações de teste com celulares específicos sem a App Store. Mas não pule o perfil Ad Hoc: por enquanto, sua compilação Development também precisa dele (consulte o passo 7b), mesmo que Development já indique Ready.

Vale saber: Development indica Ready mesmo sem um perfil Ad Hoc, mas a compilação Development continuará falhando sem ele. Se Ad Hoc indicar Issues Found, confirme que você fez o passo 7b e que o suporte tem seu perfil Ad Hoc.

Se App Store indicar “Missing valid App Store provisioning profile”, confira se o nome do seu perfil da App Store contém AppStore sem espaço (consulte o passo 6). Se indicar que faltam seu Apple ID ou sua senha específica de app, volte ao passo 12 e confirme que clicou nos dois botões de salvar.

Vale saber: a validação verifica se há um Apple ID salvo, não se ele é um endereço de e-mail real. Antes de compilar, abra App Store submission credentials novamente e confira se o Apple ID é o e-mail completo da sua conta da Apple (por exemplo, you@yourcompany.com).

Passo 14: Inicie sua compilação da App Store para o TestFlight

A compilação da App Store é a versão do seu app que vai para o TestFlight e, depois, para a App Store. Ela é diferente da compilação Development: uma compilação Development só é instalada nos iPhones que você registrou no passo 7, enquanto a compilação da App Store é a que a Apple aceita para os testadores do TestFlight e para a revisão.

Antes de começar, confirme que o passo 13 mostra App Store Build Ready, e verifique estas três coisas:

  • Seu Apple ID é o seu endereço de e-mail completo. Em Builds > Repair Utilities > App Store submission credentials, o Apple ID deve ser o endereço de e-mail completo da sua conta da Apple (por exemplo, you@yourcompany.com), não um nome nem um nome de equipe. Caso contrário, o envio falha com Your Apple Account or password was entered incorrectly.
  • Seu app existe no App Store Connect. A Apple só aceita uma compilação para um app que ela já conhece. Faça isto uma vez por app:
  • Faça login no App Store Connect (opens in a new tab) e clique em Apps.
  • Clique no item plus (+) ao lado de Apps e escolha New App.
  • Preencha a janela New App : marque iOS em Platforms, digite o Name do seu app (o nome que as pessoas veem na App Store), escolha um Primary Language (por exemplo, English (U.S.)), escolha o Bundle ID do seu app na lista (o mesmo que você registrou no passo 1), digite um SKU (qualquer código curto seu, por exemplo yourapp-ios), e em User Access escolha Full Access.
  • Clique em Create.

Se você pular isto, o envio falha com Could not determine provider public id from Bundle ID.

  • Seus contratos da Apple estão Active. No App Store Connect, abra Business (Agreements, Tax, and Banking). O contrato Free Apps deve mostrar Active, e também o contrato Paid Apps se o seu app ou as compras no app forem pagos. Só o Account Holder pode aceitá-los.
  • No seu app, abra a página Builds . No cartão iOS procure App Store Build e clique uma vez no botão Build . Nenhuma janela de confirmação aparece, então não é preciso clicar de novo.

  1. Role até Recent Builds And Logs. Você verá a mensagem Build started. Follow its progress below. e sua nova compilação no topo da lista, com o fluxo capacitor-ios-app-store e o status In Progress.

  1. A compilação leva vários minutos. Você pode continuar trabalhando; o sino de notificações vai avisar quando terminar. Para consultá-la, clique em Refresh Recent Builds. A página pode mostrar Showing cached results por um momento antes de carregar o status mais recente.
  2. Quando a compilação termina, o status muda:
  3. Completed: sua compilação da App Store foi compilada e enviada à Apple. Quando a Apple termina de processá-la (muitas vezes entre 5 e 30 minutos), ela aparece no App Store Connect em Apps > your app > TestFlight. A Apple envia um e-mail para a conta quando o processamento termina. O passo 15 mostra como instalá-la no seu iPhone.
  4. Failed: a linha mostra Failed e a coluna Download/Install indica No downloads. Nada foi enviado à Apple.

  1. Se a compilação falhou, clique em View Log nessa linha. Uma janela Build Log abre com um resumo de cada passo da compilação e quanto tempo cada um levou. Role pelos passos para encontrar o que falhou. O aviso no topo pode indicar No common issues detected mesmo quando um passo falhou, então sempre confira os próprios passos. Feche a janela com o X no canto superior.

Se não souber o que falhou, envie ao suporte o número da compilação e uma captura do Build Log. Consulte “E se algo der errado?” abaixo para ver os erros comuns de compilação da App Store.

Passo 15: Instale seu app com o TestFlight

O TestFlight é o app gratuito da Apple para testar seu app em um iPhone real antes de ele estar na App Store. Sua compilação da App Store do passo 14 vai para lá. Ela não aparecerá no app TestFlight até que duas condições sejam atendidas: a Apple terminou de processar a compilação e você foi adicionado como testador em um grupo de testes. Este passo faz as duas coisas.

Aguarde a Apple terminar de processar sua compilação

  1. Quando sua compilação da App Store mostra Completed, a Apple a verifica e a processa. Isso costuma levar entre 5 e 30 minutos. Para o Mighty Foxes, levou cerca de 6 minutos.
  2. Quando termina, a conta recebe um e-mail do App Store Connect com um assunto como App Store Connect: Version 1.0.0 (8) for Your App has completed processing. O e-mail indica o número da versão e o número da compilação.

Encontre sua compilação no App Store Connect

  1. Faça login no App Store Connect (opens in a new tab), clique em Appse depois clique no seu app.
  2. Clique no item TestFlight na parte superior.
  3. Em iOS Builds, abra sua versão (por exemplo, Version 1.0.0). O número da sua compilação aparece com o status. Uma compilação processada mostra Ready to Submit e Expires in 90 days. Cada compilação do TestFlight vale por 90 dias; depois você vai precisar de uma compilação mais recente.

Se, em vez disso, o status indicar Missing Compliance , a Apple quer saber qual criptografia seu app usa. Clique em Manage ao lado da compilação e responda às perguntas. A maioria dos apps que usam apenas conexões HTTPS padrão (como um site WordPress comum) atende aos requisitos da isenção. A Apple não fez esta pergunta para o Mighty Foxes.

Crie um grupo de testes interno e adicione-se

Os testadores internos são pessoas da sua equipe do App Store Connect. Eles podem testar imediatamente, sem revisão da Apple.

  1. No menu à esquerda, ao lado de Internal Testing, clique no plus (+).
  2. Dê um nome ao grupo, por exemplo Internal Testers, e deixe Enable automatic distribution ativado. Assim, cada nova compilação que você criar chega automaticamente aos seus testadores e você não precisa adicioná-las uma a uma.
  3. Clique em Create.
  4. Na aba Testers do grupo, clique no plus (+) Clique no botão azul Tester e marque as pessoas que deseja convidar. Nesta lista só aparecem os usuários da sua equipe do App Store Connect (você pode adicionar pessoas em Users and Access). Para o Mighty Foxes, adicionamos o Account Holder.
  5. Clique em Add. O testador agora mostra Invited até aceitar o convite.

  1. Clique na aba Builds do grupo. Sua compilação deve aparecer com o status Ready to Test.

Instale o app no seu iPhone

Cada testador faz isto no próprio iPhone:

  1. Instale o app gratuito TestFlight da Apple a partir da App Store.
  2. Abra o TestFlight e confirme que fez login com a mesma conta da Apple do endereço de e-mail que recebeu o convite.
  3. Abra o e-mail de convite do TestFlight e toque em View in TestFlight (ou, se você recebeu um código, toque em Redeem no app TestFlight e digite-o).
  4. Seu app aparece no TestFlight. Toque em Install. Quando termina, o app aparece na sua tela de início como qualquer outro app.

Seu app no app TestFlight. Toque em Open para iniciá-lo. As compilações do TestFlight expiram em 90 dias.

Seu app funcionando no seu iPhone. Teste todas as telas antes de enviá-lo à App Store.

Confira o ícone do seu app. Se o TestFlight e a sua tela de início mostrarem o ícone de celular do AppPresser em vez do seu, seu app está usando o ícone padrão do AppPresser. Envie seu ícone em Icon & Splash (um .png de 1024 por 1024 pixels, sem transparência) e depois crie uma nova compilação da App Store. O ícone só muda em uma compilação nova.

Os testes com pessoas de fora da sua equipe (testes externos) e o envio do seu app à Apple para a revisão da App Store são passos separados e opcionais. Eles não são abordados neste guia.

E se algo der errado?

Swipe sideways to see the rest of this table.

O que você vêO que significaO que fazer
Um aviso pede que você aceite um contrato atualizadoA Apple alterou o Program License AgreementO Account Holder faz login e o aceita
Você não consegue adicionar um certificado de distribuição novoSua equipe atingiu o limite da AppleReutilize um existente. Revogue apenas um que você tenha certeza de que nenhum app usa
Não há chave privada abaixo do certificado no Acesso às ChavesVocê está em um Mac diferente do que criou a CSRUse o Mac original, ou crie uma CSR nova e um certificado novo
Você perdeu um .p12 ou a senha deleA Apple não pode devolvê-loCrie um certificado novo e depois perfis novos que o usem
Seu app não está na lista de App IDsO App ID ainda não está registrado, ou é um curingaFaça o passo 1 com um bundle ID Explicit
Um celular de teste não consegue instalar o appO celular não está registrado, ou não está no perfil DevelopmentRegistre-o, edite o perfil para incluí-lo, baixe-o e envie-o novamente
Dois certificados parecem iguaisA Apple dá a eles o nome da equipe ou da pessoaDiferencie-os pela data de expiração
Minha compilação Development falhou imediatamente sem mostrar o motivoO mais provável é que não haja nenhum perfil Ad Hoc configurado para o seu app. Por enquanto, a compilação Development precisa de um, mesmo que a validação diga que Ad Hoc é opcional e que Development está Ready. O painel ainda não mostra um registro de compilação quando uma compilação falha, então você não verá esse motivo láCrie o perfil Ad Hoc (passo 7b) e envie-o ao suporte (passo 11). Quando o suporte confirmar que está pronto, inicie a compilação Development novamente
A validação não reconhece seu perfil Ad HocO nome do perfil não contém a palavra exata AdHocRenomeie-o no Apple Developer para que contenha AdHoc sem espaço (por exemplo, “Your App AdHoc”), baixe-o novamente e envie o arquivo novo
A compilação da App Store falha com APP_STORE_PW not setA compilação não encontrou sua senha específica de app com o nome que ela procura, mesmo que a validação indicasse App Store Build Ready. Você só verá isso em View Log, no passo que verifica as variáveisEntre em contato com o suporte informando o número da sua compilação. A equipe do AppPresser vai adicionar sua senha específica de app onde a compilação da App Store a procura, e depois você poderá iniciar a compilação da App Store novamente. Você não precisa de uma senha específica de app nova
A compilação da App Store falha no envio com Your Apple Account or password was entered incorrectly (erro -20101)A Apple não conseguiu fazer login com o Apple ID e a senha específica de app que o AppPresser tem. O mais comum é que o campo Apple ID contenha um nome ou um nome de equipe em vez do e-mail completo da sua conta da AppleEm Builds > Repair Utilities > App Store submission credentials, configure o Apple ID com o e-mail completo da sua conta da Apple (por exemplo, you@yourcompany.com) e clique em Save Apple ID. Cole novamente sua senha específica de app e clique em Save Password. Se continuar falhando, crie uma senha específica de app nova (passo 12). Depois, inicie a compilação da App Store novamente
A compilação da App Store falha no envio com Could not determine provider public id from Bundle IDSeu app ainda não existe no App Store Connect, então a Apple não sabe onde colocar a compilaçãoCrie o app no App Store Connect (Apps, +, New App) com o mesmo bundle ID (consulte o passo 14), confirme que seus contratos Free Apps (e Paid Apps, se necessário) estão Active e inicie a compilação da App Store novamente
A compilação não aparece no app TestFlightA Apple ainda não terminou de processar a compilação, você não foi adicionado como testador em um grupo de testes, não aceitou o convite, ou o app TestFlight está conectado a uma conta da Apple diferente da convidadaAguarde o e-mail “has completed processing” e confira se a compilação mostra Ready to Test no seu grupo (passo 15). Confirme que você consta como testador e toque no link do e-mail de convite. No app TestFlight, confira se fez login com a mesma conta da Apple do e-mail convidado

Isto foi útil?

Não encontrou?

Nossa equipe de suporte pode ajudar com configuração, builds e dúvidas sobre lojas.