Construcciones de Android

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

¿Qué 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
• Tuya aplicación debe poder compilar con éxito con Android Studio

Notas

Usaré la siguiente aplicación para el tutorial: https://github.com/Cap-go/capgo-native-build-tutorial-app

Recomendado: onboarding automatizado

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

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

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

La primera construcción manual

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

• Preparará las credenciales para la posterior construcción con 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 para 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 Keystore

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

1. Haga clic en Create new

2. Rellene el camino del Almacén de Claves

   Cuidado

   Esto 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 usted 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 variant 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. Esta ventana emergente indica que la compilación tuvo éxito.
   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 la Consola de Google Play

1. Ir a Consola 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 la aplicación es de pago o gratuita

6. Aceptar los términos y condiciones

   Cuidado

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

7. Haga clic en Create

Crear el grupo de pruebas internas

Una vez que haya creado la aplicación, puede 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 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 el acceso a producción. Todavía 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. Prueba interna de Google Play Console internal testing Hacer clic en Test and release -> Testing -> Internal testing

   

2. Hacer clic en Testers

3. Ir a Create email list

4. Nombra la lista de correos

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

6. Presione Enter y haga clic en Save

7. Haga 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. Vaya a Test and release -> Testing -> Internal testing

2. Haga clic en el Releases botón de lanzamientos de la Consola de Google Play

3. botón de crear nuevo lanzamiento de la Consola de Google Play Create new release

4. botón de subir a la Consola de Google Play Upload

5. Sección titulada “Subir la aplicación al grupo de pruebas internas”

   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ás para la Capgo construcción, la Capgo construcción nativa fallará.

6. Espera a que el archivo AAB se suba

7. Haga 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. Haga 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. Haga clic en el install botón
   3. Abra la aplicación y confirme que se ha descargado correctamente

   Cuidado

   Si no ve la aplicación en Play Store, asegúrese de que ha seleccionado la cuenta correcta en Play Store.

Configurando Capgo compilación nativa (Android)

Now, you are ready to start the setup of Capgo Native Build. ¡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 key dentro del keystore.	Sí
Contraseña de la clave del almacén	--keystore-key-password <password>	Contraseña para la clave. Si las contraseñas de la clave y el almacén coinciden, solo necesita proporcionar una.	Mire 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 y el almacén coinciden, solo necesita proporcionar una.	Mire la nota debajo
Cuenta de servicio 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

Si las contraseñas de la clave y el almacenamiento 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. Cuenta de servicio de Google PlaySección titulada “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:

You should have the keystore already generated if you have followed the manual build instructions. If you have not followed the instructions, please follow them to generate the keystore.

• Generating the Google Play service account is a manual and complex process. Yet, it is required to upload your app to Google Play. Please keep in mind the following things: NECESITA ser el dueño del Cuenta de Desarrollador. De lo contrario, no podrá configurar la cuenta de servicio.
• Tendrá que crear un nuevo proyecto de Google Cloud (separado de su cuenta de Google Play)

Comencemos.

1. Vaya a Consola de Cloud de Google

2. Haga clic en el selector de proyecto

3. Si ya tiene un proyecto, selecciónelo. De lo contrario, cree 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. Nombra su proyecto y haga clic Create
   3. Asegúrese de que está en el proyecto correcto

4. Vamos a hacer clic en la barra de búsqueda y buscar por service accounts y haga clic en ella

5. Vamos a hacer 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 la cuenta de servicio, recomiendo establecerlo a capgo-native-build-service-acc
   3. En cuanto a la descripción, no tiene que rellenarlo, 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, lo 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

    Cuidado

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

    Debes guardar el archivo JSON en un lugar seguro. Se utilizará más tarde. SE USARÁ Se utilizará más tarde.

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 al servicio de cuenta de tienda de Play Store API

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

1. Ir a Consola de Google Play
2. Seleccionar 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. Vaya a Account permissions y conceda los permisos mínimos necesarios:
   • En App permissionsy conceda acceso a su aplicación.
   • En Releaseshabilitar Create, edit, and roll out releases.
   • Si su flujo de trabajo utiliza Play App Signing, habilite la correspondiente permiso de firma.
   • Si no está seguro, utilice Admin solamente durante la configuración, luego reduzca las permisos posteriormente.
7. Haga clic en Invite user
8. Confirmar la invitación
9. Confirmar que el usuario ha sido invitado en Google Play Console

Guardar las credenciales

Ahora está listo para guardar las credenciales y ejecutar su primer build. Puede guardar las credenciales utilizando el siguiente comando:

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

Configuración CI/CD (GitHub Acciones)

Si ya completó Keystore, contraseña de keystore, contraseña de clave de keystore, alias de keystore y cuenta de servicio de Google Play, ya tiene todo lo necesario para la configuración CI/CD. Esta sección solo cubre cómo pasar esos valores como secretos y variables de entorno de GitHub Acciones. 1) Convirta los archivos de credenciales a una cadena base64 de una sola línea

1) Convirta los archivos de credenciales a una cadena base64 de una sola línea

# 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 Los secretos deben ser valores de una sola línea. tr -d '\n' elimina saltos de línea del resultado de base64.

2) Crea secretos de repositorio

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

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 ellas KEYSTORE_KEY_PASSWORD o KEYSTORE_STORE_PASSWORD.

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

.github/trabajos/flujo-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 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@latest build request com.example.app --platform android

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

Sigue adelante desde Android Builds

Si estás utilizando Edición de Android para planificar la automatización de CI/CD, conecta con Capgo CI/CD para el flujo de trabajo del producto en Capgo CI/CD, Capgo Edición nativa para el flujo de trabajo del producto en Capgo Edición nativa, Integraciones Capgo para el flujo de trabajo del producto en Integraciones Capgo Integración CI/CD para el detalle de implementación en Integración CI/CD Integración de Acciones GitHub para el detalle de implementación en Integración de Acciones GitHub