Witte labels in de mobiele app van Adobe learning Manager

De mobiele Adobe Learning Manager-app ondersteunt nu witte labels, wat betekent dat u de app nu kunt vrijgeven onder uw eigen branding.

Hoe je je voorbereidt om je wit gelabelde app te starten

Voer de volgende stappen uit om uw eigen witte app met labels te implementeren en te beheren:

  1. Bereid de elementen voor (zoals een afbeelding op het welkomstscherm) en de tekst zodat deze beide kunnen worden gebruikt in de app en de beschrijving in de app/play store.

  2. Wijs een technische hulpbron toe die in staat is om:

    • Certificaatbestanden voor pushmeldingen genereren.
    • De app-binaire bestanden van het ALM-team ondertekenen.
    • Uploaden en het publicatieproces beheren. Het publicatieproces vereist communicatie tussen uw app-manager en app/play store-teams dat uw app voldoet aan alle publicatierichtlijnen. Vanuit ALM ontvangt u een volledig compatibele binaire app.

Overzicht

Wit labelen is een praktijk waarbij u een app of service opnieuw brandt met uw eigen merk en deze aanpast alsof u de oorspronkelijke maker bent. In Adobe Learning Manager kunt u witte labels toepassen op de mobiele app, zodat u de app een nieuw merk kunt geven en de app onder uw eigen merk beschikbaar kunt maken voor uw gebruikers.

Wat kan worden aangepast

U kunt het volgende aanpassen:

Velden

code language-none
<p>Account-id</p>
code language-none
<p>De id van uw account. Let op: de witte gelabelde app is niet toegankelijk voor studenten die tot een ander account behoren.</p>
code language-none
<p>Aanvullende account-id's</p>
code language-none
<p>Voeg desgewenst meerdere accounts (subdomeinen) toe. Voeg de subdomeinen toe als komma's gescheiden zonder spaties. Bijvoorbeeld acc01,acc02,acc03 enzovoort.<br> <b>Opmerking:</b> U moet de account-id toevoegen wanneer u de subdomeinen opgeeft.</br> </p>
code language-none
<p>Toepassingsnaam</p></td>
code language-none
<p>De naam die u voor de app wilt gebruiken.</p>
code language-none
<p>Korte naam app</p>
code language-none
<p>Als de naam van de app lang is, geeft u de app een korte naam die op het apparaat wordt weergegeven.</p>
code language-none
<p>Interne toepassingsnaam</p></td>
code language-none
<p>De naam waarmee het besturingssysteem de app identificeert. Meestal wordt de volgende indeling gebruikt: com.company-name.product-name.</p>
code language-none
<p>Interne toepassingsnaam-iOS</p>
code language-none
<p>Geef de app een andere naam als uw gebruikers zich op iOS bevinden. We raden u aan dezelfde naam te gebruiken voor zowel iOS als Android.</p>
code language-none
<p>App-pictogram</p>
code language-none
<p>Het app-pictogram als png. Dit pictogram wordt weergegeven in uw app. De naamnotatie is account-id_appIcon.png. De afmetingen van het app-pictogram zijn 512 x 512 pixels.</p>
code language-none
<p>App-welkomstscherm</p></td>
code language-none
<p>Geef voor het welkomstscherm van uw app een afbeelding (png) op die wordt weergegeven wanneer uw gebruikers de app starten. De naamnotatie is account-id_splashIcon.png. De afmetingen van de op vierkant gebaseerde welkomstschermen zijn 1052 × 1052 pixels en de cirkelvormige welkomstschermen zijn 768 x 768 pixels.</p>
code language-none
<p>Client-id en clientgeheim</p>
code language-none
<p>De integratiebeheerder van uw account geeft de gegevens op tijdens de registratie van de app. De integratiebeheerder moet het volgende gebruiken:<ul><li>student:lezen,student:schrijven als rol</li><li>interne app name://redirect als redirect URL</li></ul></p>
code language-none
<p>Accountlogo</p>
code language-none
<p>De URL die het logo van uw organisatie host. Geef een link naar inhoud op als het accountlogo. De URL moet via webcodering worden gecodeerd.</p>
code language-none
<p>App Store-id voor de app (iOS)</p>
code language-none
<p>De id die is vereist voor het implementeren van de geforceerde update. De app moet weten dat de student moet worden omgeleid naar de App Store om de app bij te werken.</p>
code language-none
<p>Google Play Store-id voor de app (Android)</p>
code language-none
<p>De id die is vereist voor het implementeren van de geforceerde update.</p>
code language-none
<p>Hostnaam voor deep linking</p>
code language-none
<p>Gebruik Learningmanager om uw diepe koppelingen te hosten. Geef de URL van de host op als u een andere hostnaam-URL wilt gebruiken als een diepe koppeling. Bijvoorbeeld learningmanager.adobe.com.</p>
NOTE
Geef de gegevens op aan uw CSAM's, zodat ze deze kunnen toevoegen aan uw aangepaste binaire toepassingscode.

Koppeling naar sites bijwerken om aangepaste diepte te verwerken

Als u een aangepast domein of leermanager als host gebruikt, hoeft u geen actie te ondernemen. Als u echter een aangepaste oplossing of een specifieke hostnaam voor de URL's gebruikt, voegt u de sitegekoppelde bestanden toe.

