Generatore di app mobile personalizzata

Ultima versione disponibile dell'app: 7.10.0

Introduzione

Il presente articolo descrive le procedure necessarie per configurare un'app mobile personalizzata mediante la sezione Generatore di app mobile personalizzate della piattaforma. Le impostazioni disponibili in questa pagina consentono di personalizzare l'aspetto, le funzionalità e le capacità delle applicazioni personalizzate per Android e iOS.

• È possibile salvare le impostazioni durante il processo e riprenderne la configurazione in un momento successivo.
• Una volta completata la configurazione, è possibile generare le build delle app direttamente dalla medesima pagina.

È consentita la creazione di più app personalizzate. Per gli utenti di Extended Enterprise, Docebo raccomanda di creare un'app personalizzata dedicata a ciascun sottodominio.

Prerequisiti: ID app, link agli store e Firebase

Prima di procedere con la configurazione di un'app nella sezione Generatore di app mobile personalizzate, è necessario aver completato i seguenti passaggi:

• Selezionare un ID univoco per l'app mobile personalizzata, preferibilmente utilizzando la notazione a dominio inverso (ad esempio, com.docebo.mobile). Tale ID corrisponderà al packageId per Android e al bundleID per iOS. Si raccomanda di mantenere lo stesso ID per entrambe le piattaforme, anche se non è obbligatorio.
  Il nome del package non deve contenere parole chiave presenti nell'elenco delle parole chiave Java (si apre in una nuova scheda).
• Definire il nome pubblico dell'app mobile, che sarà identico per le versioni Android e iOS. Si raccomanda di verificare che il nome scelto non sia già presente nel Google Play Store o nell'Apple App Store.

• Per ciascun store, tramite Google Play Console o App Store Connect, è necessario creare l'app (senza caricare alcuna build in questa fase). Durante la procedura, verrà richiesto di inserire l'ID scelto e sarà generato un Store Link simile ai seguenti:

  https://play.google.com/store/apps/details?id=com.docebo.mobile

  oppure

  https://apps.apple.com/us/app/go-learn/id1362542319

  Suggerimento: Questo passaggio può essere omesso se non si intende distribuire l'app tramite tali store.

La creazione preliminare delle app consente di garantire l'unicità dell'ID scelto.

Attenzione: nel caso in cui si preveda di distribuire l'app personalizzata tramite Mobile Device Management (MDM) o altri metodi alternativi ai Google Play Store o Apple App Store, è comunque necessario creare il packageID nella Google Play Console e il bundleID in Apple Store Connect. In tale scenario non è necessario creare la scheda dell'app né disporre di un link dello store.

Suggerimento: Annotare l'ID app e i link degli store, poiché saranno necessari nelle fasi successive della configurazione.

Inoltre, per abilitare funzionalità quali notifiche push, accesso tramite Google o Google Analytics, si consiglia di completare preliminarmente le procedure illustrate nell'articolo Configurazione di Firebase per app mobile personalizzata.

Token

La creazione di una nuova app mobile personalizzata richiede un token, acquistabile tramite il proprio Account Manager. I token acquisiti rimangono associati alla piattaforma e possono essere utilizzati per la creazione di più app personalizzate.

• È necessario un token per ciascuna app personalizzata; un singolo token copre entrambe le versioni iOS e Android.
• Il token è richiesto esclusivamente al momento della creazione di una nuova app personalizzata e non per gli aggiornamenti successivi.
• Premendo il pulsante + per creare una nuova app mobile, la finestra di dialogo Nuova app mobile personalizzata indicherà il numero di token disponibili.
• È possibile eliminare app non più necessarie per liberare i relativi token.

Nel caso di pubblicazione di più app, ad esempio per i sottodomini dell'extended enterprise, sarà necessario un token per ciascuna app.

Pagina del generatore di app mobile personalizzate

Per accedere alla pagina del generatore di app personalizzata, navigare in Menu di navigazione / Personalizzazione (icona a chiave inglese) / Generatore di app mobile personalizzate.

