Pular para o conteúdo

Para equipe ilarika

Testar os apps no iPhone com uma conta Apple emprestada

  • App Store ConnectUsuários e AcessoIntegraçõesAPI do App Store Connect
  • App Store ConnectAppsNovo app
  • GitHubSettingsSecrets and variablesActions
  • iPhoneTestFlight

Enquanto o iLarika não tem conta própria no Apple Developer Program, dá para testar os três apps no iPhone pelo TestFlight, usando a conta de um colega. Os apps entram na conta dele com identidade de teste:

App Bundle id na conta emprestada Nome no TestFlight
Equipe br.com.ilarika.equipe.teste iLarika Equipe Teste
Entregadores br.com.ilarika.entregadores.teste iLarika Entregadores Teste
iLarika br.com.ilarika.marketplace.teste iLarika Teste

Por que “teste”: na Apple, o bundle id e o nome do app ficam presos à conta onde foram usados primeiro, mesmo que o app seja apagado depois. Com a identidade de teste, br.com.ilarika.equipe e o nome “iLarika Equipe” ficam livres para a conta do iLarika, e não é preciso transferir nada quando ela existir.

No Android o teste é pelo APK: veja Instalar os apps no celular para testar.

Antes de começar

  • O colega precisa ser titular ou Admin de uma conta paga do Apple Developer Program.
  • Um iPhone com iOS 15 ou mais novo, com o app TestFlight instalado.
  • Acesso de administrador ao repositório no GitHub, para cadastrar os secrets.

Passo a passo (o colega faz, uma vez)

  1. Te adicionar na equipe dele: App Store Connect › Usuários e Acesso › +, com o seu e-mail e o papel App Manager. Assim você vira testador interno e instala pelo TestFlight sem revisão da Apple.
  2. Registrar os três bundle ids: developer.apple.com › Certificates, IDs & Profiles › Identifiers › + › App IDs › App. Use os ids da tabela acima, com o tipo Explicit. Não marque nenhuma capability por enquanto.
  3. Criar os três apps: App Store Connect › Apps › + › Novo app, plataforma iOS, com o nome da tabela, idioma Português (Brasil), o bundle id correspondente e qualquer SKU (por exemplo, ilarika-equipe-teste).
  4. Gerar a chave da API: App Store Connect › Usuários e Acesso › Integrações › API do App Store Connect › Chaves da equipe › +, com o acesso Admin. A Apple precisa desse nível para o build criar o certificado e o perfil de distribuição sozinho. Anote o Key ID e o Issuer ID, e baixe o arquivo .p8. Ele só pode ser baixado uma vez.
  5. Pegar o Team ID: developer.apple.com › Account › Membership details › Team ID.

Passo a passo (você faz, uma vez)

No GitHub, abra Settings › Secrets and variables › Actions › New repository secret e crie os quatro secrets:

Secret Valor
APPLE_TEAM_ID o Team ID
ASC_KEY_ID o Key ID
ASC_ISSUER_ID o Issuer ID
ASC_KEY_P8 o conteúdo inteiro do arquivo .p8, incluindo as linhas BEGIN e END

A variável ILARIKA_IDS não precisa existir: sem ela, o build usa a identidade de teste. Ela só passa a ser definitivo quando o iLarika tiver a própria conta (e os secrets forem trocados pelos dessa conta).

Gerar e instalar

  1. O build do iPhone sai quando o commit tem [ios] sozinho numa linha da mensagem (ou [build], para Android e iPhone juntos; [ios:equipe] builda só aquele app), numa tag <app>-vX.Y.Z ou pelo botão Run workflow › plataforma ios. Ele leva uns 15 a 25 minutos.
  2. Depois que fica verde, o App Store Connect processa o build por mais alguns minutos. Chega um e-mail quando ele fica disponível no TestFlight.
  3. Uma vez por app (nos três): App Store Connect › Apps › o app › aba TestFlight › Testes internos › +. Dê um nome ao grupo (por exemplo, Equipe interna), deixe Distribuição automática ligada e adicione você como testador. Sem o grupo, o build fica no App Store Connect e não aparece no celular. Com a distribuição automática, os próximos builds chegam sozinhos.
  4. No iPhone, abra o TestFlight, entre com o mesmo Apple ID que o colega cadastrou e instale.

Repetir um build já enviado (botão Re-run no GitHub) não serve para o iPhone: o número do build é o mesmo, e a Apple recusa o envio repetido. Para mandar de novo, faça um commit novo com [ios].

O que acontece depois

Cada build novo aparece no TestFlight como uma atualização, e o login continua. Builds de TestFlight expiram em 90 dias.

Quando o iLarika tiver conta própria: você cria os apps lá com os ids definitivos, troca os quatro secrets, define a variável ILARIKA_IDS = definitivo, e o colega pode apagar os apps de teste.

Perguntas comuns

Quanto custa em minutos do GitHub? O Mac conta 10 vezes. Um build de iPhone dos três gasta perto de dez vezes o do Android, por isso ele só roda quando alguém pede.

Sem os secrets, o que o build do iPhone faz? Compila para o simulador, para provar que o projeto iOS está são. Nada é enviado.

O Android também precisa da conta do colega? Não para testar: o APK de debug instala direto (ver instalar-para-testar.md). A conta do Google só entra para a trilha interna da Play, na etapa 7.

Se der errado

  • “No profiles for ‘…teste’ were found” ou erro de assinatura: a chave da API não é Admin, ou o bundle id do passo 2 não foi registrado.
  • “No suitable application records were found”: falta criar o app do passo 3 com aquele bundle id exato.
  • “The bundle version must be higher”: o número do build é o número do run do GitHub e só sobe. Se o workflow for renomeado, avise antes.
  • Xcode abaixo do exigido: o próprio build avisa (“Xcode X < 26”). É o runner do GitHub que está velho; atualize exigencias-das-lojas.json só depois de conferir as regras da Apple.

Cada envio ao TestFlight também põe a build no grupo de teste externo “Público (link)” do app (o workflow cria o grupo na primeira vez, com o link público ligado) e manda a build para a revisão de beta da Apple (scripts/apps/testflight-publico.mjs).

As Informações de teste (descrição, e-mail de feedback, contato e conta de demonstração do revisor) também são preenchidas pelo script. As contas de demonstração (equipe, entregador e cliente, na loja de teste Pizza Code) saem de pnpm --filter @ilarika/api apps:contas-de-revisao -- --arquivo /srv/ilarika/shared/revisao-apps.json, rodado uma vez na VPS. Copie o conteúdo desse arquivo para o secret TESTFLIGHT_REVISAO do repositório (o runner ilarika-ci não fica na mesma máquina da API).

Depois que a Apple aprovar a 1ª build, o link (https://testflight.apple.com/join/…) aparece no resumo do job e em App Store Connect › TestFlight › Público (link). Cole em Super Admin › Aplicativos, no campo iOS do app. Quem recebe instala o app TestFlight e toca no link. Builds novas entram no mesmo link.