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.<div>Observera att Apple inte tillåter Alpha-kanal i appikoner. Se därför till att ta bort Alpha-kanalen från mediefilen innan du skickar in den.</div></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

Mappen <root> innehåller filen Runner.xcarchive.zip. Kör kommandona nedan för att generera den signerade binärfilen:

  1. Kör följande kommando för att packa upp arkivet:

    code language-none
    unzip Runner.xcarchive.zip
    
  2. Gå till programkatalogen:

    code language-none
    cd Runner.xcarchive/Products/Applications/Runner.app
    
  3. Kopiera etableringsfilen för mobil:

    code language-none
    cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision
    
  4. Gå tillbaka till mappen <root> (där Runner.xcarchive.zip finns):

    code language-none
    cd <root>
    
  5. Exportera arkivet med xcodebuild:

    code language-none
    xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist
    
  6. Leta reda på .ipa-filen i mappen ipa_path.

  7. Överför .ipa-filen till webbplatsen Diawi.

  8. När det är helt uppladdat väljer du knappen Send.

  9. När det är klart får du en QR-kod och en länk.

  10. Öppna QR-koden eller länken direkt i Safari.

Om enheten ingår i etableringsprofilen ska installationen fortsätta på enheten.

NOTE
Du behöver XCode 15.2 eller senare för att skapa de signerade binärfilerna.

Android

För apk-filen

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 """

För aab-filen

NOTE
Du behöver verktyg för Android SDK för att bygga de signerade binärfilerna.

Play Store kräver Android-binärfiler i aab-format för publicering. Därför tillhandahåller vi den osignerade .aab-filen.

NOTE
När du skapar en keystore-fil måste du generera ett keystore-lösenord, ett alias för signeringsnyckel och ett lösenord för signeringsnyckel.

Följ proceduren nedan för att signera .aab-filen:

Kör följande kommando:

<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>
NOTE
jarsigner ingår i Java. Se till att du använder Java 21.

Ange följande lösenord när du uppmanas till det:

  • Keystore-lösenord
  • lösenord för signeringsnyckelalias

Du kan använda den medföljande appen. Men om du behöver generera en apk från en aab-fil, följ dessa steg:

NOTE
Du måste installera bundletool för att generera APK:er.

Kör följande kommando för att skapa apk-filen:

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

Packa upp filen med följande kommando:

unzip my_app.apks -d output_dir

Du hämtar apk-filen från mappen output_dir.

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