KEPLIN Docs

Conectar el móvil a una app

Añadir una app a KeplinGo con el QR o a mano, el acceso directo en la pantalla de inicio, varias apps en el mismo móvil, y lo que el móvil añade a las pantallas.

Recién instalado, KeplinGo no sabe a qué instalación conectarse ni qué apps abrir. Cada app se añade una vez, con la dirección de la instalación y el identificador de la app, y a partir de ahí tiene su acceso directo en la pantalla de inicio.

Hay dos formas de añadir una app. El QR es la que se usa cuando se preparan móviles para otras personas; escribir a mano es para cuando no hay QR.

Añadir una app con el QR

El código QR se genera en la plataforma y lleva la dirección de la instalación y la app elegida.

  1. Abre Ajustes en la barra lateral.
  2. Baja al panel Aplicación móvil y busca Conexión por QR.
  3. Abre el selector Elige la app… y elige la app, por ejemplo Gestión de Clientes.

El selector de app de la conexión por QR, con las apps de la instalación
El selector de app de la conexión por QR, con las apps de la instalación

  1. El código aparece debajo, con el enlace escrito al lado y el botón Copiar enlace.

El código QR generado para la app Gestión de Clientes, con el enlace al lado
El código QR generado para la app Gestión de Clientes, con el enlace al lado

  1. En el móvil, con KeplinGo instalado, apunta la cámara al código y abre el enlace que muestra.

KeplinGo se abre en la pantalla Conectar con una app, ya rellenada. El QR ahorra escribir, pero no añade la app por sí solo: la persona todavía toca Validar dirección y lee el nombre de la app antes de entrar.

Nota

El QR lleva la primera dirección publicada de la app, y el móvil abre la versión publicada. En el campo Dirección, la opción Dirección de la plataforma (versión de trabajo) sirve para probar lo que aún no se ha publicado.

Consejo

El QR es la forma práctica de preparar un equipo entero: proyéctalo en una reunión, o déjalo impreso junto a los móviles. Cada persona apunta la cámara y solo tiene que entrar con sus credenciales.

Añadir una app a mano

  1. Abre KeplinGo. Sin ninguna app configurada, aparece la pantalla Conectar con una app. Con apps configuradas, aparece la lista Tus apps: toca Añadir app.
  2. Escribe la Dirección del servidor: la dirección en la que responde la plataforma, como https://tu-app.ejemplo.es. Sin https://, KeplinGo lo añade.
  3. Escribe la App: el identificador corto de la aplicación, como gestao-clientes. Es el mismo que aparece en sus direcciones.
  4. Toca Validar dirección.

KeplinGo pregunta al servidor si la app existe, y responde de una de estas formas:

Respuesta Qué hacer
Vas a conectarte a «Gestión de Clientes», con el icono de la app Es correcto: toca Añadir y abrir.
«Ese servidor no tiene esa app.» La dirección es correcta, el identificador de la app no.
«No se pudo conectar con esa dirección.» La dirección es incorrecta, o el móvil no llega al servidor.
«Esa dirección no es una app de esta plataforma.» La dirección responde, pero no es una instalación de Keplin.
«Escribe una dirección https://.» La dirección no sirve: KeplinGo solo acepta conexiones seguras.

Nota

La validación existe para que se lea el nombre de la app antes de dar credenciales a nadie. Por eso sigue siendo un toque explícito, incluso cuando el QR ya lo ha rellenado todo.

Entrar en la app

Añadir y abrir guarda la app y la abre en su pantalla de entrada: la misma pantalla de entrada que la app muestra en el navegador, con el diseño que le diste. Las credenciales son las de la aplicación, no las de la plataforma: las cuentas gestionadas en los ajustes de la app.

La pantalla de entrada de Gestión de Clientes al ancho de un móvil. Esta pantalla no recibió diseño propio para móvil y se sirve con el diseño web, por eso las etiquetas quedan apretadas. El capítulo del constructor de pantallas muestra cómo dar a cada dispositivo su diseño.
La pantalla de entrada de Gestión de Clientes al ancho de un móvil. Esta pantalla no recibió diseño propio para móvil y se sirve con el diseño web, por eso las etiquetas quedan apretadas. El capítulo del constructor de pantallas muestra cómo dar a cada dispositivo su diseño.

La sesión queda guardada en el móvil y se renueva mientras se trabaja; solo la inactividad prolongada la termina.

Si la app tiene proveedores de autenticación (ver Entrar con proveedores de autenticación), el botón de cada uno abre la página del servicio en una pestaña de Chrome. Cuando la persona termina de entrar, KeplinGo vuelve al frente con la app ya abierta. Active Directory entra por los campos de la pantalla de entrada, como en el navegador.

El acceso directo en la pantalla de inicio

La primera vez que abre una app, KeplinGo pide a Android que ponga un acceso directo a ella en la pantalla de inicio. Android muestra su diálogo de confirmación, con el nombre y el icono de la app.

  • Para poner el acceso directo, toca Añadir a la pantalla de inicio en el diálogo.

