Collegare il telefono a un'app
Aggiungere un'app a KeplinGo con il QR o a mano, la scorciatoia nella schermata Home, più app sullo stesso telefono, e cosa aggiunge il telefono alle schermate.
Appena installato, KeplinGo non sa a quale installazione collegarsi né quali app aprire. Ogni app si aggiunge una volta, con l'indirizzo dell'installazione e l'identificatore dell'app, e da quel momento ha la sua scorciatoia nella schermata Home.
Ci sono due modi di aggiungere un'app. Il QR è quello da usare quando si preparano telefoni per altre persone; la scrittura a mano serve quando non c'è un QR.
Aggiungere un'app con il QR
Il codice QR si genera nella piattaforma e contiene l'indirizzo dell'installazione e l'app scelta.
- Apri Impostazioni nella barra laterale.
- Scendi fino al pannello App mobile e trova Connessione tramite QR.
- Apri il selettore Scegli l'app… e scegli l'app, per esempio Gestione Clienti.

- Il codice compare sotto, con il collegamento scritto di fianco e il pulsante Copia collegamento.

- Sul telefono, con KeplinGo installato, inquadra il codice con la fotocamera e apri il collegamento che mostra.
KeplinGo si apre sulla schermata Collegati a un'app, già compilata. Il QR risparmia la scrittura, ma non aggiunge l'app da solo: la persona tocca ancora Valida indirizzo e legge il nome dell'app prima di entrare.
Nota
Il QR contiene il primo indirizzo pubblicato dell'app, e il telefono apre la versione pubblicata. Nel campo Indirizzo, l'opzione Indirizzo della piattaforma (versione di lavoro) serve per provare ciò che non è ancora pubblicato.
Suggerimento
Il QR è il modo pratico di preparare un'intera squadra: proiettalo in una riunione, o stampalo accanto ai telefoni. Ogni persona inquadra il codice e deve solo entrare con le sue credenziali.
Aggiungere un'app a mano
- Apri KeplinGo. Senza nessuna app configurata, compare la schermata Collegati a un'app. Con app configurate, compare l'elenco Le tue app: tocca Aggiungi app.
- Scrivi l'Indirizzo del server: l'indirizzo a cui risponde la
piattaforma, come
https://la-tua-app.esempio.it. Senzahttps://, KeplinGo lo aggiunge. - Scrivi l'App: l'identificatore breve dell'applicazione, come
gestao-clientes. È lo stesso che compare nei suoi indirizzi. - Tocca Valida indirizzo.
KeplinGo chiede al server se l'app esiste, e risponde in uno di questi modi:
| Risposta | Cosa fare |
|---|---|
| Ti collegherai a "Gestione Clienti", con l'icona dell'app | È corretto: tocca Aggiungi e apri. |
| «Quel server non ha quell'app.» | L'indirizzo è corretto, l'identificatore dell'app no. |
| «Non è stato possibile collegarsi a quell'indirizzo.» | L'indirizzo è sbagliato, o il telefono non raggiunge il server. |
| «Quell'indirizzo non è un'app di questa piattaforma.» | L'indirizzo risponde, ma non è un'installazione Keplin. |
| «Scrivi un indirizzo https://.» | L'indirizzo non va bene: KeplinGo accetta solo connessioni sicure. |
Nota
La convalida esiste perché si legga il nome dell'app prima di dare credenziali a qualcuno. Per questo resta un tocco esplicito, anche quando il QR ha già compilato tutto.
Entrare nell'app
Aggiungi e apri salva l'app e la apre sulla sua schermata di accesso: la stessa schermata di accesso che l'app mostra nel browser, con il design che le hai dato. Le credenziali sono quelle dell'applicazione, non quelle della piattaforma: gli account gestiti nelle impostazioni dell'app.

