Etichettatura bianca nell’app mobile Adobe Learning Manager

L’app per dispositivi mobili Adobe Learning Manager ora supporta l’etichettatura bianca, il che significa che ora puoi rilasciare l’app con il tuo marchio.

Come iniziare a preparare l’avvio dell’app con etichetta bianca

Per distribuire e gestire la tua app con etichetta bianca, segui i passaggi:

Panoramica

L'etichettatura bianca è una pratica per rinominare un'app o un servizio con il proprio marchio e personalizzarlo come se fossi il creatore originale. In Adobe Learning Manager, puoi applicare l'etichettatura bianca all'app per dispositivi mobili, in modo da rinominare l'app e renderla disponibile agli utenti con il tuo marchio.

Cosa è possibile personalizzare

È possibile personalizzare quanto segue:

Campi

<p>ID account</p>

<p>ID del tuo account. Tieni presente che l’app con etichetta bianca non sarà accessibile agli Allievi che appartengono a nessun altro account.</p>

<p>ID account aggiuntivi</p>

<p>Se lo desideri, aggiungi più account (sottodomini). Aggiungi i sottodomini come separati da virgole senza spazi. Ad esempio, acc01,acc02,acc03 e così via.<br> <b>Nota:</b> è necessario aggiungere l'ID account quando si specificano i sottodomini.</br> </p>

<p>Nome app</p></td>

<p>Il nome che si desidera utilizzare per l'app.</p>

<p>Nome breve dell’app</p>

<p>Nei casi in cui il nome dell'app è lungo, assegna all'app un nome breve che appare sul dispositivo.</p>

<p>Nome app interna</p></td>

<p>Il nome con cui il sistema operativo identifica l'app. Il formato solitamente utilizzato è: com.company-name.product-name.</p>

<p>Nome app interna - iOS</p>

<p>Assegna un nome diverso all’app se gli utenti si trovano in iOS. Si consiglia di utilizzare lo stesso nome sia per iOS che per Android.</p>

<p>Icona app</p>

<p>L'icona dell'app come png. Questa icona viene visualizzata nell'app. Il formato da assegnare al nome è account-id_appIcon.png. Le dimensioni dell'icona dell'app sono di 512 × 512 pixel.<div>Tieni presente che Apple non consente il canale di Alpha nelle icone delle app. Assicurati quindi di rimuovere il canale di Alpha dalla risorsa prima di inviarla.</div></p>

<p>Schermata iniziale dell’app</p></td>

<p>Per la schermata iniziale dell'app, fornisci un'immagine (png) che viene visualizzata quando gli utenti avviano l'app. Il formato del nome è account-id_splashIcon.png. Le dimensioni delle schermate iniziali basate su quadrati sono di 1052 × 1052 pixel, quelle basate su cerchi di 768 x 768 pixel.</p>

<p>ID client e segreto client</p>

<p>L’Amministratore dell’integrazione del tuo account fornisce i dettagli durante la registrazione dell’app. L’Amministratore dell’integrazione deve utilizzare quanto segue:<ul><li>Allievo:lettura,allievo:scrittura come ruolo</li><li>app interna name://redirect come URL di reindirizzamento</li></ul></p>

<p>Logo account</p>

<p>URL che ospita il logo dell'organizzazione. Fornisci un collegamento al contenuto come logo dell’account. L’URL deve essere codificato per il Web.</p>

<p>ID App Store per l’app (iOS)</p>

<p>ID richiesto per implementare l’aggiornamento forzato. L’app deve sapere che l’Allievo deve essere reindirizzato all’App Store per aggiornare l’app.</p>

<p>ID Play Store per Google per l’app (Android)</p>

<p>ID richiesto per implementare l’aggiornamento forzato.</p>

<p>Nome host per collegamento profondo</p>

<p>Per ospitare i collegamenti diretti, utilizza Learning Manager. Se si desidera utilizzare un altro URL nome host come collegamento profondo, fornire l'URL dell'host. Ad esempio, learningmanager.adobe.com.</p>

Aggiornare l'associazione del sito per gestire i collegamenti personalizzati

