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.

ALM kommer att göra tillgängliga uppdaterade vita märkta binära filer enligt följande tidslinjer:

Binärfiler görs tillgängliga i kundens utsedda mappar. Kontakta dina CSM:er för att få åtkomst till filerna. Kunden ansvarar för publicering i rätt tid och relaterade processer.

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:

Ö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

<p>Konto-ID</p>

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

<p>Ytterligare konto-ID</p>

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

<p>Programnamn</p></td>

<p>Namnet som du vill använda för appen.</p>

<p>Kortnamn för app</p>

<p>I fall där namnet på appen är långt ska du ge den ett kort namn som visas på enheten.</p>

<p>Internt programnamn</p></td>

<p>Namnet som operativsystemet identifierar programmet med. Det format som vanligtvis används är: com.company-name.product-name.</p>

<p>Internt programnamn - iOS</p>

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

<p>Appikon</p>

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

<p>Appstartskärm</p></td>

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

<p>Klient-ID och Klienthemlighet</p>

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

<p>Kontologotyp</p>

<p>Den URL som är värd för organisationens logotyp. Ange en cpcontent-länk som kontologotyp. Webbadressen måste vara webbkodad.</p>

<p>Appbutikens ID för appen (iOS)</p>

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

<p>Google Play Store-id för appen (Android)</p>

<p>Det ID som krävs för att implementera force-uppdateringen.</p>

<p>Värdnamn för djuplänkning</p>

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

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.

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

Skaffa ett team-id till App Store

För att få ditt team-id:

Detta ID krävs för att lägga till den vita märkta programposten i metadatafilerna för att aktivera djuplänkning.

Skaffa SHA-256-fingeravtrycket för Android

SHA-256-fingeravtrycket för Android-signeringscertifikatet krävs när appposten med vit etikett läggs till.

Så här genererar du SHA-256-fingeravtryck:

keytool -list -v -keystore <keystore/jks file> -alias <aliaskey> -storepass <storepassword> -keypass <keypassword>

Leta reda på Certifikatfingeravtryck i utdata och kopiera sedan SHA-256-värdet. Dela det här fingeravtrycket efter behov för konfigurationen för djuplänkning.

Generera push-meddelanden

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

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:

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

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.

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:

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

Android

För apk-filen

export KS_PASS=your_keystore_password
export KEY_PASS=your_key_password

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

För aab-filen

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

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>

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

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:

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.

Skicka apparna till butiken för granskning

När du har skaffat de sista binärfilerna kan du ladda upp dem till respektive appbutiker (iOS eller Android) för granskning. Följ de här stegen för att överföra binärfilerna till appbutikerna.

iOS

Android

Användbara länkar för apppublicering

Android

Skapa och konfigurera appen
Förbered programmet för granskning

iOS

Skicka för granskning

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