In questa sezione saranno elencate tutte le app mobile esistenti. Per ciascuna app, è possibile visualizzare le ultime build generate per iOS e Android e verificarne la conformità all'ultima versione disponibile. 

È possibile cliccare su un'app esistente per modificarne o completarne la configurazione (vedere Modificare o eliminare un'app personalizzata), oppure cliccare sul pulsante + Crea app per avviare la creazione di una nuova app.

Creare una nuova app personalizzata

Per configurare una nuova app mobile personalizzata:

1. Accedere a Menu di navigazione / Personalizzazione (icona a chiave inglese) / Generatore di app mobile personalizzate. 

2. Quindi, nell'angolo superiore destro della pagina, cliccare sul pulsante  + Crea app . Nella finestra di dialogo, verificare la disponibilità del token necessario e procedere cliccando su Crea app.

   

3. Nel pannello Crea un'app personalizzata che si apre, inserire le seguenti informazioni: 
   • URL della piattaforma: Inserire l'indirizzo web completo della piattaforma di apprendimento a cui l'app si collega. Può essere un URL docebosaas oppure un dominio personalizzato, se configurato. Nel caso di extended enterprise, selezionare l'URL del cliente desiderato o il relativo sottodominio, se applicabile.
   • Nome app: Indicare il nome pubblico scelto per l'app, che sarà visibile agli utenti e identico per le versioni Android e iOS. Assicurarsi che il nome sia univoco e non presente nel Google Play Store o Apple App Store.
   • Sistemi operativi: Selezionare se si desidera creare un'app per iOS, Android o entrambe.
4. Al termine, cliccare su Crea app.

Si aprirà una pagina dedicata alla configurazione completa della nuova app personalizzata, suddivisa in tre aree principali: Branding, Impostazioni e Sicurezza.

È possibile iniziare la configurazione dell'app. Consultare i capitoli relativi a Dettagli app, Branding, Impostazioni app iOS, Impostazioni app Android, Servizi Firebase, Sicurezza. I progressi possono essere salvati in qualsiasi momento tramite il pulsante Salva le modifiche. Per riprendere o modificare la configurazione, è sufficiente selezionare l'app dalla pagina Generatore di app mobile personalizzate.

Generare le build e caricare negli store

Al termine della configurazione dell'app mobile personalizzata, cliccare su Salva le modifiche per memorizzare le impostazioni. Successivamente, si può procedere con la generazione delle build.

• Se sono state configurate entrambe le versioni iOS e Android, è possibile scegliere se generare la build per una sola o per entrambe le piattaforme.
• Se sono stati configurati gli Aggiornamenti diretti per le app iOS o Android, sarà possibile generare e caricare la build in un'unica operazione.

Per ulteriori dettagli, consultare l'articolo Configurare gli aggiornamenti diretti per l'app mobile personalizzata.

Generare le build

Nell'angolo superiore destro della pagina di configurazione dell'app personalizzata, cliccare sul pulsante Genera build.

Nella finestra che si apre, selezionare le versioni dell'app per le quali si desidera generare le build: iOS, Android o entrambe.

Suggerimento: Nel caso in cui sia stata configurata una sola versione dell'app, sarà disponibile un'unica opzione (solo iOS o solo Android).

Il sistema indicherà per ogni build se essa sarà automaticamente rifirmata e inviata allo store (in caso di Aggiornamenti diretti configurati) oppure se sarà necessario firmarla manualmente e caricarla nello store (in assenza di Aggiornamenti diretti).

Quando pronti, cliccare sul pulsante Genera build o Genera e carica le build per avviare il processo.

Il sistema inizierà la generazione del pacchetto o dei pacchetti dell'app, in base alle piattaforme selezionate. Il processo potrebbe richiedere diverse ore (fino a 8 ore).

Attenzione: la generazione della build potrebbe fallire se avviata durante il processo di rilascio settimanale o mensile di Docebo. In tal caso, si consiglia di riprovare al termine del rilascio.

È possibile monitorare l'avanzamento tramite la barra posta nella parte superiore della pagina di configurazione dell'app personalizzata:

