Vit märkning i mobilappen Adobe Learning Manager

Adobe Learning Manager-mobilappen stöder nu vit märkning, vilket innebär att du nu kan släppa appen under ditt eget varumärke.

Hur du ska börja förbereda för att starta ett program med vit etikett

Gör så här för att distribuera och hantera ditt eget program med vita etiketter:

  1. Förbered resurserna (t.ex. en välkomstbild) och texten så att båda kan användas i appen och beskrivningen i app/play-butiken.

  2. Tilldela en teknisk resurs som kan:

    • Genererar certifikatfiler för push-meddelanden.
    • Signera programmets binärfiler som tillhandahålls av ALM-teamet.
    • Ladda upp och hantera publiceringsprocessen. Publiceringsprocessen kräver kommunikation mellan apphanteraren och app/play store-team om att din app följer alla publiceringsriktlinjer. Från ALM får du en helt kompatibel app binär.

Översikt

Vit märkning är en metod att byta namn på en app eller tjänst med ditt eget varumärke och anpassa den som om du vore den ursprungliga skaparen. I Adobe Learning Manager kan du använda vit etikettering i mobilappen så att du kan byta varumärke på appen och göra den tillgänglig för användarna under ditt eget varumärke.

Vad kan anpassas

Du kan anpassa följande:

Fält

code language-none
<p>Konto-ID</p>
code language-none
<p>ID för ditt konto. Observera att det vitmärkta programmet inte är tillgängligt för elever som tillhör något annat konto.</p>
code language-none
<p>Ytterligare konto-ID</p>
code language-none
<p>Lägg till flera konton (underdomäner) om du vill. Lägg till underdomänerna som kommaavgränsade utan mellanslag. Till exempel acc01,acc02,acc03 och så vidare.<br> <b>Obs!</b> Du måste lägga till konto-ID när du anger underdomänerna.</br> </p>
code language-none
<p>Programnamn</p></td>
code language-none
<p>Namnet som du vill använda för appen.</p>
code language-none
<p>Kortnamn för app</p>
code language-none
<p>I fall där namnet på appen är långt ska du ge den ett kort namn som visas på enheten.</p>
code language-none
<p>Internt programnamn</p></td>
code language-none
<p>Namnet som operativsystemet identifierar programmet med. Det format som vanligtvis används är: com.company-name.product-name.</p>
code language-none
<p>Internt programnamn - iOS</p>
code language-none
<p>Namnge programmet på ett annat sätt om användarna använder iOS. Vi rekommenderar att du använder samma namn för både iOS och Android.</p>
code language-none
<p>Appikon</p>
code language-none
<p>Appikonen som png. Den här ikonen visas i ditt program. Formatet som ska namnges är account-id_appIcon.png. Appikonens dimensioner är 512 × 512 pixlar.</p>
code language-none
<p>Appstartskärm</p></td>
code language-none
<p>Ange en bild (png) som visas när användarna startar programmet på programmets välkomstskärm. Formatet som ska namnges är account-id_splashIcon.png. De kvadratiska välkomstskärmarna är 1 052 × 1 052 pixlar och de cirkelbaserade välkomstskärmarna är 768 x 768 pixlar.</p>
code language-none
<p>Klient-ID och Klienthemlighet</p>
code language-none
<p>Integreringsadministratören för ditt konto tillhandahåller informationen medan du registrerar programmet. Integreringsadministratören måste använda detta:<ul><li>elev:läsa,elev:skriva som roll</li><li>internt program name://redirect som omdirigerings-URL</li></ul></p>
code language-none
<p>Kontologotyp</p>
code language-none
<p>Den URL som är värd för organisationens logotyp. Ange en cpcontent-länk som kontologotyp. Webbadressen måste vara webbkodad.</p>
code language-none
<p>Appbutikens ID för appen (iOS)</p>
code language-none
<p>Det ID som krävs för att implementera force-uppdateringen. Appen måste veta att eleven ska omdirigeras till appbutiken för att uppdatera appen.</p>
code language-none
<p>Google Play Store-id för appen (Android)</p>
code language-none
<p>Det ID som krävs för att implementera force-uppdateringen.</p>
code language-none
<p>Värdnamn för djuplänkning</p>
code language-none
<p>Använd Learning Manager om du vill vara värd för dina djuplänkar. Om du vill använda ett annat värdnamn som en djuplänk anger du värddatorns URL. Exempel: learningmanager.adobe.com.</p>
NOTE
Ange informationen i dina CSAM-filer så att de kan lägga till den i din anpassade binära app.

Uppdatera webbplatsassociationen för att hantera anpassade djuplänkar

