Pular para o conteúdo principal
Proton v5

Apps Mobile

Em Recursos > Apps Mobile ficam os aplicativos testados pelas automações mobile e o histórico de versões de cada um. As versões chegam pela tela, pelo Firebase App Distribution ou pelo CI, e o disparo de uma automação mobile escolhe o app e a versão que vai para o aparelho.

Os apps e as versões​

Cada versão cadastrada é um instalador (APK, AAB ou IPA). As versões com o mesmo pacote (Android) ou bundle id (iOS) formam um app.

No alto, Os números dos apps mostram quantos apps há (Android e iOS), quantas versões estão guardadas, a última versão recebida (e por onde chegou) e quantos apps recebem versões sozinhos, pelo Firebase ou pelo CI.

A lista à esquerda tem a busca Buscar por nome ou pacote e os filtros Todos, Android e iOS. Clicar num app abre a ficha:

  • a versão mais recente, o build e quando chegou, com a origem (Tela, Firebase ou CI);
  • a Identificação: a plataforma, o Package (Android) ou Bundle id (iOS) e, no Android, a Activity de entrada;
  • as versões, da mais recente para a mais antiga, com o build, as notas, a origem e a data. Cada uma pode ser baixada, editada e apagada;
  • os comandos para Receber versões automaticamente (ver abaixo).

Mandar uma versão pela tela​

Nova versão (ou Nova versão deste app, na ficha) recebe o instalador: .apk, .aab ou .ipa, até 500 MB.

  1. Arraste o arquivo ou clique para escolher. O Proton lê do próprio arquivo o pacote, a versão e a activity.
  2. A tela diz para onde a versão vai: um app que já existe (mesmo pacote), que ganha a versão nova como a mais recente, ou um app novo, que nasce com ela. Para um app novo, dê o Nome do app, como ele aparece na lista e no disparo.
  3. Se precisar, ajuste em Corrigir o que foi lido. No AAB, só a plataforma é lida, e os outros campos são preenchidos à mão.
  4. Escreva as Notas desta versão, se quiser, e use Adicionar versão (ou Criar app).

Para um app já instalado no aparelho, sem arquivo, use Cadastrar sem arquivo e preencha a versão, a plataforma, o pacote e, no Android, a activity.

Importar do Firebase​

Com a integração do Firebase cadastrada (ver Integrações), Importar do Firebase traz uma release do App Distribution em três passos:

  1. Selecionar App: os apps do projeto do Firebase.
  2. Selecionar Release: as releases do app, com a versão, o build e as notas. As já importadas aparecem marcadas.
  3. Confirmar: revise o nome, a versão e o pacote, e use Importar.

Receber versões pelo CI​

Receber pelo CI mostra os comandos para o pipeline mandar cada build ao Proton sozinho, com o token de API de uma conta com permissão de cadastrar apps mobile, de preferência uma conta robô:

  • Pelo CI: no fim do build, o pipeline manda o instalador, com um identificador do build (externalId). O mesmo identificador não duplica a versão.
  • Pelo Firebase: depois de distribuir no App Distribution, o CI pede ao Proton para importar a release mais nova.
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 o comando pronto.

Na execução​

No disparo de uma automação mobile, a etapa de aparelho e app escolhe o app e a versão. Ver Executar.

  • Aparelho no runner: escolha uma versão específica ou Sempre a mais recente. Com a mais recente, agendamentos e recorrências testam o último build que chegou. A automação baixa o instalador da execução sozinha.
  • BrowserStack: a versão precisa estar no BrowserStack. Com a integração do BrowserStack, a tabela de versões ganha a coluna BrowserStack: No BrowserStack quando a versão já foi enviada, ou Enviar. A chave Enviar para o BrowserStack também aparece ao mandar uma versão nova e ao importar do Firebase. No disparo, a lista de apps vem do BrowserStack.

Para preparar a máquina e o aparelho, veja Mobile (Android); para o código, a Proton Cloud SDK.

Editar e apagar​

  • Editar esta versão muda o nome, a versão, a plataforma, o pacote, a activity e a observação, e troca ou remove o arquivo. Cada versão tem um instalador só.
  • Apagar esta versão apaga a versão e o instalador. A lixeira da ficha apaga o app e todas as versões. Com o BrowserStack, a confirmação oferece apagar também de lá.

Permissões e celular​

Apps Mobile tem permissões próprias no perfil: ver, criar (nova versão e importar do Firebase), editar e apagar. Quem pode executar no Centro de Automação também vê os apps, para escolher no disparo.

A tela é feita para o computador.