• Al clic sul pulsante Genera build/Genera e carica le build, lo stato cambierà in Preparazione delle build... Build richiesta.
  
• Al completamento del processo, verrà mostrato il risultato (build generata o build generata e inviata allo store) per ciascuna versione. Si riceverà inoltre una notifica via email.
  

• Se una build è stata generata e inviata allo store, il processo si è concluso con successo, con firma e invio automatico. Non sono necessarie ulteriori azioni.

  Suggerimento: È comunque possibile scaricare una copia locale della build tramite il pulsante Scarica build, tenendo presente che tale build non sarà rifirmata.

• Nel caso in cui la build sia stata solo generata, sarà necessario scaricare il pacchetto, firmarlo manualmente e caricarlo nello store.

Procedura per la firma manuale e il caricamento nello store:

Ripetere i passaggi seguenti per ciascuna versione dell'app (iOS e Android) che non è inviata automaticamente.

Una volta disponibile la build, nella barra dei risultati in alto nella pagina di configurazione dell'app, cliccare sul link Scarica build per effettuare il download.

Suggerimento: È possibile visualizzare la cronologia delle build precedenti e scaricare l'ultima utilizzando il pulsante Gestisci build.

Successivamente, occorre rifirmare il pacchetto per sostituire la firma digitale temporanea applicata da Docebo e caricare manualmente la build firmata negli store, seguendo le indicazioni presenti in Rifirmare e pubblicare l'app mobile personalizzata.

Please note: Il pacchetto deve essere scaricato entro la data di scadenza indicata; in caso contrario sarà necessario rigenerare la build.

Messaggi d'errore della build

In caso di errori durante la generazione o il caricamento della build, la barra dei risultati mostrerà un messaggio indicante la fase in cui si è verificato il problema. Tali informazioni saranno riportate anche nell'email di notifica.

• Errore durante la generazione della build. La build non può essere generata al momento. Si consiglia di verificare le impostazioni del generatore personalizzato o contattare il centro assistenza. In questo caso non sarà disponibile alcuna build da scaricare. 
• Errore durante il rinnovo della firma della build: La build è stata generata correttamente, ma si è verificato un errore nella rifirma automatica. È comunque possibile scaricare il pacchetto non firmato per procedere con la rifirma e il caricamento manuale.

• Errore durante il caricamento della build sullo store: la build è stata generata e rifirmata correttamente, ma il caricamento nello store è fallito. Si raccomanda di verificare le impostazioni degli Aggiornamenti diretti e riprovare, oppure scaricare la build per la rifirma e il caricamento manuale.

  Please note: Il pacchetto scaricato sarà sempre non firmato e richiederà rifirma, anche se la firma automatica è stata completata con successo.

Modificare o eliminare un'app personalizzata

La pagina Generatore di app mobile personalizzate elenca tutte le app personalizzate create. Per modificare o eliminare un'app, selezionare l'icona dei tre puntini posta alla fine della riga corrispondente, quindi scegliere l'opzione desiderata dal menu a discesa.

Ogni modifica richiede la generazione di una nuova build. Al termine del processo, sarà inviata una notifica via email.

Procedura per modificare un'app personalizzata

1. Cliccare sull'icona dei tre puntini nella riga dell'app e selezionare Modifica.
2. Apportare le modifiche necessarie nelle impostazioni di Dettagli app, Branding, Impostazioni app iOS, Impostazioni app Android, Servizi Firebase e Sicurezza.

3. Al termine, cliccare su Salva le modifiche.

   Please note: Dopo aver aggiornato le impostazioni dell'app, è necessario generare una nuova build e procedere con il caricamento agli store per rendere effettive le modifiche.

Procedura per eliminare un'app personalizzata

1. Cliccare sull'icona dei tre puntini nella riga dell'app e selezionare Elimina.
2. Nella finestra di conferma, cliccare nuovamente su Elimina per confermare la rimozione dell'app dalla pagina Generatore di app mobile personalizzate. Si ricorda che questa operazione non rimuove l'app dagli store; l'eliminazione dagli store dovrà essere gestita separatamente.

