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)
- 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.
- 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.
- 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). - 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. - 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
- 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.Zou pelo botão Run workflow › plataforma ios. Ele leva uns 15 a 25 minutos. - 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.
- 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. - 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.jsonsó depois de conferir as regras da Apple.
Link público (sem cadastrar e-mail)
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.
