Edición de Android

Construye y envía aplicaciones Android a Google Play Store utilizando la infraestructura dedicada de Capgo.

Lo que aprenderás

• Aprenderás a subir tu aplicación a través de Capgo Native build
• Aprenderás a configurar las credenciales para Capgo Native Build

Requisitos previos

• Debes tener una cuenta de desarrollador de Google activa
• Debes tener instalado Android Studio
• Tu aplicación debe poder compilar con éxito con Android Studio

Nota

Usaré la siguiente aplicación para el tutorial: https://github.com/Cap-go/capgo-tutorial-de-compilación-nativa-para-Android

Recomendado: onboarding automatizado

No tienes que hacer nada de esto a mano. El onboarding de Capgo crea y configura tus credenciales de firma de Android (keystore + cuenta de servicio de Google Play) para ti — este es el camino recomendado:

bunx @capgo/cli@latest build init --platform android

La guía manual a continuación solo es para aquellos que prefieren configurar las credenciales ellos mismos, o quieren entender exactamente qué Capgo hace debajo de la cubierta.

La primera construcción manual

Antes de que podamos empezar a pensar en construir la aplicación con Capgo, debemos configurarla primero, y hacer una primera construcción de Android a mano. Hay algunas ventajas en hacer una construcción manual primero:

• Preparará las credenciales para la construcción posterior de Capgo
• Crear un registro en la Consola de Play Store

Construir la aplicación manualmente con Android Studio

Antes de que podamos empezar a construir la aplicación con Capgo, necesitamos construir la aplicación manualmente con Android Studio.

1. Abrir Android Studio

   Ejecutar bunx cap open android Abrir el proyecto de Android Studio.

2. Haga clic en Build -> Generate Signed App Bundles / APKs

3. Seleccione Android App Bundle y haga clic en Next

Crear un archivo de keystore

En este momento, le falta el archivo de keystore. Este archivo se utiliza para firmar su aplicación, lo que le permite a Google saber que es usted quien creó la aplicación.

1. Para generar este archivo, utilizaremos el método de interfaz gráfica proporcionado por Android Studio. Create new

2. Haga clic en

   Cuidado

   Este DEBE SER GUARDADO - se utilizará más tarde

3. Establezca la contraseña del Almacén de Claves

   Nota

   Recomiendo utilizar la misma contraseña para el Almacén de Claves y el Alias de Clave.

   Cuidado

   Esta DEBE SER GUARDADO - se utilizará más tarde

4. Rellene el resto del formulario

   1. Mantenga el alias de la clave tal cual (key0)
   2. Rellene los detalles del certificado. He llenado los detalles con información falsa, pero debe llenarlos con sus propios detalles.

   

5. Haga clic en OK

Finalizando la compilación manual

1. Asegúrese de que todos los detalles del keystore estén llenos correctamente y haga clic en Next

2. Seleccione el release varianta de compilación y haga clic en Create

3. Después de que la compilación es exitosa, debería ver la siguiente pantalla

   1. Este popup indica que la compilación fue exitosa.
   2. Haga clic en el locate botón - esto abrirá el explorador de archivos y debería ver la compilación allí.

4. Asegúrese de que pueda ver la compilación en el explorador de archivos

Crear la aplicación en el Console de Play Store

1. Ir a Console de Google Play

2. Seleccionar la cuenta de desarrollador correcta

3. Hacer clic en Create app

4. Elegir el nombre de la aplicación y el idioma

5. Seleccionar la categoría de la aplicación y si es gratuita o de pago

6. Aceptar los términos y condiciones

   Cuidado

   Asegúrate de leer los términos y condiciones antes de aceptarlos.

7. Haz clic en Create

Crear el grupo de pruebas internas

Ahora que has creado la aplicación, puedes crear un grupo de pruebas internas. Dado que no publicaré la aplicación para todos en la tienda Play, necesitaré crear un grupo de pruebas internas.

Nota

La prueba interna sigue siendo la forma más rápida de probar fumigación de tu construcción distribuida de Play antes de un lanzamiento real.

Si tu cuenta de desarrollador es una cuenta personal creada después del 13 de noviembre de 2023, la prueba interna no reemplaza el requisito de prueba cerrada para acceso a producción. Aún necesitarás una prueba cerrada con al menos 12 participantes optados para 14 días consecutivos antes de la producción. Ir a Hacer clic en

1. Google Play Console de prueba interna internal testing Hacer clic en Test and release -> Testing -> Internal testing

   

2. Hacer clic en Testers

3. Nombre de la lista de correo electrónico Create email list

4. Hacer clic en

5. Agregar las direcciones de correo electrónico de los probadores

6. Pulsar Enter y hacer clic en Save

7. Hacer clic en Create group

8. Asegúrese de que la nueva lista esté seleccionada y haga clic en Save

Subir la aplicación al grupo de pruebas internas

Ahora que has creado el grupo de pruebas internas, puedes subir la aplicación al grupo de pruebas internas.