Please note: In caso di eliminazione e successiva necessità di riutilizzo dell'app, sarà necessario riconfigurare completamente tutte le impostazioni nella pagina del generatore personalizzato.

Aggiornare l'app personalizzata

Anche in assenza di modifiche alle impostazioni, è necessario generare e distribuire periodicamente nuove build per incorporare gli ultimi aggiornamenti basati sulla versione più recente del codice sorgente. Le build nel generatore di app mobile personalizzate sono sempre generate utilizzando l'ultima versione disponibile del codice base.

Verificare gli aggiornamenti

Le nuove versioni di Go.Learn e dell'app mobile personalizzata vengono comunicate nella pagina degli aggiornamenti prodotto.

È possibile controllare gli aggiornamenti direttamente nella pagina del generatore personalizzato:

• La colonna Ultima versione indica l'ultima versione rilasciata di Go.Learn e dell'app mobile personalizzata.
• Le colonne Build iOS e Build Android mostrano invece la versione dell'ultima build generata, con un'icona di avviso in caso di necessità di aggiornamento.

Aggiornare l'app

Quando è disponibile una versione più recente dell'app, per fornire l'aggiornamento agli utenti è necessario generare nuove build per le app iOS e Android e caricarle negli store. A tal fine:

• Seguire i passaggi descritti nel capitolo Generare le build e caricare negli store

Please note:

• L'aggiornamento dell'app personalizzata non è obbligatorio, ma è fortemente consigliato per garantire l'utilizzo della versione più affidabile e completa, con tutte le funzionalità introdotte nelle ultime release di Go.Learn.
• Docebo fornisce supporto prodotto esclusivamente per l'ultima versione dell'app mobile.

Revisionare i dettagli dell'app

Dopo la creazione dell'app, è possibile rivedere il nome e l'URL della piattaforma inseriti in fase di creazione. Sarà inoltre necessario specificare un indirizzo email per ricevere le notifiche di build:

Per effettuare queste operazioni, accedere alla pagina del generatore personalizzato dell'app e selezionare Impostazioni / Dettagli.

Please note: La modifica del nome dell'app comporta la creazione di una nuova app separata. Dopo la creazione della scheda nello store e la configurazione dell'app personalizzata, la modifica del nome richiederà la creazione di una nuova scheda e la riconfigurazione completa dell'app.

Personalizzare il branding dell'app

Nell'area Branding della pagina del generatore personalizzato, è possibile personalizzare l'aspetto dell'app personalizzata.

Per accedervi, selezionare Menu di navigazione / Personalizzazione (icona a forma di forme) / Generatore di app mobile personalizzate / [nome app].

In questa sezione è possibile configurare l'icona dell'app, la schermata iniziale (Splash screen), il menu Drawer e la pagina Prelogin.

Icona app

L'icona app rappresenta l'immagine visualizzata sulla schermata del dispositivo, tramite cui gli utenti avviano l'app.

Generalmente, su Android si utilizzano icone di forma rotonda, mentre su iOS icone quadrate con angoli arrotondati. Per evitare ritagli, si consiglia di centrare l'icona all'interno di un cerchio di diametro 1024 px, come illustrato di seguito.

Splash screen

La splash screen è l'immagine visualizzata subito dopo l'avvio dell'app, durante il caricamento. Generalmente riporta il branding o il logo aziendale. Per evitare ritagli, il logo dovrebbe essere posizionato all'interno di un cerchio centrato di diametro 832 px, come illustrato di seguito.

Pagina Prelogin

Nel caso di app mobile a dominio aperto, è disponibile la sezione Immagine sfondo prelogin, dove è possibile caricare l'immagine di sfondo della schermata di benvenuto in cui l'utente inserisce l'URL della piattaforma.
Le dimensioni dell'immagine di sfondo prelogin devono essere 720x1280 px (orientamento verticale per dispositivi mobili) a 72 DPI, e il formato richiesto è PNG a 32 bit con canale alfa. La dimensione massima del file è 4 MB.

