Deploy do app para TestFlight

Requisitos

Para poder fazer o deploy para o iOS você tem alguns pré-requisitos mais relacionados a hardware e autorização:

Ter acesso à uma conta com permissões para "Carregar compilações" e "Gerenciar compilações do TestFlight"
Estar em um sistema operacional para computadores da Apple (MacOS)
Ter XCode instalado
Ter acesso à internet
Configurar a assinatura do app

Assinatura do app

Abra o XCode no workspace do app --> npx cap open ios na raiz do projeto
No menu lateral da esquerda clique em "App"
Na parte central mais a esquerda selecione "App" em "Targets"
Vá para a aba "Signing and Capabilities"
Na seção de "Signing" no centro do XCode escolha na opção "Team" a assinatura da Vedra
Marque "Automatically manage signing" como verdadeiro

Passos

Ajustar as variáveis de ambiente
Ajustar a versão do app
Compilar o app uma vez
Abrir o XCode
Arquive o app
Faça upload do Archive
Configure os testes

1. Ajustar as variáveis de ambiente

As variáveis de ambiente devem estar ajustadas para compilar corretamente. Nada em específico precisa ser mudado aqui, só garanta que estejam com os valores de produção.

2. Ajustar a versão do app

A versão do app é composta de 2 valores. A versão lógica/de visualização, que geralmente está mais atrelada a features, bugs e breaking changes. E a versão de build que literalmente deve ser diferente toda vez. Para a versão de build só incremente 1. Para a versão lógica refira ao semantic versioning ou aos líderes para decidir se muda, mantém e para qual mudar.

Você deverá mudar a versão no package.json mudando o valor de build (incremental) e de version (semantic versioning). Após isso basta rodar o comando npm run update-version e as versões estarão atualizadas tanto para android quanto para ios.

3. Compilar o app uma vez

Para compilar recomenda-se os seguintes comandos:

npm run check-all para garantir que o app esteja funcionando bem e com tudo instalado corretamente
npm run build para compilar o código web
npm run preview:android para testar antes de mandar para a loja
npx cap sync para sincronizar o código web compilado e o projeto ios (e android)

4. Abrir o XCode

Digite npx cap open ios no terminal e rode esse comando para abrir o XCode direto no Workspace do app.

5. Arquivamento

Na parte superior tem uma barra com "App > <nome de target aqui>". Clique no target para ver todos os targets disponíveis
No popup aparecerá uma lista de targets separados em categorias. Procure pela categoria "Build" e procure por "Any iOS device (arm64)" e clique nesse target.
No menu do topo da tela (aquele bizarro que fica separado da janela), procure pela opção "Product". Clique nela e selecione "Archive".
Espere o "Archive" terminar. Essa é uma boa hora para pegar um cafézinho
Quando terminar você deverá ver uma nova janela mostrando todos os arquivamentos feito no seu dispositivo

6. Upload

Selecione a versão mais recente do "Archive", que você acabou de fazer
Nessa nova janela haverá um botão "Distribute App". Clique nele.
Selecione a opção "App Store Connect" e prossiga
Selecione a opção "Upload" e prossiga
Confira a versão e faça upload dela clicando em "Upload"
Se a internet for lenta, vá tomar um cafézinho até acabar o upload
Pronto, clique em "Done" e a versão terá feito o upload

7. Configurações dos testes

Acesse a App Store Connect
Vá em "Meus Apps"
Selecione o app
Vá para a aba "TestFlight"
Procure pelo nome de versão que você acabou de dar upload
Abra ela e veja que está processando sua nova compilação. Esse processo pode demorar bastante coisa, agora é uma boa hora de compilar o android e fazer o deploy. Para ver uma atualização sobre esse status, você terá que recarregar a página
Depois de processado você deverá ver que talvez o app precise de alguma ação para poder ser lançado para testes. Clique em "Gerenciar" e complete os passos pedidos se informando com quem souber a resposta (provavelmente o Tech Lead de Mobile saberá te orientar)
Quando estiver marcado com Pronta para envio você pode adicionar grupos para testar clicando no número do build da versão, por padrão ele vai colocar os da última versão
Instrua as pessoas como instalar usando esse tutorial aqui.