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:

  1. Prepara le risorse (come l'immagine della schermata iniziale) e il testo in modo che entrambi possano essere utilizzati nell'app e la descrizione nell'app/play store.

  2. Assegnare una risorsa tecnica in grado di:

    • Generazione dei file del certificato di notifica push.
    • Firma dei file binari dell'app forniti dal team ALM.
    • Caricamento e gestione del processo di pubblicazione. Il processo di pubblicazione richiede la comunicazione tra il gestore dell'app e i team dell'app/play store che l'app è conforme a tutte le linee guida sulla pubblicazione. Da ALM, riceverai un file binario dell'app completamente conforme.

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

code language-none
<p>ID account</p>
code language-none
<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>
code language-none
<p>ID account aggiuntivi</p>
code language-none
<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>
code language-none
<p>Nome app</p></td>
code language-none
<p>Il nome che si desidera utilizzare per l'app.</p>
code language-none
<p>Nome breve dell’app</p>
code language-none
<p>Nei casi in cui il nome dell'app è lungo, assegna all'app un nome breve che appare sul dispositivo.</p>
code language-none
<p>Nome app interna</p></td>
code language-none
<p>Il nome con cui il sistema operativo identifica l'app. Il formato solitamente utilizzato è: com.company-name.product-name.</p>
code language-none
<p>Nome app interna - iOS</p>
code language-none
<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>
code language-none
<p>Icona app</p>
code language-none
<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.</p>
code language-none
<p>Schermata iniziale dell’app</p></td>
code language-none
<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>
code language-none
<p>ID client e segreto client</p>
code language-none
<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>
code language-none
<p>Logo account</p>
code language-none
<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>
code language-none
<p>ID App Store per l’app (iOS)</p>
code language-none
<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>
code language-none
<p>ID Play Store per Google per l’app (Android)</p>
code language-none
<p>ID richiesto per implementare l’aggiornamento forzato.</p>
code language-none
<p>Nome host per collegamento profondo</p>
code language-none
<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>
NOTE
Fornisci i dati ai tuoi CSAM in modo che possano aggiungerli nel tuo file binario personalizzato dell'app.

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.

CAUTION
Se i file non sono presenti, i collegamenti non funzioneranno. Assicurati che i file siano presenti.

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.

  • Per iOS, genera i certificati di notifica push.
  • Per Android, fornisci una chiave server generata dal progetto Firebase.

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.

  1. Generare o scaricare Certificato di notifica push e chiave privata (.p12). Per ulteriori informazioni, consultate Documento per sviluppatori Apple.

  2. Installa il file p12 dopo averlo scaricato. Utilizza la password per eseguire l’installazione Accesso Portachiavi.

  3. Passa a Certificati personali ed esportare il certificato. Assicurati di selezionare il tipo MIME .CER.

  4. Una volta che hai il file p12 e il file cer sono disponibili, esegui i seguenti comandi:

- 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 Crea progetto in Firebase.

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

  1. Accedi a Firebase console.

  2. Vai a Impostazioni progetto e seleziona Messaggistica cloud.

  3. Trova API di messaggistica cloud di Firebase e seleziona Gestione account di servizio.

  4. Nella Account del servizio , seleziona la pagina Account di servizio nel pannello a sinistra.

  5. Trova la voce del progetto e seleziona Gestisci dettagli in azioni.

    note note
    NOTE
    Il formato di immissione del progetto sarà <-accountname->@appspot.gserviceaccount.com.
  6. Vai a Tasti e selezionare Aggiungi chiave.

  7. Se non è presente alcun tasto, selezionare Crea nuova chiave e seleziona JSON come tipo di chiave. Questo genererà e scaricherà il file JSON.

  8. Se è già presente un tasto, selezionare Carica chiave esistente, incolla la chiave e caricala. Questo genererà e scaricherà il file JSON.

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.

Aggiungere il progetto in Firebase e recuperare google-services.json file.

iOS

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

IMPORTANT
Invia i file al team CSAM di Adobe Learning Manager per includerli nella build del file binario dell’app.

Genera i file binari firmati

iOS

sh""" xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath "ipa_path/" -exportOptionsPlist {ExportFile}

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
Per creare i file binari firmati è necessario XCode 15.2 o versione successiva.

Android

sh""" ~/Library/Android/sdk/build-tools/30.0.3/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 """
NOTE
Per creare i file binari firmati, saranno necessari gli strumenti di compilazione SDK Android.

Passaggi successivi

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 compila quindi il form con le modifiche necessarie 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

  • Schermata Aggiorna password
  • Creazione di una schermata dell'account
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d