Apps Móviles

En Recursos > Apps Móviles están las aplicaciones probadas por las automatizaciones móviles y el historial de versiones de cada una. Las versiones llegan por la pantalla, por Firebase App Distribution o por el CI, y al ejecutar una automatización móvil se elige la app y la versión que va al dispositivo.

Las apps y las versiones

Cada versión registrada es un instalador (APK, AAB o IPA). Las versiones con el mismo paquete (Android) o bundle id (iOS) forman una app.

Arriba, Los números de las apps muestran cuántas apps hay (Android e iOS), cuántas versiones están guardadas, la última versión recibida (y por dónde llegó) y cuántas apps reciben versiones solas, por Firebase o por el CI.

La lista de la izquierda tiene la búsqueda Buscar por nombre o paquete y los filtros Todos, Android e iOS. Al hacer clic en una app se abre su ficha:

• la versión más reciente, el build y cuándo llegó, con el origen (Pantalla, Firebase o CI);
• la Identificación: la plataforma, el Package (Android) o Bundle id (iOS) y, en Android, la Activity de entrada;
• las versiones, de la más reciente a la más antigua, con el build, las notas, el origen y la fecha. Cada una se puede descargar, editar y eliminar;
• los comandos para Recibir versiones automáticamente (ver abajo).

Enviar una versión por la pantalla

Nueva versión (o Nueva versión de esta app, en la ficha) recibe el instalador: .apk, .aab o .ipa, hasta 500 MB.

1. Arrastra el archivo o haz clic para elegirlo. Proton lee del propio archivo el paquete, la versión y la activity.
2. La pantalla indica a dónde va la versión: a una app que ya existe (mismo paquete), que recibe la versión nueva como la más reciente, o a una app nueva, que se crea con ella. Para una app nueva, indica el Nombre de la app, tal como aparece en la lista y al ejecutar.
3. Si hace falta, ajusta en Corregir lo que se leyó. En el AAB, solo se lee la plataforma, y los demás campos se completan a mano.
4. Escribe las Notas de esta versión, si quieres, y usa Agregar versión (o Crear app).

Para una app ya instalada en el dispositivo, sin archivo, usa Registrar sin archivo y completa la versión, la plataforma, el paquete y, en Android, la activity.

Importar de Firebase

Con la integración de Firebase registrada (consulta Integraciones), Importar de Firebase trae una release de App Distribution en tres pasos:

1. Seleccionar App: las apps del proyecto de Firebase.
2. Seleccionar Release: las releases de la app, con la versión, el build y las notas. Las ya importadas aparecen marcadas.
3. Confirmar: revisa el nombre, la versión y el paquete, y usa Importar.

Recibir versiones por el CI

Recibir por el CI muestra los comandos para que el pipeline envíe cada build a Proton por su cuenta, con el token de API de una cuenta con permiso para registrar apps móviles, de preferencia una cuenta robot:

• Por el CI: al final del build, el pipeline envía el instalador, con un identificador del build (externalId). El mismo identificador no duplica la versión.
• Por Firebase: después de distribuir en App Distribution, el CI le pide a Proton que importe la release más nueva.

curl -X POST https://app.protoncloud.com.br/api/mobile-app/installer \
  -H "Authorization: Bearer $PROTON_TOKEN" \
  -F file=@app-release.apk \
  -F externalId=build-$CI_PIPELINE_ID

Copiar comando copia el comando listo.

En la ejecución

Al ejecutar una automatización móvil, la etapa de dispositivo y app elige la app y la versión. Consulta Ejecutar.

• Dispositivo en el runner: elige una versión específica o Siempre la más reciente. Con la más reciente, las programaciones y recurrencias prueban el último build que llegó. La automatización descarga sola el instalador de la ejecución.
• BrowserStack: la versión tiene que estar en BrowserStack. Con la integración de BrowserStack, la tabla de versiones gana la columna BrowserStack: En BrowserStack cuando la versión ya se envió, o Enviar. El interruptor Subir a BrowserStack también aparece al enviar una versión nueva y al importar de Firebase. Al ejecutar, la lista de apps viene de BrowserStack.

Para preparar la máquina y el dispositivo, consulta Móvil (Android); para el código, la Proton Cloud SDK.

Editar y eliminar

• Editar esta versión cambia el nombre, la versión, la plataforma, el paquete, la activity y la observación, y reemplaza o quita el archivo. Cada versión tiene un solo instalador.
• Eliminar esta versión elimina la versión y el instalador. La papelera de la ficha elimina la app y todas sus versiones. Con BrowserStack, la confirmación ofrece eliminarla también de allí.

Permisos y celular

Apps Móviles tiene permisos propios en el perfil: ver, crear (nueva versión e importar de Firebase), editar y eliminar. Quien puede ejecutar en el Centro de Automatización también ve las apps, para elegirlas al ejecutar.

La pantalla está pensada para la computadora.