1. Ir a Test and release -> Testing -> Internal testing

2. Hacer clic en el Releases botón

3. Hacer clic en Create new release

4. Hacer clic en Upload

5. Seleccionar el archivo AAB

   Cuidado

   Asegúrate de seleccionar el archivo AAB que construyó manualmente con Android Studio. Si este archivo no utiliza el mismo keystore que el que utilizará para la Capgo construcción, la Capgo construcción nativa fallará.

6. Espera a que el archivo AAB se suba

7. Haz clic en Next

8. Corrija los errores

   Personalmente, en esta etapa veo este error

   

   Esto es porque no he verificado mi número de teléfono todavía. Lo haré y continuaré con el tutorial.

9. Haz clic en Save and publish Esto publicará la aplicación en el grupo de pruebas internas.

10. Confirmar la publicación

11. Asegúrate de que la aplicación esté publicada

12. Obtén el nombre temporal de la aplicación

Aceptar la invitación al grupo de pruebas internas

Ahora que has subido la aplicación al grupo de pruebas internas, puedes aceptar la invitación al grupo de pruebas internas.

1. Ir a Test and release -> Testing -> Internal testing

2. Haz clic en Testers

3. Haz clic en Copy link

4. Envía el enlace a tu teléfono, abre en el navegador y haz clic en Accept

5. Confirma que la invitación ha sido aceptada y haz clic en ‘descargar en Play Store’

6. Instala la aplicación

   1. Si habías instalado la aplicación antes utilizando Android Studio, haz clic en el uninstall botón
   2. Haz clic en el botón install botón
   3. Abre la aplicación y confirma que se ha descargado correctamente

   Cuidado

   Si no ves la aplicación en Play Store, asegúrate de que hayas seleccionado la cuenta correcta en Play Store.

Configurando Capgo Navegación Nativa (Android)

Ahora, estás listo para empezar la configuración de Capgo Navegación Nativa. ¡Felicidades!

Requisito	Bandera	Descripción	Requerido
Archivo de keystore	--keystore <path>	Ruta a tu .jks/.keystore archivo utilizado para firmar el APK/AAB.	Sí
Alias de keystore	--keystore-alias <alias>	Nombre de alias del clave dentro del keystore.	Sí
Contraseña de clave de keystore	--keystore-key-password <password>	Contraseña para la clave. Si las contraseñas de la clave/almacenamiento coinciden, solo debes proporcionar una.	Mira la nota debajo
Contraseña del almacén de claves	--keystore-store-password <password>	Contraseña para el almacén de claves. Si las contraseñas de la clave/almacenamiento coinciden, solo debes proporcionar una.	Mira la nota debajo
Cuenta de servicios de Google Play	--play-config <path>	Archivo de servicio JSON para subir a Play Store.	Sí

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Nota

If la clave y las contraseñas del almacenamiento son idénticas, proporciona solo una de ellas --keystore-key-password o --keystore-store-password.

Keystore, contraseña del keystore, contraseña de la clave del keystore, alias del keystore

Si has seguido las instrucciones de compilación manual, ya deberías tener el keystore generado. Si no has seguido las instrucciones, por favor sigue las instrucciones para generar el keystore. Cuenta de servicio de Google PlayTítulo de la sección “Cuenta de servicio de Google Play”

La generación de la cuenta de servicio de Google Play es un proceso manual y complejo. Sin embargo, es necesario para subir tu aplicación a Google Play. Ten en cuenta las siguientes cosas:

NECESITAS

• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ ser el dueño de la Cuenta de Desarrollador. De lo contrario, no podrás configurar la cuenta de servicio.
• Necesitarás crear un nuevo proyecto de Google Cloud (separado de tu cuenta de Google Play)

Comencemos.

1. Ir a Consola de Cloud de Google

2. Hacer clic en el selector de proyecto

3. Si ya tienes un proyecto, seleccionarlo. De lo contrario, crear un nuevo proyecto:

   Nota

   Las capturas de pantalla a continuación son ilustrativas - utilice un nombre apropiado para su proyecto.

   1. Haga clic en New project
   2. Nombre de su proyecto y haga clic Create
   3. Asegúrese de que está en el proyecto correcto

4. Hagamos clic en la barra de búsqueda y busquemos por service accounts y haga clic en él

5. Hagamos clic en Create service account

6. Rellene el formulario para la cuenta de servicio y haga clic en Done

   1. Recomiendo que establezca el nombre en Capgo Native Build Service Account
   2. Para el ID de la cuenta de servicio, recomiendo establecerlo en capgo-native-build-service-acc
   3. En cuanto a la descripción, no tiene que llenarlo, pero recomiendo llenarlo con Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Haga clic en la cuenta de servicio recién creada Ahora debería ver la cuenta de servicio recién creada en la lista. Haga clic en ella.

   Nota

   Copie esta dirección de correo electrónico también, la necesitará más tarde.

