kasy-cli 1.31.5 → 1.31.7

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

@@ -1,10 +1,14 @@
-# Publicar iOS con Codemagic (sin Mac)
+# Publicar en la nube con Codemagic (sin Mac)
+
+Publica **iOS** y **Android** por la nube de Codemagic. Cada plataforma tiene su
+propio workflow, así que puedes enviarlas por separado o las dos juntas.
 
 ## Requisitos
 
 - Cuenta [Codemagic](https://codemagic.io)
 - Repositorio Git conectado a Codemagic
-- Cuenta Apple Developer + app en App Store Connect
+- iOS: cuenta Apple Developer + app en App Store Connect
+- Android: app en Google Play Console + un keystore de firma
 
 ## 1. Agregar CI al proyecto (si falta)
 
@@ -12,32 +16,48 @@
 kasy add ci
 ```
 
-Crea `codemagic.yaml` en la raíz del proyecto.
+Crea `codemagic.yaml` en la raíz del proyecto (workflows `ios-workflow` y
+`android-workflow`).
+
+## 2. Configurar en el panel Codemagic (una vez)
+
+Estos elementos son secretos y solo se hacen en el panel — una vez:
 
-## 2. Configurar en el panel Codemagic
+1. Abre [codemagic.io/apps](https://codemagic.io/apps) y **conecta el repositorio**.
+2. **iOS** — *Integrations → App Store Connect*: conecta la clave de Apple. Su
+   nombre va en `integrations: app_store_connect:` en `codemagic.yaml`.
+3. **Android** — *Code signing identities → Android keystores*: sube el keystore
+   con el **Reference name** `keystore_reference` (igual que en `codemagic.yaml`).
+4. **Android** — sube el JSON de la **service account de Google Play** como
+   variable secreta `GOOGLE_PLAY_SERVICE_ACCOUNT_CREDENTIALS` (grupo `google_play`).
 
-1. Abre [codemagic.io/apps](https://codemagic.io/apps) y agrega el repositorio.
-2. **Code signing (iOS):** certificado y perfil de distribución App Store.
-3. **Integrations → App Store Connect:** vincula la cuenta Apple.
-4. **Environment variables:** en el grupo del app (ej. `appstore_credentials`):
-   - `BACKEND_URL`, `SENTRY_DSN`, `RC_IOS_API_KEY`, `RC_ANDROID_API_KEY`, `MIXPANEL_TOKEN`
-5. En `codemagic.yaml`, completa `APP_ID` (ID numérico del app en App Store Connect).
+> Las **claves del app** (RevenueCat, backend, etc.) **no** hace falta cargarlas
+> en el panel: `kasy codemagic release` las envía automáticamente desde tu `.env`.
+> Si prefieres disparar desde el panel/push, agrégalas a los grupos de variables.
 
-## 3. Configurar en la terminal
+## 3. Configurar en la terminal (una vez)
 
 ```bash
 kasy codemagic configure
 ```
 
-Indica **API token** (Settings → Codemagic API), **App ID** y **Workflow ID** (`ios-workflow` por defecto).
+El asistente abre la página del **API token** (Settings → Codemagic API), valida
+el token y **lista tus apps** para elegir — sin escribir IDs. Guarda todo en
+`.kasy/codemagic.env` (no versionado).
 
 ## 4. Disparar build
 
 ```bash
-kasy codemagic release
+kasy codemagic release            # iOS + Android
+kasy codemagic release --ios      # solo iOS
+kasy codemagic release --android  # solo Android
 ```
 
-El build en la nube puede subir a TestFlight según `codemagic.yaml`.
+El comando lee tu `.env` y lleva las claves de producción (incluida la clave de
+producción de RevenueCat, `appl_`/`goog_`) junto al disparo. Un paso del
+`codemagic.yaml` recrea el `.env` en la nube antes de compilar, así el build sale
+con las claves correctas. Según `codemagic.yaml`, iOS va a TestFlight y Android al
+track configurado (`internal` por defecto).
 
 ## Estado del build
 
@@ -45,6 +65,12 @@ El build en la nube puede subir a TestFlight según `codemagic.yaml`.
 kasy codemagic status <buildId>
 ```
 
+## ¿Puedo usar el Mac y Codemagic a la vez?
+
+Sí. Son dos caminos hacia la misma tienda; no entran en conflicto. El número de
+build lo calcula la nube (último en la tienda + 1), por lo que rara vez choca.
+Para el día a día, elige un camino principal.
+
 ## Mac local
 
 Si tienes Mac: [ios-release.md](./ios-release.md) y `kasy ios release`.

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`.