White Labels in der mobilen Adobe Learning Manager-App

Die mobile Adobe Learning Manager-App unterstützt jetzt die weiße Beschriftung, d. h., Sie können die App jetzt unter Ihrem eigenen Branding veröffentlichen.

Wie Sie mit der Vorbereitung auf den Start Ihrer App mit weißem Etikett beginnen sollten

Führen Sie die folgenden Schritte aus, um Ihre eigene App mit weißem Etikett bereitzustellen und zu verwalten:

Übersicht

White Labels sind eine Praxis, bei der Sie eine App oder einen Service mit Ihrem eigenen Branding umbenennen und so anpassen, als wären Sie der ursprüngliche Ersteller. In Adobe Learning Manager kannst du die Mobile App mit einer weißen Beschriftung versehen, sodass du ein Rebranding der App vornehmen und die App deinen Benutzern unter deinem eigenen Branding zur Verfügung stellen kannst.

Was kann angepasst werden

Folgende Elemente können angepasst werden:

Felder

<p>Konto-ID</p>

<p>Die ID Ihres Kontos. Beachten Sie, dass Teilnehmer, die zu einem anderen Konto gehören, nicht auf die App mit weißer Beschriftung zugreifen können.</p>

<p>Zusätzliche Konto-IDs</p>

<p>Fügen Sie bei Bedarf mehrere Konten (Unterdomänen) hinzu. Fügen Sie die Unterdomänen durch Kommas getrennt ohne Leerzeichen hinzu. Beispiel: acc01, acc02, acc03 usw.<br> <b>Hinweis:</b> Sie müssen die Konto-ID hinzufügen, wenn Sie die Unterdomänen angeben.</br> </p>

<p>App-Name</p></td>

<p>Der Name, den Sie für die App verwenden möchten.</p>

<p>App-Kurzname</p>

<p>Wenn der Name der App lang ist, geben Sie der App einen kurzen Namen, der auf dem Gerät angezeigt wird.</p>

<p>Name der internen App</p></td>

<p>Der Name, mit dem das Betriebssystem die App identifiziert. Üblicherweise wird das Format com.company-name.product-name verwendet.</p>

<p>Name der internen App - iOS</p>

<p>Benennen Sie die App anders, wenn sich Ihre Benutzer in iOS befinden. Es wird empfohlen, für iOS und Android denselben Namen zu verwenden.</p>

<p>App-Symbol</p>

<p>Das App-Symbol als png. Dieses Symbol wird in Ihrer App angezeigt. Das zu benennende Format ist account-id_appIcon.png. Die Abmessungen des App-Symbols sind 512 × 512 Pixel.<div>Bitte beachten Sie, dass Apple keinen Alpha-Kanal in App-Symbolen zulässt. Stellen Sie daher sicher, dass Sie den Alpha-Kanal aus dem Asset entfernen, bevor Sie es senden.</div></p>

<p>Startbildschirm der App</p></td>

<p>Geben Sie für den Begrüßungsbildschirm Ihrer App ein Bild (png) an, das angezeigt wird, wenn die Benutzer die App starten. Das zu benennende Format ist account-id_splashIcon.png. Die Abmessungen der quadratischen Splashscreens betragen 1052 × 1052 Pixel und der kreisförmigen Splashscreens 768 x 768 Pixel.</p>

<p>Client-ID und geheimer Clientschlüssel</p>

<p>Der Integrations-Admin Ihres Kontos stellt die Details bereit, während Sie die App registrieren. Der Integrationsadministrator muss Folgendes verwenden:<ul><li>Teilnehmer:lesen,Teilnehmer:als Rolle schreiben</li><li>Interne App name://redirect als Umleitungs-URL</li></ul></p>

<p>Kontenlogo</p>

<p>Die URL, über die das Logo Ihres Unternehmens gehostet wird. Geben Sie einen cpcontents-Link als Logo für das Konto an. Die URL muss webcodiert sein.</p>

<p>App Store-ID für die App (iOS)</p>

<p>Die für die Implementierung der Force-Aktualisierung erforderliche ID. Die App muss wissen, dass der Teilnehmer zum App Store weitergeleitet werden sollte, um die App zu aktualisieren.</p>

<p>Google Play Store-ID für die App (Android)</p>

<p>Die für die Implementierung der Force-Aktualisierung erforderliche ID.</p>

<p>Hostname für Deep-Linking</p>

<p>Um Ihre Deep Links zu hosten, verwenden Sie den Learning Manager. Wenn Sie eine andere URL für den Hostnamen als Deep-Link verwenden möchten, geben Sie die URL des Hosts an. Beispiel: learningmanager.adobe.com.</p>

Sitezuordnung zur Verarbeitung benutzerdefinierter Deplinks aktualisieren