8. Haga clic en el Keys pestaña

9. Haga clic en Add Key y Create new key

10. Haga clic en JSON y Create

    Advertencia

    Hacer clic en Create creará una nueva clave y descargará el archivo JSON en su máquina local.

    Debes guardar el archivo JSON en un lugar seguro. Será utilizado más tarde. Descargar el archivo JSON El archivo JSON debería haberse descargado automáticamente. Puede hacer clic en

11. para cerrar la ventana. close Clave de descarga del Console de Google

Título de la sección “Otorgar acceso al servicio de cuenta de tienda de Play Store API”

The newly created service account does not yet have access to the Play Store API. To grant it, head to the Play Store Console.

1. Console de Google Play Seleccionar la cuenta de desarrollador correcta
2. Console de Google Play seleccionar cuenta de desarrollador correcta
3. Haz clic en Users and permissions
4. Haz clic en Invite new users
5. Copiar la dirección de correo electrónico de la cuenta de servicio
6. Ir a Account permissions y conceder los permisos mínimos requeridos:
   • En App permissions, conceder acceso a tu aplicación.
   • En Releases, habilitar Create, edit, and roll out releases.
   • If su trabajo de flujo utiliza Play App Signing, habilite la permiso relacionado de firma.
   • If no está seguro, use Admin solamente durante la configuración, luego reduzca las permisos después.
7. Haga clic en Invite user
8. Confirmar la invitación
9. Confirmar que el usuario ha sido invitado

Guardar las credenciales

Ahora está listo para guardar las credenciales y ejecutar su primer build.

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

CI/CD setup (GitHub Actions)

Título de la sección “Configuración de CI/CD (__CAPGO_KEEP_0__ Acciones)” Si ya completó Keystore, contraseña de keystore, contraseña de clave de keystore, alias de keystore y, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

, ya tiene todo lo necesario para CI/CD. Esta sección solo cubre cómo pasar esos valores como secretos y variables de entorno de __CAPGO_KEEP_0__ Acciones.

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

Consejo

Los secretos de GitHub deben ser valores de una sola línea. tr -d '\n' elimina saltos de línea del resultado base64.

2) Crear secretos de repositorio

En GitHub > Repository > Settings > Secrets and variables > Actions, agregar:

Nombre del secreto	Valor
CAPGO_TOKEN	Su Capgo API token
APP_ID	Su Capgo ID de aplicación (por ejemplo: com.example.app)
ANDROID_KEYSTORE_FILE	Contenido de keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias del almacén de claves desde Almacén de claves, contraseña del almacén de claves, contraseña de la clave del almacén de claves, alias del almacén de claves
KEYSTORE_KEY_PASSWORD	Contraseña de la clave del almacén de claves
KEYSTORE_STORE_PASSWORD	Contraseña del almacén de claves
PLAY_CONFIG_JSON	Contenido de play_config_base64.txt

Nota

Si las contraseñas de la clave y del almacén son iguales, puede proporcionar solo una de KEYSTORE_KEY_PASSWORD o KEYSTORE_STORE_PASSWORD.

3) Utiliza variables de entorno en tu GitHub Actions workflow

.github/workflows/android-build.yml

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

Consejo

Con esta configuración, la CI envía credenciales a través de variables de entorno solo. No necesitas comprometer archivos de firma ni subirlos como artefactos de flujo de trabajo.

Ejecutando la compilación

¡Felicidades! Ahora estás listo para ejecutar tu primera compilación.

Ejecutar:

bunx @capgo/cli@latest build request com.example.app --platform android

Y esto iniciará el proceso de compilación 🍾🥂

Enviar la versión de Play para revisión

Por defecto, las compilaciones de lanzamiento de Android suben a Google Play y pueden permanecer inactivas hasta que finalices la versión en el Console de Play. Si su versión de CI debe enviar la versión de Play automáticamente, pasa --submit-to-store-review con una compilación de lanzamiento:

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

Esto requiere la misma configuración de cuenta de servicio de Google Play que el camino de subida normal (PLAY_CONFIG_JSON en CI o credenciales de Android guardadas localmente). --store-release-name se utiliza como nombre de la versión de Play. --store-release-notes es el changelog de Play por defecto, y cada --store-release-notes-locale "locale=notes" La entrada escribe un changelog localizado de Play para ese idioma. Capgo envía la versión de Play como completed; si se habilita la publicación gestionada en el Console de Play, Google puede seguir esperando a su publicación manual después de la aprobación.

Sigue adelante desde Android Builds

Si está utilizando Android Builds para planificar la automatización de CI/CD, conecte con Capgo CI/CD para el flujo de trabajo del producto en Capgo CI/CD, Capgo Native Builds para el flujo de trabajo del producto en Capgo Native Builds, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para el detalle de implementación en Integración CI/CD, y GitHub Acciones de Integración para el detalle de implementación en GitHub Acciones de Integración.