kasy-cli 1.31.6 → 1.31.7

package/templates/firebase/docs/codemagic-release.pt.md

@@ -1,10 +1,14 @@
-# Publicar iOS com Codemagic (sem Mac)
+# Publicar na nuvem com Codemagic (sem Mac)
+
+Publica **iOS** e **Android** pela nuvem do Codemagic. Cada plataforma tem seu
+próprio workflow, então você envia separado ou os dois juntos.
 
 ## Pré-requisitos
 
 - Conta [Codemagic](https://codemagic.io)
 - Repositório Git conectado ao Codemagic
-- Conta Apple Developer + app no App Store Connect
+- iOS: conta Apple Developer + app no App Store Connect
+- Android: app no Google Play Console + keystore de assinatura
 
 ## 1. Adicionar CI ao projeto (se ainda não tiver)
 
@@ -12,32 +16,49 @@
 kasy add ci
 ```
 
-Isso cria `codemagic.yaml` na raiz do projeto.
+Isso cria o `codemagic.yaml` na raiz do projeto (workflows `ios-workflow` e
+`android-workflow`).
+
+## 2. Configurar no painel Codemagic (uma vez)
+
+Estes itens são secretos e só podem ser feitos no painel — uma vez:
 
-## 2. Configurar no painel Codemagic
+1. Abra [codemagic.io/apps](https://codemagic.io/apps) e **conecte o repositório**.
+2. **iOS** — *Integrations → App Store Connect*: conecte a chave da Apple. No
+   `codemagic.yaml`, o nome dela vai em `integrations: app_store_connect:`.
+3. **Android** — *Code signing identities → Android keystores*: suba o keystore
+   com o **Reference name** `keystore_reference` (o mesmo usado no `codemagic.yaml`).
+4. **Android** — suba o JSON da **service account do Google Play** como variável
+   secreta `GOOGLE_PLAY_SERVICE_ACCOUNT_CREDENTIALS` (grupo `google_play`).
 
-1. Abra [codemagic.io/apps](https://codemagic.io/apps) e adicione o repositório.
-2. **Code signing (iOS):** configure certificado e perfil de distribuição App Store.
-3. **Integrations → App Store Connect:** conecte a conta Apple (recomendado).
-4. **Environment variables:** adicione no grupo do app (ex.: `appstore_credentials`):
-   - `BACKEND_URL`, `SENTRY_DSN`, `RC_IOS_API_KEY`, `RC_ANDROID_API_KEY`, `MIXPANEL_TOKEN`
-5. No `codemagic.yaml`, preencha `APP_ID` (ID numérico do app no App Store Connect — aparece na URL do app).
+> As **chaves do app** (RevenueCat, backend, etc.) **não** precisam ser
+> preenchidas no painel: o `kasy codemagic release` as envia automaticamente a
+> partir do seu `.env`. Se preferir disparar pelo painel/push, aí sim cadastre-as
+> nos grupos de variáveis.
 
-## 3. Configurar no terminal
+## 3. Configurar no terminal (uma vez)
 
 ```bash
 kasy codemagic configure
 ```
 
-Informe o **API token** (Settings → Codemagic API), **App ID** e **Workflow ID** (`ios-workflow` por padrão).
+O assistente abre a página do **token da API** (Settings → Codemagic API), valida
+o token e **lista os seus apps** para você escolher — sem digitar IDs. Salva tudo
+em `.kasy/codemagic.env` (não versionado).
 
 ## 4. Disparar build
 
 ```bash
-kasy codemagic release
+kasy codemagic release            # iOS + Android
+kasy codemagic release --ios      # só iOS
+kasy codemagic release --android  # só Android
 ```
 
-O build roda na nuvem e, conforme o `codemagic.yaml`, pode enviar para TestFlight automaticamente.
+O comando lê o seu `.env` e leva as chaves de produção (incluindo a chave de
+produção do RevenueCat, `appl_`/`goog_`) junto no disparo. Um passo do
+`codemagic.yaml` recria o `.env` na nuvem antes de compilar, então o build sai
+com as chaves certas. Conforme o `codemagic.yaml`, o iOS vai para o TestFlight e
+o Android para o track configurado (`internal` por padrão).
 
 ## Status do build
 
@@ -45,6 +66,12 @@ O build roda na nuvem e, conforme o `codemagic.yaml`, pode enviar para TestFligh
 kasy codemagic status <buildId>
 ```
 
+## Posso usar o Mac e o Codemagic ao mesmo tempo?
+
+Pode. São dois caminhos para a mesma loja, não conflitam. O número do build é
+calculado pela própria nuvem (último na loja + 1), então dificilmente colide.
+No dia a dia, escolha um caminho principal.
+
 ## Mac local
 
-Se tiver Mac: [ios-release.md](./ios-release.md) e `kasy ios release`.
+Se tiver Mac: veja [ios-release.md](./ios-release.md) e `kasy ios release`.