Compilaciones de Android

Crea 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 activa de Google
• 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-native-build-tutorial-app

La primera compilación manual

Antes de que podamos empezar a pensar en la compilación de la aplicación con Capgo, debemos configurarla primero, y hacer una primera compilación de Android de forma manual.

• You will prepare the credentials for the later Capgo build
• Prepararás las credenciales para la compilación posterior con __CAPGO_KEEP_0__

Construyendo la aplicación manualmente con Android Studio

Antes de poder 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 para abrir el proyecto de Android Studio.

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

3. Seleccionar Android App Bundle y hacer clic en Next

Crear un Keystore

Actualmente, te falta el archivo de keystore. Este archivo se utiliza para firmar tu aplicación, lo que permite a Google saber que fue tú quien creó la aplicación. Para generar este archivo, utilizaremos el método de interfaz gráfica proporcionado por Android Studio. También hay una forma de hacer esto mediante la línea de comandos, pero no lo cubriremos en este tutorial.

1. Hacer clic Create new

2. Rellena la ruta del Archivo de Keystore

   Cuidado

   Esto DEBE SER GUARDADO - se utilizará más adelante

3. Establecer la contraseña del Archivo de Keystore

   Nota

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

   Cuidado

   Esta GUARDA ESTO - se utilizará más adelante

4. Rellena el resto del formulario

   1. Mantén el Alias de Clave tal como está (key0)
   2. Rellena los detalles del certificado. He rellenado los detalles con información falsa, pero debes rellenarlos con tus propios detalles.

   

5. Haga clic en OK

Finalizar 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 tenga éxito, debería ver la siguiente pantalla

   1. Este popup indica que la compilación ha tenido éxito.
   2. Haga clic en el locate botón - esto abrirá el explorador de archivos y deberías ver la compilación allí.

4. Asegúrate de que puedas ver la compilación en el explorador de archivos

Crear la aplicación en la Consola de Play Store

1. Ir a Consola de Google Play

2. Seleccionar la cuenta de desarrollador correcta

3. Haga 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 de pago o gratuita

6. Aceptar los términos y condiciones

   Cuidado

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

7. Hacer clic en Create

Creando 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 de Juegos de Google, necesitaré crear un grupo de pruebas internas.

Nota

La prueba interna sigue siendo la forma más rápida de probar tu build distribuido en 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 que hayan optado por participar durante 14 días consecutivos antes de la producción. Ir a Hacer clic en

1. Google Play Console: pruebas internas internal testing pruebas internas Test and release -> Testing -> Internal testing

   

2. Haz clic en Testers

3. Haz clic en Create email list

4. Nombra la lista de correos

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

6. Presiona Enter y haz clic en Save

7. Haz 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 ha creado el grupo de pruebas internas, puede subir la aplicación al grupo de pruebas internas.

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

2. Haga clic en el Releases botón

3. Haga clic en Create new release

4. Haga clic en Upload

5. Seleccione el archivo AAB

   Cuidado

   Asegúrese de seleccionar el archivo AAB que creó manualmente con Android Studio. Si este archivo no utiliza el mismo keystore que el que utilizará para la compilación Capgo, la compilación de Native Build Capgo fallará.

6. Espere a que se suba el archivo AAB

7. Haga clic en Next

8. Corrija los errores

   Personalmente, en esta etapa veo este error

   

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

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

10. Confirmar la publicación

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

12. Obtenga el nombre temporal de la aplicación

Aceptar la invitación al grupo de pruebas internas

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

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

2. Haga clic en Testers

3. Haga clic en Copy link

4. Envíe el enlace a su teléfono, abra en el navegador y haga clic en Accept

5. Confirme que la invitación ha sido aceptada y haga clic en “descárguelo en Play Store”

6. Instale la aplicación

   1. Si había instalado la aplicación antes utilizando Android Studio, haga clic en el uninstall botón
   2. Haga clic en el install botón
   3. Abra la aplicación y confirme que se ha descargado correctamente

   Cuidado

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

Configurando Capgo Compilación Nativa (Android)

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

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

bunx @capgo/cli 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