La sessione resta salvata sul telefono e si rinnova mentre si lavora; solo una lunga inattività la fa terminare.
Se l'app ha fornitori di autenticazione (vedi Accedere con i fornitori di autenticazione), il pulsante di ognuno apre la pagina del servizio in una scheda di Chrome. Quando la persona ha finito di accedere, KeplinGo torna in primo piano con l'app già aperta. Active Directory accede dai campi della schermata di accesso, come nel browser.
La scorciatoia nella schermata Home
La prima volta che apre un'app, KeplinGo chiede ad Android di mettere una scorciatoia nella schermata Home. Android mostra la sua finestra di conferma, con il nome e l'icona dell'app.
- Per aggiungere la scorciatoia, tocca Aggiungi alla schermata Home nella finestra.
La scorciatoia apre l'app direttamente, senza passare dall'elenco. Ha il nome dell'app e l'icona scelta in Impostazioni dell'app ▸ Generale ▸ Icona sul telefono (vedi Creare e gestire le app); senza immagine, ha l'icona dell'app disegnata sul colore principale del tema. Quando il nome o l'icona cambiano nella piattaforma, la scorciatoia si aggiorna da sola alla successiva apertura dell'app.
Nota
Android non permette a un'app di cambiare il nome con cui è stata installata. Nell'elenco delle app del telefono, KeplinGo compare sempre come KeplinGo; il nome e l'icona di ogni app sono sulle scorciatoie. Il launcher può aggiungere alla scorciatoia un piccolo badge con l'icona di KeplinGo.
Se rifiuti la finestra, puoi chiedere la scorciatoia più tardi: nell'elenco Le tue app, tocca Altre opzioni (i tre puntini) accanto all'app e scegli Aggiungi alla schermata Home.
Su Android 7, la scorciatoia mantiene il nome e l'icona che aveva quando è stata creata: Android permette di aggiornare le scorciatoie solo da Android 8 in poi.
Più app sullo stesso telefono
KeplinGo tiene tutte le app che servono, della stessa installazione o di installazioni diverse.
- Ogni app si apre nella sua attività Android. Nelle app recenti, ognuna ha la sua scheda, con la sua icona, e passare dall'una all'altra non fa perdere niente di ciò che era aperto.
- Ogni app ha la sua sessione. Entrare o uscire da una non tocca le altre.
- L'icona di KeplinGo nell'elenco delle app apre l'elenco Le tue app. Con una sola app configurata, apre direttamente quell'app.
- Tenendo premuta l'icona di KeplinGo, compaiono le app configurate e Aggiungi app.
Dentro un'app, il menu dell'utente ha la voce App di KeplinGo, che apre l'elenco. È così che si aggiunge un'altra app senza uscire da quella aperta.
Cosa si vede sul telefono
KeplinGo mostra le schermate che hai disegnato per il telefono, con la navigazione del telefono (menu laterale o barra inferiore, come l'hai configurata) e la schermata che hai segnato come iniziale.

È lo stesso runtime del browser: tutto quello che funziona nel browser funziona qui, compresi i widget custom, le finestre modali, i report e l'SDK completo. Non c'è una seconda versione dell'applicazione da mantenere.
Cosa aggiunge il telefono:
| Elemento | In KeplinGo |
|---|---|
| Posizione | keplin.device.location() legge il GPS del telefono. Android chiede l'autorizzazione la prima volta. keplin.device.platform vale "android". |
| Fotocamera | Il widget File con la fotocamera attivata apre la fotocamera del telefono. I widget custom che usano la fotocamera in diretta (un lettore di codici, per esempio) la ricevono anche loro, con l'autorizzazione di Android. |
| File | I report, le esportazioni e gli allegati si aprono nell'app del telefono che legge quel tipo di file, come il lettore di PDF; se non ce n'è nessuna, si apre la condivisione. |
| Link esterni | Un indirizzo fuori dall'app si apre nel browser del telefono; un numero di telefono o un email si aprono nell'app corrispondente. |
| Pulsante Indietro | Torna alla schermata precedente dell'app. Sulla prima schermata, porta alla schermata Home e l'app resta nelle recenti. |
Quando la rete non c'è
Senza rete, KeplinGo mostra l'avviso Nessuna connessione, con il pulsante Riprova. Le schermate arrivano dal server, quindi non c'è una copia locale da mostrare.
Rimuovere un'app
- Apri l'elenco Le tue app: tocca l'icona di KeplinGo, o scegli App di KeplinGo nel menu dell'utente di un'app.
- Tocca Altre opzioni (i tre puntini) accanto all'app e scegli Rimuovi.
- Conferma con Rimuovi.
L'app esce da KeplinGo e la sua sessione termina. Android non permette a KeplinGo di eliminare la scorciatoia dalla schermata Home: la scorciatoia diventa grigia, con l'avviso che l'app è stata rimossa, finché non la togli a mano.
Perché non funziona…?
- …il QR? Verifica che sul telefono sia installato KeplinGo. Senza l'app installata, il collegamento del codice non apre niente.
- …la connessione, con l'indirizzo giusto? Il telefono deve
raggiungere il server. Un indirizzo interno dell'azienda non risponde
fuori dalla sua rete. L'indirizzo deve iniziare con
https://. - …la mia password della piattaforma? Le credenziali sono quelle dell'app, non di chi costruisce. Chi costruisce entra nella piattaforma dal browser.
- …una schermata che esiste nel browser? I permessi sono gli stessi: una schermata senza accesso per quell'account non compare. Verifica il suo ruolo nei permessi dell'app.
- …il nome dell'app nell'elenco delle app del telefono? Android mostra il nome con cui l'app è stata installata, KeplinGo. Il nome di ogni app è sulla sua scorciatoia.
- …la scorciatoia nella schermata Home? La finestra è stata rifiutata, o il launcher non accetta scorciatoie. Chiedila di nuovo nell'elenco, in Altre opzioni ▸ Aggiungi alla schermata Home.