CAUTION
Als de bestanden niet aanwezig zijn, werken de vervormingen niet. Zorg ervoor dat de bestanden aanwezig zijn.

Raadpleeg de volgende koppelingen voor meer informatie:

Pushmeldingen genereren

Voor het verzenden van pushmeldingen naar Android- en iOS-apps zijn twee verschillende mechanismen vereist.

  • Voor iOS genereert u de certificaten voor pushmeldingen.
  • Geef voor Android een serversleutel op die is gegenereerd uit het Firebase-project.

Volg de onderstaande instructies om de projecten in Firebase in te stellen:

Pushmeldingen op iOS

In de ontwikkeling van een iOS-app is een certificaat voor pushmeldingen een cryptografische referentie die door Apple is uitgegeven waarmee een server op een veilige manier pushmeldingen naar een iOS-apparaat kan verzenden via APN's (Apple Push Notification service).

Het certificaat zorgt voor een veilige communicatie tussen uw server (of provider) en Apple APNs bij het verzenden van pushberichten naar iOS-apparaten.

Zowel Android als iOS gebruiken Firebase Cloud Messaging (FCM) als service voor het verzenden van pushmeldingen naar apparaten.

Het certificaat genereren op iOS

Volg de procedure:

  1. Genereer of download de Pushmeldingscertificaat en persoonlijke sleutel (.p12). Zie de klasse Apple-document voor ontwikkelaars.

  2. Installeer het p12-bestand nadat het bestand is gedownload. Gebruik het wachtwoord om in uw Sleutelhangertoegang.

  3. Navigeer naar Mijn certificaten en exporteer het certificaat. Zorg ervoor dat u het mime-type .cer selecteert.

  4. Zodra u het p12-bestand en het cer-bestand beschikbaar hebt, voert u de volgende opdrachten uit:

- 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

Als u verbinding kunt maken met de server, is het certificaat dat u hebt gemaakt geldig. Kopieer het certificaat en de waarden voor de persoonlijke sleutel uit het bestand myapnappkey.pem.

Pushmeldingen op Android

Voor Android moet de gebruiker het bestand services.json uit het Firebase-project leveren om de vermelding toe te voegen aan de SNS-service.

Maak een project in Firebase en deel het bestand services.json met het CSM-team. Dit dossier is nodig voor op token-gebaseerde ingang in SNS. De serversleutel wordt niet meer gebruikt. Zie Project maken in Firebase.

Ga als volgt te werk om het bestand services.json te downloaden:

  1. Meld u aan bij de Firebase console.

  2. Ga naar Projectinstellingen en selecteer Cloud Messaging.

  3. Zoeken Firebase Cloud Messaging API en selecteer Serviceaccounts beheren.

  4. In het dialoogvenster Serviceaccounts pagina selecteert u de Serviceaccounts in het linkerdeelvenster.

  5. Zoek uw projectitem en selecteer Details beheren onder handelingen.

    note note
    NOTE
    De indeling voor het invoeren van projecten is <-accountnaam->@appspot.gserviceaccount.com.
  6. Ga naar de Toetsen tab en selecteer Sleutel toevoegen.

  7. Als er geen sleutel is, selecteert u Nieuwe sleutel maken en selecteer JSON als het toetstype. Hiermee wordt het JSON-bestand gegenereerd en gedownload.

  8. Als er al een sleutel is, selecteert u Bestaande sleutel uploaden plakken, de toets plakken en uploaden. Hiermee wordt het JSON-bestand gegenereerd en gedownload.

Neem contact op met het CSM-team en deel het JSON-bestand om de vermelding toe te voegen aan de SNS-services op AWS. Gebruikers moeten de vermelding bij de SNS-service laten registreren voor de pushmelding, waardoor ze de hierboven gegenereerde certificaten moeten delen voor validatie.

Project maken in Firebase create-project-in-firebase

Android

Hergebruik hetzelfde project dat u in de bovenstaande stappen hebt gemaakt voor pushmeldingen.

Het project toevoegen in Firebase en haalt het google-services.json bestand.

iOS

Het project toevoegen naar Firebase en haalt de GoogleService-Info.plist bestand.

IMPORTANT
Verzend de bestanden naar het Adobe Learning Manager CSAM-team om de bestanden op te nemen voor de build van uw binaire bestand voor de app.

De ondertekende binaire bestanden genereren

iOS

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

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
U hebt XCode 15.2 of hoger nodig om de ondertekende binaire bestanden te maken.

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
U hebt Android SDK-hulpprogramma's nodig om de ondertekende binaire bestanden te maken.

Volgende stappen

Nadat u de binaire bestanden hebt gegenereerd, drukt u de binaire bestanden naar de Play Store of App Store.

Hoe pas ik de wijzigingen toe

Verzendt de vereiste middelen en bestanden naar het CSM-team. Het CSM-team vult vervolgens de formulier met de vereiste wijzigingen en voegt de vereiste elementen als bijlage toe. Het team zal dan de technische teams van de veranderingen evalueren en informeren. Het technische team genereert vervolgens een build en deelt deze met het CSM-team.

Het CSM-team zal de build met de klant delen.

Wat kan niet worden aangepast

  • Scherm Wachtwoord bijwerken
  • Een accountscherm maken
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d