Witte labels in de mobiele app van Adobe learning Manager

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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:

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

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> Nota:</b> u moet accountidentiteitskaart toevoegen wanneer het specificeren van sub-domeinen.</br> </p>`

<p>Voeg desgewenst meerdere accounts (subdomeinen) toe. Voeg de subdomeinen toe als komma's gescheiden zonder spaties. Bijvoorbeeld acc01,acc02,acc03 enzovoort.<br> <b> Nota:</b> u moet accountidentiteitskaart toevoegen wanneer het specificeren van sub-domeinen.</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

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.<div>Houd er rekening mee dat Apple Alpha in app-pictogrammen niet toestaat. Verwijder dus het kanaal van de Alpha uit het element voordat u het verzendt.</div></p>`

<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.<div>Houd er rekening mee dat Apple Alpha in app-pictogrammen niet toestaat. Verwijder dus het kanaal van de Alpha uit het element voordat u het verzendt.</div></p>

code language-none
`<p>App-welkomstscherm</p></td>`

code language-none

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

<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

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

<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

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

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

Android
iOS

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:

Genereer of download het Push meldingscertificaat en privé sleutel (.p12). Voor meer informatie, zie het document van de ontwikkelaar van Apple.
Installeer het p12-bestand nadat het bestand is gedownload. Gebruik het wachtwoord in uw toegang Keychain te installeren.
Navigeer aan Mijn certificaten en voer het certificaat uit. Zorg ervoor dat u het mime-type .cer selecteert.
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 in Vuurbasiscreëren.

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

Login aan de console van het Vuurwerk.
Ga naar montages van het Project en selecteer het Overseinen van de Wolk.
Vind het Overseinen API van de Wolk van de Wolk van de Vuurstand en selecteer leiden de Rekeningen van de Dienst.
In de pagina van de Rekening van de Dienst, selecteer de Rekeningen van de Dienst in het linkerpaneel.

Vind uw projectingang, en selecteer leiden details onder acties.

note note
NOTE
De indeling voor het invoeren van projecten is <-accountnaam->@appspot.gserviceaccount.com.

Ga naar het lusje van Sleutels en selecteer Sleutel toevoegen.
Als er geen sleutel is, creeer nieuwe sleutel en selecteer JSON als zeer belangrijk type. Hiermee wordt het JSON-bestand gegenereerd en gedownload.
Als er reeds een sleutel is, uitgezochte upload bestaande sleutel, kleef de sleutel, en upload het. 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.

voeg het projectin Vuurbasis toe en wint het {dossier 2} google-services.json terug.

iOS

voeg het projectaan Firebase toe en wint het {dossier 2} GoogleService-Info.plist terug.

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

De <root> omslag bevat het {dossier 1} Runner.xcarchive.zip. Voer de onderstaande opdrachten uit om het ondertekende binaire getal te genereren:

Voer de volgende opdracht uit om het archief te decomprimeren:

code language-none
`unzip Runner.xcarchive.zip`

Navigeer naar de map met apps:

code language-none
`cd Runner.xcarchive/Products/Applications/Runner.app`

Kopieer het mobiele inrichtingsbestand:

code language-none
`cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision`

Ga terug naar de map <root> (waar Runner.xcarchive.zip zich bevindt):

code language-none
`cd <root>`

Het archief exporteren met Xcodebuild:

code language-none
`xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist`

Zoek het .ipa-bestand in de map ipa_path.
Upload het .ipa-bestand naar de Diawi -website.
Zodra volledig geupload, selecteer verzend knoop.
Na voltooiing, zult u een QR code en een verbinding ontvangen.
Open de QR-code of de koppeling rechtstreeks in Safari.

Als het apparaat is opgenomen in het inrichtingsprofiel, moet de installatie op het apparaat worden uitgevoerd.

NOTE

U hebt XCode 15.2 of hoger nodig om de ondertekende binaire bestanden te maken.

Android

voor apk- dossier

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

voor aab dossier

NOTE

U hebt Android SDK-hulpprogramma's nodig om de ondertekende binaire bestanden te maken.

De Play Store vereist voor publicatie Android-binaire bestanden in de tabbladindeling. Daarom zullen wij het niet ondertekende .aab dossier verstrekken.

NOTE

Wanneer u een sleutelarchiefbestand maakt, moet u een keystore-wachtwoord, een alias voor de ondertekeningssleutel en een aliaswachtwoord voor de ondertekeningssleutel genereren.

Volg de onderstaande stappen om het Ab-bestand te ondertekenen:

Voer de volgende opdracht uit:

<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>

NOTE

jarsigner is inbegrepen met Java. Zorg ervoor dat u Java 21 gebruikt.

Voer bij de aanwijzing de volgende wachtwoorden in:

Wachtwoord sleutelarchief
wachtwoord voor het ondertekenen van sleutelalias

U kunt de meegeleverde apk gebruiken. Als u echter een apk wilt genereren op basis van een abb-bestand, voert u de volgende stappen uit:

NOTE

U zult bundletool moeten installeren om APKs te produceren.

Voer de volgende opdracht uit om het apk-bestand te maken:

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

Als u het bestand wilt uitpakken, voert u de volgende opdracht uit:

unzip my_app.apks -d output_dir

U zult het apk dossier van de output_dir omslag krijgen.

Wat is volgende

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 team CSM vult dan de vormmet de vereiste veranderingen en maakt de vereiste activa vast. 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