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:

  1. Bereiten Sie die Elemente (z. B. ein Startbildschirmbild) und den Text so vor, dass beide in der App und in der Beschreibung im App-/Play-Store verwendet werden können.

  2. Weisen Sie eine technische Ressource zu, die Folgendes kann:

    • Push-Benachrichtigungszertifikatdateien werden generiert.
    • Signieren der vom ALM-Team bereitgestellten Anwendungsbinärdateien.
    • Hochladen und Verwalten des Veröffentlichungsprozesses. Der Veröffentlichungsprozess erfordert die Kommunikation zwischen Ihrem App-Manager und den Teams im App/Play Store, sodass Ihre App alle Veröffentlichungsrichtlinien erfüllt. Von ALM erhalten Sie eine vollständig kompatible App-Binärdatei.

Ü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

code language-none
<p>Konto-ID</p>
code language-none
<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>
code language-none
<p>Zusätzliche Konto-IDs</p>
code language-none
<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>
code language-none
<p>App-Name</p></td>
code language-none
<p>Der Name, den Sie für die App verwenden möchten.</p>
code language-none
<p>App-Kurzname</p>
code language-none
<p>Wenn der Name der App lang ist, geben Sie der App einen kurzen Namen, der auf dem Gerät angezeigt wird.</p>
code language-none
<p>Name der internen App</p></td>
code language-none
<p>Der Name, mit dem das Betriebssystem die App identifiziert. Üblicherweise wird das Format com.company-name.product-name verwendet.</p>
code language-none
<p>Name der internen App - iOS</p>
code language-none
<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>
code language-none
<p>App-Symbol</p>
code language-none
<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.</p>
code language-none
<p>Startbildschirm der App</p></td>
code language-none
<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>
code language-none
<p>Client-ID und geheimer Clientschlüssel</p>
code language-none
<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>
code language-none
<p>Kontenlogo</p>
code language-none
<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>
code language-none
<p>App Store-ID für die App (iOS)</p>
code language-none
<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>
code language-none
<p>Google Play Store-ID für die App (Android)</p>
code language-none
<p>Die für die Implementierung der Force-Aktualisierung erforderliche ID.</p>
code language-none
<p>Hostname für Deep-Linking</p>
code language-none
<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>
NOTE
Geben Sie die Daten an Ihre CSAMs weiter, damit sie sie in Ihre benutzerdefinierte App-Binärdatei einfügen können.

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.

CAUTION
Wenn die Dateien nicht vorhanden sind, funktionieren die Deeplinks nicht. Stellen Sie sicher, dass die Dateien vorhanden sind.

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.

  • Generieren Sie für iOS die Push-Benachrichtigungszertifikate.
  • Geben Sie für Android einen aus dem Firebase-Projekt generierten Serverschlüssel an.

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:

  1. Generieren oder Herunterladen der Push-Benachrichtigungszertifikat und dem privaten Schlüssel (.p12). Weitere Informationen finden Sie unter Apple-Entwicklerdokument.

  2. Installieren Sie die p12-Datei, nachdem die Datei heruntergeladen wurde. Verwenden Sie das Kennwort, um in Ihrem Schlüsselbundzugriff.

  3. Navigieren Sie zu Meine Zertifikate und exportieren Sie das Zertifikat. Stellen Sie sicher, dass Sie den MIME-Typ ".cer" auswählen.

  4. Sobald Sie die p12-Datei und die cer-Datei verfügbar haben, führen Sie die folgenden Befehle aus:

- 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 Erstellen eines Projekts in Firebase.

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

  1. Melden Sie sich bei der Firebase Konsole.

  2. Wechseln zu Projekteinstellungen und wählen Sie Cloud Messaging.

  3. Suchen Firebase Cloud Messaging-API und wählen Sie Verwalten von Dienstkonten.

  4. Im Dialogfeld " Service-Konten " die Option Dienstkonten im linken Bereich.

  5. Suchen Sie Ihren Projekteintrag und wählen Sie Details verwalten in Aktionen.

    note note
    NOTE
    Das Projekteintragsformat lautet <-accountname->@appspot.gserviceaccount.com.
  6. Wechseln Sie zur Registerkarte Tasten und wählen Sie Schlüssel hinzufügen.

  7. Wenn keine Taste vorhanden ist, wählen Sie Neuen Schlüssel erstellen und wählen Sie JSON als Schlüsseltyp fest. Dadurch wird die JSON-Datei generiert und heruntergeladen.

  8. Wenn bereits ein Schlüssel vorhanden ist, wählen Sie Vorhandenen Schlüssel hochladen, fügen Sie den Schlüssel ein und laden Sie ihn hoch. Dadurch wird die JSON-Datei generiert und heruntergeladen.

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.

Projekt hinzufügen in Firebase und rufen Sie die google-services.json -Datei.

iOS

Projekt hinzufügen zu Firebase und rufen Sie die GoogleService-Info.plist -Datei.

IMPORTANT
Senden Sie die Dateien an das Adobe Learning Manager CSAM-Team, damit sie in den Build der Binärdatei Ihrer App aufgenommen werden.

Signierte Binärdateien generieren

iOS

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

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
Sie benötigen XCode 15.2 oder höher, um die signierten Binärdateien zu erstellen.

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
Zum Erstellen der signierten Binärdateien benötigen Sie die SDK-Build-Tools von Android.

Was kommt als Nächstes?

Ü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 die Form mit den erforderlichen Änderungen und fügt 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

  • Bildschirm "Kennwort aktualisieren"
  • Seite "Konto erstellen"
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d