Se utilizzi un dominio personalizzato o learningmanager*.adobe.com come host, non è necessario intraprendere alcuna azione. Tuttavia, se utilizzate una soluzione personalizzata o un nome host specifico per gli URL, aggiungete i file di associazione del sito.

Per ulteriori informazioni, fai riferimento ai seguenti collegamenti:

Genera notifiche push

L’invio di notifiche push alle app Android e iOS richiede due meccanismi diversi.

Segui le istruzioni riportate di seguito per configurare i progetti in Firebase:

Notifiche push su iOS

Nello sviluppo di app iOS, un certificato di notifica push è una credenziale crittografica rilasciata da Apple che consente a un server di inviare notifiche push in modo sicuro a un dispositivo iOS tramite il servizio di notifica push (APN) di Apple.

Il certificato garantisce una comunicazione sicura tra il server (o il provider) e i numeri API di Apple quando si inviano notifiche push ai dispositivi iOS.

Sia Android che iOS utilizzano Firebase Cloud Messaging (FCM) come servizio per l’invio di notifiche push ai dispositivi.

Come generare il certificato su iOS

Seguire la procedura descritta di seguito.

- openssl pkcs12 -in privatekey.p12 -out myapnappkey.pem -nodes –clcerts

- openssl x509 -in privatekey.cer -inform DER -out myapnsappcert.pem

- openssl s_client -connect gateway.sandbox.push.apple.com:2195 -cert myapnsappcert.pem -key myapnappkey.pem

Se è possibile connettersi al server, il certificato creato è valido. Dal file myapnappkey.pem, copiare i valori del certificato e della chiave privata.

Notifiche push su Android

Per Android, l’utente deve fornire il file services.json dal progetto Firebase per aggiungere la voce nel servizio SNS.

Crea un progetto in Firebase e condividi il file services.json con il team CSM. Questo file è necessario per la voce basata su token nell'SNS. Si noti che la chiave del server non è più utilizzata. Vedere Creare un progetto in Firebase.

Per scaricare il file services.json, effettua le seguenti operazioni:

Contatta il team CSM e condividi il file JSON per aggiungere la voce ai servizi SNS in AWS. Gli utenti dovranno registrare la voce nel servizio SNS per la notifica push, che richiederà loro di condividere i certificati generati sopra per la convalida.

Crea progetto in Firebase create-project-in-firebase

Android

Riutilizza lo stesso progetto creato nei passaggi precedenti per le notifiche push.

Aggiungi il progetto in Firebase e recupera il file google-services.json.

iOS

Aggiungere il progetto a Firebase e recuperare il file GoogleService-Info.plist.

Genera i file binari firmati

iOS

La cartella <root> contiene il file Runner.xcarchive.zip. Esegui i comandi seguenti per generare il file binario firmato:

Se il dispositivo è incluso nel profilo di provisioning, l'installazione deve procedere sul dispositivo.

Android

Per il file apk

sh""" <path>/apksigner sign --ks $storeFile --ks-pass "pass:$store_password" --ks-key-alias $key_alias --key-pass "pass:$key_password" --out app-release-signed.apk -v app-release.apk """

Per il file aab

Play Store richiede file binari Android in formato aab per la pubblicazione. Pertanto, forniremo il file .aab non firmato.

Segui i passaggi riportati di seguito per firmare il file .aab:

Esegui il comando seguente:

<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>

Quando richiesto, immetti le seguenti password:

È possibile utilizzare l'apk fornito. Tuttavia, se devi generare un'app da un file aab, segui questi passaggi:

Esegui il comando seguente per creare il file apk:

java -jar <path>/bundletool-all.jar  build-apks --bundle=app-release.aab --output=my_app.apks --mode=universal

Per decomprimere il file, esegui il comando seguente:

unzip my_app.apks -d output_dir

Riceverai il file apk dalla cartella output_dir.

Novità

Dopo aver generato i file binari, inviali a Play Store o App Store.

Come si applicano le modifiche

Invia le risorse e i file necessari al team CSM. Il team CSM quindi compila il modulo con le modifiche richieste e allega le risorse richieste. Il team rivedrà e informerà i team tecnici delle modifiche. Il team tecnico genererà quindi una build e la condividerà con il team CSM.

Il team CSM condividerà la build con il cliente.

Cosa non può essere personalizzato