Impostazioni app iOS

Nella sezione Impostazioni / App iOS della pagina del generatore personalizzato, è possibile abilitare e configurare la versione iOS dell'app personalizzata.

Se non si è abilitata iOS durante la creazione dell'app, è possibile farlo ora selezionando la casella Abilita app mobile iOS.

Le impostazioni configurabili in questa sezione sono specifiche per l'app iOS:

iOS / Modalità app di lettura

La modalità app di lettura è richiesta dalle linee guida Apple per consentire l'accesso a contenuti acquistati esternamente all'app.

• Questa modalità assicura la conformità alle linee guida Apple per l'e-commerce (contenuti a pagamento) (si apre in una nuova scheda), ed evita il rifiuto dell'app da parte dell'Apple App Store.

Abilitando la modalità app di lettura, gli utenti potranno accedere ai contenuti acquistati precedentemente tramite la versione desktop della piattaforma.

Si segnala che in modalità lettore non è possibile creare account utente direttamente nell'app mobile; pertanto, se è consentita la registrazione autonoma, gli utenti dovranno registrarsi tramite la piattaforma desktop.

iOS / Link store

Inserire l'URL della pagina dell'app personalizzata nell'Apple App Store.

https://apps.apple.com/us/app/go-learn/id1362542319

Il campo può essere lasciato vuoto se non si intende distribuire l'app tramite gli store.

iOS / Universal link

L'universal link è un URL che consente di aprire l'app personalizzata su una schermata specifica anziché nel browser.

Per abilitare questa funzionalità, selezionare la casella Abilita universal link e inserire l'App ID.

Recuperare l'ID app

L'ID app è reperibile nella Apple Developer's Console (si apre in una nuova scheda), nella sezione Certificates, Identifiers & Profiles.

Il valore dell'App ID è costituito dal team ID o prefisso app ID seguito dal bundle ID, separati da un punto, con formato: teamID.bundleID, ad esempio: ABCD1234.com.apple.wwdc.

Nell'esempio riportato in figura, il valore da inserire nel campo App ID è:

9YR6YH8KLL.com.mycompany.myapp.client

Verificare abilitazione Associated Domains

Nella pagina Certificates, Identifiers & Profiles, scorrendo fino alla scheda Capabilities, verificare che la capacità Associated Domains sia abilitata.

Ulteriori informazioni sui domini associati (si apre in una nuova scheda).

iOS / Accesso demo

La funzionalità di accesso demo consente agli utenti di provare l'app senza creare un account e senza accedere. È necessario configurare preliminarmente un account specifico sulla piattaforma con permessi limitati da utilizzare come account demo.

Per abilitare questa funzione, selezionare la casella Abilita accesso demo iOS e inserire le credenziali dell'account demo nei campi Nome utente demo e Password demo.

iOS / Formato pacchetto

In questa sezione selezionare il formato della build dell'app iOS. Il formato IPA è raccomandato per distribuzione e test.

iOS / Aggiornamenti diretti

In quest'area è possibile configurare opzionalmente l'invio automatico degli aggiornamenti dell'app agli store direttamente dalla pagina Generatore di app mobile personalizzate, evitando la rifirma e il caricamento manuale di ogni nuova build.

Please note: Questa configurazione può essere aggiunta anche in un secondo momento.

Una volta configurati gli aggiornamenti diretti, ogni build generata verrà automaticamente rifirmata e inviata allo store.

Per istruzioni dettagliate, consultare l'articolo Configura aggiornamenti diretti per l'app mobile personalizzata.

Impostazioni app Android

Nella sezione Impostazioni / App Android della pagina del generatore personalizzato, è possibile abilitare e configurare la versione Android dell'app personalizzata.

Se non si è abilitata Android durante la creazione dell'app, è possibile farlo ora selezionando la casella Abilita app mobile Android.

Le impostazioni configurabili in questa sezione sono specifiche per l'app Android:  

Android / Link dello store

Inserire l'URL della pagina dell'app personalizzata nel Google Play Store.