Si las contraseñas de la clave y el almacén son idénticas, proporcione 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, deberías tener el keystore ya generado. Si no has seguido las instrucciones, por favor sigue las instrucciones para generar el keystore. Si has seguido las instrucciones de compilación manual, deberías tener el keystore ya generado. Si no has seguido las instrucciones, por favor sigue las instrucciones para generar el keystore.Si has seguido las instrucciones de compilación manual, deberías tener el keystore ya generado. Si no has seguido las instrucciones, por favor sigue las instrucciones para generar el keystore.

Cuenta de servicios de Google Play

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

• Tú DEBES ser el dueño de la cuenta de desarrollador. De lo contrario, no podrás configurar la cuenta de servicios.
• Tendrás que crear un nuevo proyecto de Google Cloud (separado de tu cuenta de Google Play)

Comencemos.

1. Ve a Consola de Google Cloud

2. Haz clic en el selector de proyecto

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

   Nota

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

   1. Haz clic en New project
   2. Nombra tu proyecto y haz clic Create
   3. Asegúrate de que estás en el proyecto correcto

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

5. Hagamos clic en Create service account

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

   1. Recomiendo establecer el nombre a Capgo Native Build Service Account
   2. Para el ID de Servicio de Cuenta, recomiendo establecerlo a capgo-native-build-service-acc
   3. En cuanto a la descripción, no tiene que rellenarla, pero recomiendo llenarla 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

   Copia esta dirección de correo electrónico también, la necesitarás 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

    Cuidado

    Haciendo clic en Create se creará una nueva clave y se descargará el archivo JSON en tu máquina local.

    Necesitas guardar el archivo JSON en un lugar seguro. Es SERÁ utilizado más adelante.

11. Descargar el archivo JSON El archivo JSON debería haberse descargado automáticamente. Puedes hacer clic en close para cerrar la ventana.

Otorgar acceso a Play Store API al servicio de cuenta

La cuenta de servicio recién creada no tiene acceso a la tienda Play API aún. Para otorgarle acceso, diríjase a la consola de la tienda Play.

1. Ir a Consola de Google Play
2. Seleccione la cuenta de desarrollador correcta
3. Haga clic en Users and permissions
4. Haga clic en Invite new users
5. Copie la dirección de correo electrónico de la cuenta de servicio
6. Ir a Account permissions y concede los permisos mínimos requeridos:
   • En App permissions, concede acceso a tu aplicación.
   • En Releases, habilita Create, edit, and roll out releases.
   • Si tu flujo de trabajo utiliza Play App Signing, habilita la permiso de firma relacionado.
   • Si tienes dudas, utiliza Admin solo durante la configuración, luego reduce los permisos después.
7. Haz clic en Invite user
8. Confirmar la invitación
9. Confirmar que el usuario ha sido invitado

Guardar las credenciales

Ahora estás listo para guardar las credenciales y ejecutar tu primer build. Puedes guardar las credenciales utilizando el siguiente comando:

bunx @capgo/cli 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

Configuración de CI/CD (GitHub Acciones)

Si ya has completado 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 y cuenta de servicio de Google Play, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

Esta sección solo cubre cómo pasar esos valores como secretos de __CAPGO_KEEP_0__ de Actions y variables de entorno.

# 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

GitHub secrets should be single-line values. tr -d '\n' __CAPGO_KEEP_0__ secrets deben ser valores de una sola línea.

2) Crea secretos de repositorio

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

Nombre de secreto	Valor
CAPGO_TOKEN	Tu Capgo API token
APP_ID	Tu Capgo ID de aplicación (ejemplo: com.example.app)
ANDROID_KEYSTORE_FILE	Contenido de keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias de llave de keystore desde Keystore, contraseña de keystore, contraseña de clave de keystore, alias de keystore
KEYSTORE_KEY_PASSWORD	Contraseña de clave de keystore
KEYSTORE_STORE_PASSWORD	Contraseña de almacenamiento de keystore
PLAY_CONFIG_JSON	Contenido de play_config_base64.txt

Nota

Si las contraseñas de la clave y el almacenamiento son iguales, puede proporcionar solo una de KEYSTORE_KEY_PASSWORD o KEYSTORE_STORE_PASSWORD.

3) Utilice variables de entorno en su GitHub flujo de trabajo de Actions

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 ${{ 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, CI envía credenciales a través de variables de entorno solo. No necesita comprometer archivos de firma ni subirlos como artefactos de flujo de trabajo.

Ejecutando la compilación

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

Ejecutar:

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

Y esto iniciará el proceso de compilación