KEPLIN Docs

Obter e instalar a app móvel

Onde se transfere a aplicação Android da plataforma, a diferença entre os dois ficheiros, e como se instala num telemóvel.

As aplicações construídas no Keplin correm no browser de qualquer computador ou telemóvel. Mas há uma segunda forma de as usar num telemóvel Android: a aplicação móvel da plataforma — o KeplinGo —, uma app que se instala uma vez e serve para entrar em qualquer app desta instalação.

Vale a pena quando a aplicação é usada no terreno: um ícone no telemóvel, sem endereço para escrever, com os ecrãs desenhados em componentes nativos e uma cópia local do último ecrã visto para quando a rede falha.

Onde está a app

  1. Abre Definições na barra lateral esquerda, na zona de administração.

O menu Definições na barra lateral, onde vive o painel da aplicação móvel
O menu Definições na barra lateral, onde vive o painel da aplicação móvel

  1. Desce até ao painel Aplicação móvel — "A app Android com que se entra nas apps desta plataforma."

O painel Aplicação móvel nas Definições da plataforma, com os dois ficheiros
O painel Aplicação móvel nas Definições da plataforma, com os dois ficheiros

Nota

O painel só existe nas Definições da plataforma, e essas são de quem a administra. Com perfil de developer, o menu não aparece — pede a um administrador que te passe o ficheiro.

Os dois ficheiros

O painel tem duas linhas, e a escolha entre elas é simples:

Linha Para que serve
APK — instalar no telemóvel O ficheiro que se instala directamente num Android. É este que queres.
AAB — publicar na Play Store O formato de publicação em loja. Só interessa a quem vai distribuir a app pela Play Store da organização.

A linha do APK, com o nome do ficheiro, o tamanho e o botão Transferir
A linha do APK, com o nome do ficheiro, o tamanho e o botão Transferir

Cada linha mostra o nome do ficheiro e o tamanho em MB, e tem um botão Transferir. Enquanto a plataforma confirma o que tem disponível, a linha diz "A verificar…".

Se em vez do tamanho aparecer "Ainda não disponível nesta instalação.", o botão Transferir fica desligado: esta instalação ainda não tem esse ficheiro. Não é um erro de configuração teu — é a plataforma a dizer que não o tem para dar. Fala com quem administra a instalação.

Instalar num Android

  1. Nas Definições, clica em Transferir na linha APK — instalar no telemóvel.
  2. Passa o ficheiro para o telemóvel — por email, por uma pasta partilhada, ou transfere-o directamente do telemóvel abrindo a plataforma nele.
  3. No telemóvel, abre o ficheiro. O Android pede autorização para instalar aplicações desta origem — é o pedido normal para aplicações que não vêm da loja. Autoriza.
  4. Confirma a instalação. Fica um ícone KeplinGo no telemóvel.

Está instalada e vazia: o binário é genérico e não sabe nada sobre a tua instalação nem sobre as tuas apps. Ligá-lo é o assunto da página seguinte.

Dica

Uma instalação, muitas apps. Não há uma app Android por cada aplicação que constróis — o mesmo KeplinGo entra em qualquer uma delas. Quem precisa de um ícone e um nome próprios na Play Store usa o AAB.

Publicar na loja da organização

O ficheiro AAB existe para quem quer distribuir a aplicação pelos canais normais — a Play Store, ou a consola de gestão de dispositivos da empresa. Transfere-o pelo mesmo botão, na segunda linha do painel.

A linha do AAB, o formato para publicar a app na loja da organização
A linha do AAB, o formato para publicar a app na loja da organização

É o caminho a seguir quando os telemóveis são geridos centralmente e não é prático pedir a cada pessoa que autorize a instalação de um ficheiro solto.

Actualizar a app

O KeplinGo actualiza-se substituindo o ficheiro: transfere o APK novo do mesmo painel e instala-o por cima. O endereço e a app configurados no telemóvel mantêm-se.

O que não precisa de actualização é o conteúdo: os ecrãs, os dados e as regras vêm sempre do servidor. Uma mudança que faças no editor aparece na abertura seguinte do ecrã, sem instalar nada.

Nota

A cópia local que a app guarda existe só para o caso de a rede falhar — e nunca se mete no caminho. Com servidor à vista, o que se vê é sempre o que está publicado.

Porque não vejo…?

  • …o painel Aplicação móvel? Estás nas definições de uma app. O painel vive nas Definições da plataforma, no menu da barra lateral.
  • …o botão Transferir activo? A linha diz "Ainda não disponível nesta instalação." — esta instalação não tem esse ficheiro para dar.
  • …uma versão para iPhone? A aplicação móvel da plataforma é Android. Em iPhone, as aplicações construídas usam-se pelo browser, com o endereço publicado.