https://play.google.com/store/apps/details?id=com.docebo.mobile

Il campo può essere lasciato vuoto se non si intende distribuire l'app tramite gli store.

Android / Nome del package

Inserire il packageID Android della propria app personalizzata, ad esempio com.docebo.mobile.

Android / Link app

Un app link è un URL che consente di aprire l'app personalizzata su una schermata specifica.

Per abilitare questa funzionalità, selezionare la casella Abilita link app. Quindi inserire nel campo Impronta digitale certificato SHA l'impronta SHA256 del certificato di firma.

Per recuperare l'impronta, accedere alla Google Play Console (si apre in una nuova scheda) e navigare nella sezione Integrità app. Nella sezione Digital Asset Links JSON della pagina, copiare il valore che si trova sotto sha256_cert_fingerprints.

Android / Formato pacchetto

Selezionare AAB (Android App Bundle) per pubblicare l'app personalizzata nel Google Play Store.

Nota importante: Dal mese di agosto 2021, Google Play (si apre in una nuova scheda) richiede che tutte le nuove app e gli aggiornamenti di app esistenti pubblicati nel Google Play Store per Android utilizzino il formato Android App Bundle (AAB).

È comunque possibile selezionare Android Package (APK) se si prevede di distribuire l'app tramite un sistema di Mobile Device Management (MDM) anziché tramite il Google Play Store pubblico.

Android / Aggiornamenti diretti

In quest'area è possibile configurare opzionalmente l'invio automatico degli aggiornamenti agli store dalla pagina Generatore di app mobile personalizzate, evitando la rifirma e il caricamento manuale di ogni nuova build.

Please note: Questa configurazione può essere aggiunta anche successivamente.

Una volta configurati gli aggiornamenti diretti, ogni build generata verrà automaticamente rifirmata e inviata allo store.

Per istruzioni dettagliate, consultare l'articolo Configura aggiornamenti diretti per l'app mobile personalizzata.

Servizi Firebase (notifiche push, accesso Google, Analytics)

Per abilitare funzionalità quali Firebase Messaging (notifiche push o messaggistica in-app), accesso Google o Google Analytics per l'app personalizzata, è necessario configurare la sezione Servizi.

• Le impostazioni specifiche da configurare dipenderanno dai servizi che si intendono utilizzare.
• Se non si desiderano utilizzare tali funzionalità, è possibile lasciare deselezionata la casella Abilita servizi Firebase.

Prerequisito: Se non lo si è già fatto, completare preliminarmente i passaggi descritti in Configurazione di Firebase per l'app mobile personalizzata.

Successivamente, nella pagina del generatore personalizzato, selezionare Impostazioni / Servizi e attivare la casella Abilita servizi Firebase.

Per tutti i servizi Firebase, è ora necessario caricare il file di configurazione dei servizi Google ottenuto da Firebase. I file da caricare variano in base alle versioni dell'app che si stanno creando:

• Per l'app iOS, caricare il file GoogleService-Info.plist ottenuto da Firebase.
• Per l'app Android, caricare il file google-services-json ottenuto da Firebase.

Sotto Impostazioni Firebase selezionare le caselle corrispondenti ai servizi da abilitare. È necessario attivare almeno un servizio.

Se non si desiderano utilizzare questi servizi, deselezionare la casella Abilita servizi Firebase.

Abilita notifiche push

Per utilizzare le notifiche push o Google Analytics nell'app, selezionare questa opzione. Quindi inserire l'ID progetto Firebase e caricare il file chiave account di servizio Firebase.  
Per dettagli su come ottenerli, consultare l'articolo Configurazione di Firebase per app mobile personalizzata / Ottenere ID progetto Firebase e file chiave account di servizio.

Abilita accesso Google

Selezionare questa opzione per abilitare l'accesso Google nell'app. Quindi inserire il Web client ID del progetto dell'app in Firebase e, se si dispone di un'app iOS, anche il client ID iOS.
Per informazioni su come ottenerli, consultare l'articolo Configurazione di Firebase per app mobile personalizzata / Abilitare accesso Google.