El acceso directo abre la app directamente, sin pasar por la lista. Tiene el nombre de la app y el icono elegido en Ajustes de la app ▸ General ▸ Icono en el móvil (consulta Crear y gestionar apps); sin imagen, tiene el icono de la app dibujado sobre el color principal del tema. Cuando el nombre o el icono cambian en la plataforma, el acceso directo se actualiza solo la siguiente vez que se abre la app.

Nota

Android no deja que una app cambie el nombre con el que se instaló. En la lista de apps del móvil, KeplinGo aparece siempre como KeplinGo; el nombre y el icono de cada app están en los accesos directos. El launcher puede añadir al acceso directo una pequeña insignia con el icono de KeplinGo.

Si rechazas el diálogo, pides el acceso directo más tarde: en la lista Tus apps, toca Más opciones (los tres puntos) junto a la app y elige Añadir a la pantalla de inicio.

En Android 7, el acceso directo conserva el nombre y el icono que tenía al crearse: Android solo permite actualizar los accesos directos a partir de Android 8.

Varias apps en el mismo móvil

KeplinGo guarda tantas apps como hagan falta, de la misma instalación o de instalaciones distintas.

  • Cada app se abre en su propia tarea de Android. En las apps recientes, cada una tiene su tarjeta, con su icono, y pasar de una a otra no pierde lo que estaba abierto en ninguna.
  • Cada app tiene su sesión. Entrar o salir de una no toca las demás.
  • El icono de KeplinGo en la lista de apps abre la lista Tus apps. Con una sola app configurada, abre esa app directamente.
  • Al mantener pulsado el icono de KeplinGo, aparecen las apps configuradas y Añadir app.

Dentro de una app, el menú del usuario tiene la entrada Apps de KeplinGo, que abre la lista. Así se añade otra app sin salir de la que está abierta.

Lo que se ve en el móvil

KeplinGo muestra las pantallas que diseñaste para móvil, con la navegación de móvil (menú lateral o barra inferior, según la configuraste) y la pantalla que marcaste como inicial.

La pantalla inicial de la app Gestión de Clientes, al ancho de un móvil
La pantalla inicial de la app Gestión de Clientes, al ancho de un móvil

Es el mismo runtime del navegador: todo lo que funciona en el navegador funciona aquí, incluidos los widgets custom, los modales, los informes y el SDK completo. No hay una segunda versión de la aplicación que mantener.

Lo que añade el móvil:

Pieza En KeplinGo
Ubicación keplin.device.location() lee el GPS del móvil. Android pide el permiso la primera vez. keplin.device.platform vale "android".
Cámara El widget Archivo con la cámara activada abre la cámara del móvil. Los widgets custom que usan la cámara en directo (un lector de códigos, por ejemplo) también la reciben, con el permiso de Android.
Archivos Los informes, las exportaciones y los adjuntos se abren en la app del móvil que lee ese tipo de archivo, como el visor de PDF; si no hay ninguna, se abre el menú de compartir.
Enlaces externos Una dirección de fuera de la app se abre en el navegador del móvil; un número de teléfono o un email se abren en la app correspondiente.
Botón Atrás Vuelve a la pantalla anterior de la app. En la primera pantalla, lleva a la pantalla de inicio y la app queda en las recientes.

Cuando falla la red

Sin red, KeplinGo muestra el aviso Sin conexión, con el botón Reintentar. Las pantallas vienen del servidor, así que no hay copia local que mostrar.

Quitar una app

  1. Abre la lista Tus apps: toca el icono de KeplinGo, o elige Apps de KeplinGo en el menú del usuario de una app.
  2. Toca Más opciones (los tres puntos) junto a la app y elige Quitar.
  3. Confirma con Quitar.

La app sale de KeplinGo y su sesión termina. Android no deja que KeplinGo borre el acceso directo de la pantalla de inicio: el acceso directo queda en gris, con el aviso de que la app se ha quitado, hasta que lo quites a mano.

¿Por qué no funciona…?

  • …el QR? Comprueba que el móvil tiene KeplinGo instalado. Sin la app instalada, el enlace del código no abre nada.
  • …la conexión, con la dirección correcta? El móvil tiene que llegar al servidor. Una dirección interna de la empresa no responde fuera de su red. La dirección tiene que empezar por https://.
  • …mi contraseña de la plataforma? Las credenciales son las de la app, no las de quien construye. Quien construye entra en la plataforma por el navegador.
  • …una pantalla que existe en el navegador? Los permisos son los mismos: una pantalla sin acceso para esa cuenta no aparece. Comprueba su rol en los permisos de la app.
  • …el nombre de la app en la lista de apps del móvil? Android muestra el nombre con el que se instaló la app, KeplinGo. El nombre de cada app está en su acceso directo.
  • …el acceso directo en la pantalla de inicio? Se rechazó el diálogo, o el launcher no acepta accesos directos. Pídelo otra vez en la lista, en Más opciones ▸ Añadir a la pantalla de inicio.