Wenn Sie eine benutzerdefinierte Domäne oder einen Learning Manager*.adobe.com als Veranstalter verwenden, müssen Sie nichts unternehmen. Wenn Sie jedoch eine benutzerdefinierte Lösung oder einen bestimmten Hostnamen für die URLs verwenden, fügen Sie die Site-Zuordnungsdateien hinzu.

Weitere Informationen finden Sie unter den folgenden Links:

Push-Benachrichtigungen generieren

Das Senden von Push-Benachrichtigungen an Android- und iOS-Apps erfordert zwei verschiedene Mechanismen.

Befolgen Sie die folgenden Anweisungen, um die Projekte in Firebase einzurichten:

Push-Benachrichtigungen in iOS

Bei der Entwicklung von iOS-Anwendungen ist ein Push-Benachrichtigungszertifikat ein von Apple ausgestelltes kryptografisches Anmeldezertifikat, mit dem ein Server Push-Benachrichtigungen über die Push-Benachrichtigungsdienste (APNs) von Apple sicher an ein iOS-Gerät senden kann.

Das Zertifikat stellt eine sichere Kommunikation zwischen Ihrem Server (oder Anbieter) und den APNs von Apple sicher, wenn Push-Benachrichtigungen an iOS-Geräte gesendet werden.

Sowohl Android als auch iOS verwenden Firebase Cloud Messaging (FCM) als Dienst für das Senden von Push-Benachrichtigungen an Geräte.

So generieren Sie das Zertifikat in iOS

Gehen Sie folgendermaßen vor:

- 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

Wenn Sie eine Verbindung zum Server herstellen können, ist das von Ihnen erstellte Zertifikat gültig. Kopieren Sie aus der Datei myapnappkey.pem die Werte für das Zertifikat und den privaten Schlüssel.

Push-Benachrichtigungen unter Android

Für Android muss der Benutzer die Datei services.json aus dem Firebase-Projekt bereitstellen, um den Eintrag zum SNS-Dienst hinzuzufügen.

Erstellen Sie ein Projekt in Firebase und geben Sie die Datei services.json für das CSM-Team frei. Diese Datei wird für den tokenbasierten Eintrag im SNS benötigt. Beachten Sie, dass der Serverschlüssel nicht mehr verwendet wird. Siehe Projekt in Firebase erstellen.

Führen Sie die folgenden Schritte aus, um die Datei services.json herunterzuladen:

Wenden Sie sich an das CSM-Team und geben Sie die JSON-Datei frei, um den Eintrag den SNS-Diensten in AWS hinzuzufügen. Benutzer müssen den Eintrag für die Push-Benachrichtigung im SNS-Dienst registrieren lassen, sodass sie die oben generierten Zertifikate für die Validierung freigeben müssen.

Erstellen eines Projekts in Firebase create-project-in-firebase

Android

Verwenden Sie dasselbe Projekt, das Sie in den Schritten oben erstellt haben, für Push-Benachrichtigungen erneut.

Fügen Sie das Projektin Firebase hinzu, und rufen Sie die Datei google-services.json ab.

iOS

Fügen Sie das Projektzu Firebase hinzu, und rufen Sie die Datei GoogleService-Info.plist ab.

Signierte Binärdateien generieren

iOS

Der Ordner <root> enthält die Datei Runner.xcarchive.zip. Führen Sie die folgenden Befehle aus, um die signierte Binärdatei zu generieren:

Wenn das Gerät im Bereitstellungsprofil enthalten ist, sollte die Installation auf dem Gerät fortgesetzt werden.

Android

Für APK-Datei

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 eine ABB-Datei

Der Play Store erfordert für die Veröffentlichung Android-Binärdateien im arabischen Format. Daher stellen wir die nicht signierte .aab-Datei zur Verfügung.

Führen Sie die folgenden Schritte aus, um die .aab-Datei zu signieren:

Führen Sie den folgenden Befehl aus:

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

Wenn Sie dazu aufgefordert werden, geben Sie die folgenden Kennwörter ein:

Sie können die bereitgestellte App verwenden. Wenn Sie jedoch eine APK aus einer AB-Datei generieren müssen, führen Sie folgende Schritte aus:

Führen Sie den folgenden Befehl aus, um die apk-Datei zu erstellen:

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

Führen Sie den folgenden Befehl aus, um die Datei zu entpacken:

unzip my_app.apks -d output_dir

Sie erhalten die apk-Datei aus dem Ordner output_dir.

Nächste Schritte

Übertragen Sie die Binärdateien nach dem Generieren der Binärdateien in den Play Store oder in App Store.

Wie werden die Änderungen angewendet?

Sendet die erforderlichen Elemente und Dateien an das CSM-Team. Das CSM-Team füllt dann das Formular mit den erforderlichen Änderungen aus und hängt die erforderlichen Assets an. Das Team überprüft dann die Änderungen und informiert die technischen Teams darüber. Das Engineering-Team generiert dann einen Build und gibt diesen an das CSM-Team weiter.

Das CSM-Team gibt die Version für den Kunden frei.

Was nicht angepasst werden kann