Om du använder en anpassad domän eller Learning Manager*.adobe.com som värd behöver du inte vidta några åtgärder. Men om du använder en anpassad lösning eller ett specifikt värdnamn för webbadresserna ska du lägga till platsassociationsfilerna.

CAUTION
Om filerna inte finns där fungerar inte djuplänkarna. Se till att filerna finns.

Mer information finns på följande länkar:

Generera push-meddelanden

Det krävs två olika mekanismer för att skicka push-meddelanden till Android- och iOS-program.

  • Generera certifikat för push-meddelanden för iOS.
  • För Android anger du en servernyckel som genereras från Firebase-projektet.

Följ anvisningarna nedan för att konfigurera projekten i Firebase:

Push-aviseringar på iOS

Ett push-meddelandecertifikat är en kryptografisk autentiseringsuppgift inom iOS-apputveckling som utfärdas av Apple och som gör det möjligt för en server att på ett säkert sätt skicka push-meddelanden till en iOS-enhet via Apple Push Notification Service (APN:er).

Certifikatet garanterar säker kommunikation mellan servern (eller leverantören) och Apple APN-filer när push-meddelanden skickas till iOS-enheter.

Både Android och iOS använder Firebase Cloud Messaging (FCM) som tjänst för att skicka push-meddelanden till enheter.

Så här genererar du certifikatet i iOS

Följ proceduren:

  1. Generera eller hämta Push Notification-certifikatet och den privata nyckeln (.p12). Mer information finns i Apple-utvecklardokumentet.

  2. Installera p12-filen när filen har hämtats. Använd lösenordet för att installera i din Nyckelhanterare.

  3. Gå till Mina certifikat och exportera certifikatet. Se till att du väljer MIME-typen .cer.

  4. Kör följande kommandon när du har p12-filen och CER-filen tillgängliga:

- 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

Om du kan ansluta till servern är certifikatet du har skapat giltigt. Kopiera certifikatet och värdena för den privata nyckeln från filen myapnappkey.pem.

Push-meddelanden på Android

För Android måste användaren ange filen services.json från Firebase-projektet för att lägga till posten i SNS-tjänsten.

Skapa ett projekt i Firebase och dela filen services.json till CSM-teamet. Denna fil behövs för tokenbaserad post i SNS. Observera att servernyckeln inte längre används. Se Skapa projekt i Firebase.

Gör så här för att hämta filen services.json:

  1. Logga in på Firebase-konsolen.

  2. Gå till Projektinställningar och välj Molnmeddelanden.

  3. Hitta Firebase Cloud Messaging API och välj Hantera tjänstkonton.

  4. På sidan Tjänstkonton väljer du Tjänstkonton i den vänstra panelen.

  5. Hitta din projektpost och välj Hantera information under åtgärder.

    note note
    NOTE
    Projektposten kommer att ha formatet <-accountname->@appspot.gserviceaccount.com.
  6. Gå till fliken Nycklar och välj Lägg till nyckel.

  7. Om det inte finns någon nyckel väljer du Skapa ny nyckel och väljer JSON som nyckeltyp. JSON-filen genereras och hämtas.

  8. Om det redan finns en nyckel väljer du Överför befintlig nyckel, klistrar in nyckeln och överför den. JSON-filen genereras och hämtas.

Kontakta CSM-teamet och dela JSON-filen för att lägga till posten till SNS-tjänsterna på AWS. Användare måste få posten registrerad i SNS-tjänsten för push-meddelandet, vilket kräver att de delar certifikaten som genereras ovan för validering.

Skapa projekt i Firebase create-project-in-firebase

Android

Återanvänd samma projekt som du skapade i stegen ovan för push-meddelanden.

Lägg till projektet i Firebase och hämta google-services.json-filen.

iOS

Lägg till projektet i Firebase och hämta GoogleService-Info.plist-filen.

IMPORTANT
Skicka filerna till Adobe Learning Manager CSAM-teamet som ska inkludera i bygget av den binära appfilen.

Generera signerade binärfiler

iOS

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

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
Du behöver XCode 15.2 eller senare för att skapa de signerade binärfilerna.

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
Du behöver verktyg för Android SDK för att bygga de signerade binärfilerna.

Nästa steg

När du har genererat binärfilerna överför du dem till Play Store eller App Store.

Hur tillämpar jag ändringarna?

Skickar de nödvändiga resurserna och filerna till CSM-teamet. CSM-teamet fyller sedan i formuläret med de ändringar som krävs och bifogar de resurser som krävs. Teamet kommer då att granska och informera teknikerteamen om ändringarna. Teknikteamet kommer sedan att skapa en version och dela den med CSM-teamet.

CSM-teamet delar bygget med kunden.

Vad kan inte anpassas

  • Skärmen Uppdatera lösenord
  • Skapa en kontoskärm
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d