AdobeのLearning Managerモバイルアプリでのホワイトラベル

Adobe Learning Managerモバイルアプリは、ホワイトラベルをサポートするようになりました。これにより、独自のブランディングでアプリをリリースできるようになりました。

白いラベルのアプリを起動する準備を開始する方法

独自の白いラベルのアプリをデプロイして管理するには、次の手順に従います。

  1. アセット(スプラッシュスクリーン画像など)とテキストを準備して、アプリとapp/playストアの説明の両方で使用できるようにします。

  2. 次の能力を持つ技術リソースを割り当てます。

    • プッシュ通知証明書ファイルを生成しています。
    • ALMチームが提供するアプリのバイナリに署名しています。
    • 公開プロセスをアップロードおよび管理しています。 公開プロセスでは、アプリマネージャーとアプリ/Playストアチームの間で、アプリがすべての公開ガイドラインに準拠していることを伝える必要があります。 ALMから、完全に準拠したアプリバイナリを受け取ります。

概要

ホワイトラベルとは、アプリやサービスのブランド名を変更し、元のクリエイターのようにカスタマイズする行為です。 Adobe Learning Managerでは、モバイルアプリにホワイトラベルを適用して、アプリのブランドを変更したり、自分のブランドの下でアプリを使用したりすることができます。

カスタマイズ可能な項目

以下をカスタマイズできます。

フィールド

code language-none
<p>アカウントID</p>
code language-none
<p>アカウントのID。 他のアカウントに属する学習者は、白いラベルのアプリにアクセスできません。</p>
code language-none
<p>追加のアカウントId</p>
code language-none
<p>必要に応じて、複数のアカウント(サブドメイン)を追加します。 サブドメインをスペースなしでコンマ区切りとして追加します。 たとえば、 acc01、acc02、acc03などです。<br> <b>注意:</b> サブドメインを指定する場合は、アカウントIDを追加する必要があります。</br> </p>
code language-none
<p>アプリ名</p></td>
code language-none
<p>アプリに使用する名前です。</p>
code language-none
<p>アプリの短い名前</p>
code language-none
<p>アプリ名が長い場合は、デバイスに表示される短い名前をアプリに付けます。</p>
code language-none
<p>内部アプリ名</p></td>
code language-none
<p>OSがアプリを識別するために使用する名前です。 通常使用される形式は、 com.company-name.product-nameです。</p>
code language-none
<p>内部アプリ名 – iOS</p>
code language-none
<p>ユーザーがiOSを使用している場合は、アプリに別の名前を付けてください。 iOSとAndroidの両方に同じ名前を使用することをお勧めします。</p>
code language-none
<p>アプリアイコン</p>
code language-none
<p>アプリアイコンをpngに変換します。 このアイコンはアプリに表示されます。 名前の形式はaccount-id_appIcon.pngです。 アプリアイコンのサイズは512 × 512ピクセルです。</p>
code language-none
<p>アプリのスプラッシュ画面</p></td>
code language-none
<p>アプリのスプラッシュ画面には、ユーザーがアプリを起動したときに表示される画像(png)を指定します。 名前の形式はaccount-id_splashIcon.pngです。 正方形ベースのスプラッシュ画面の寸法は1052×1052ピクセルであり、円ベースのスプラッシュ画面は768 x 768ピクセルである。</p>
code language-none
<p>クライアントIDとクライアントシークレット</p>
code language-none
<p>アプリの登録時に、アカウントの統合管理者が詳細を提供します。 統合管理者は、以下を使用する必要があります。<ul><li>学習者:読み取り,学習者:ロールとして書き込み</li><li>リダイレクトURLとしての内部アプリname://redirect</li></ul></p>
code language-none
<p>アカウントロゴ</p>
code language-none
<p>組織のロゴをホストするURL。 アカウントロゴとしてcpcontentsリンクを提供します。 URLはWebでエンコードする必要があります。</p>
code language-none
<p>アプリのアプリストアID(iOS)</p>
code language-none
<p>強制更新の実装に必要なIDです。 アプリを更新するには、学習者をアプリストアにリダイレクトする必要があることをアプリに伝える必要があります。</p>
code language-none
<p>アプリのGoogle playストアID(Android)</p>
code language-none
<p>強制更新の実装に必要なIDです。</p>
code language-none
<p>ディープリンクのホスト名</p>
code language-none
<p>ディープリンクをホストするには、learningmanagerを使用します。 別のホスト名URLをディープリンクとして使用する場合は、ホストのURLを指定します。 例えば、learningmanager.adobe.comのように入力します。</p>
NOTE
CSAMにデータを提供して、カスタマイズされたアプリバイナリに追加できるようにします。

カスタムディープリンクを処理するためのサイトの関連付けの更新

カスタムドメインまたはlearningmanager*.adobe.comをホストとして使用している場合は、何もする必要はありません。 ただし、URLにカスタムソリューションまたは特定のホスト名を使用する場合は、サイト関連付けファイルを追加します。

CAUTION
ファイルが存在しない場合、デプリンクは機能しません。 ファイルが存在することを確認します。

詳細については、次のリンクを参照してください。

プッシュ通知の生成

AndroidアプリとiOSアプリにプッシュ通知を送信するには、2つの異なるメカニズムが必要です。

  • iOSの場合、プッシュ通知証明書を生成します。
  • Androidの場合は、Firebaseプロジェクトから生成されたサーバーキーを提供します。

Firebaseでプロジェクトを設定するには、以下の手順に従います。

iOSでのプッシュ通知

iOSアプリの開発では、プッシュ通知証明書はAppleが発行する暗号化資格情報で、これによりサーバーはAppleのプッシュ通知サービス(APN)を介してiOSデバイスにプッシュ通知を安全に送信できます。

証明書は、iOSデバイスにプッシュ通知を送信する際に、サーバー(またはプロバイダー)とAppleのAPN間の安全な通信を保証します。

Android版とiOS版はどちらも、デバイスにプッシュ通知を送信するためのサービスとしてFirebase Cloud Messaging(FCM)を使用しています。

iOSで証明書を生成する方法

以下の手順に従います。

  1. 生成またはダウンロード プッシュ通知証明書 および秘密鍵(.p12)を渡します。 詳しくは、 Apple developer document.

  2. ファイルのダウンロードが完了したら、p12ファイルをインストールします。 パスワードを使用して キーチェーンアクセス.

  3. 移動先 自分の証明書 証明書をエクスポートします。 MIMEタイプとして.cerが選択されていることを確認します。

  4. p12ファイルとcerファイルが使用可能になったら、次のコマンドを実行します。

- 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

サーバーに接続できる場合は、作成した証明書が有効です。 myapnappkey.pemファイルから、証明書とプライベートキーの値をコピーします。

Androidでのプッシュ通知

Androidの場合、ユーザーはFirebaseプロジェクトからservices.jsonファイルを提供して、SNSサービスにエントリを追加する必要があります。

Firebaseでプロジェクトを作成し、 services.jsonファイルをCSMチームと共有します。 このファイルは、SNSのトークンベースのエントリに必要です。 サーバーキーはもう使用されていないことに注意してください。 詳しくはこちら Firebaseでのプロジェクトの作成.

services.jsonファイルをダウンロードするには、次の手順に従います。

  1. にログイン Firebase コンソール。

  2. に移動 プロジェクト設定 を選択します クラウドメッセージ.

  3. 検索 Firebase Cloud Messaging API を選択します サービスアカウントの管理.

  4. サービス回数 ページで、 サービスアカウント をクリックします。

  5. プロジェクトのエントリを検索し、 詳細を管理 「アクション」の下で

    note note
    NOTE
    プロジェクトエントリの形式は、<-accountname->@appspot.gserviceaccount.comになります。
  6. に移動 キー tabキーを押しながら選択 キーを追加.

  7. キーがない場合は、 新しいキーを作成 を選択します JSON をキーのタイプとして使用します。 これにより、JSONファイルが生成およびダウンロードされます。

  8. 既にキーがある場合は、 既存のキーをアップロード ​キーを貼り付けてアップロードします。 これにより、JSONファイルが生成およびダウンロードされます。

AWSでSNSサービスにエントリを追加するためのJSONファイルを共有する方法については、CSMチームにお問い合わせください。 ユーザーは、プッシュ通知のためにSNSサービスに登録されたエントリを取得する必要があります。これにより、上記で生成された証明書を検証のために共有することが求められます。

Firebaseでのプロジェクトの作成 create-project-in-firebase

Android

上記の手順で作成したのと同じプロジェクトをプッシュ通知に再利用します。

プロジェクトを追加 Firebaseで、 google-services.json ファイル。

iOS

プロジェクトを追加 をFirebaseに送信し、 GoogleService-Info.plist ファイル。

IMPORTANT
このファイルをAdobe Learning Manager CSAMチームに送り、アプリのバイナリファイルのビルドに含めます。

署名されたバイナリを生成する

iOS

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

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
署名されたバイナリをビルドするにはXCode 15.2以上が必要です。

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
署名されたバイナリをビルドするには、Android sdk build-toolsが必要です。

次へ

バイナリを生成したら、バイナリをPlayストアまたはApp Storeにプッシュします。

変更を適用する方法

必要なアセットとファイルをCSMチームに送信します。 CSMチームが 様式 必要な変更を加え、必要なアセットを添付します。 チームは、変更を確認し、エンジニアリングチームに通知します。 エンジニアリングチームがビルドを生成し、CSMチームと共有します。

CSMチームがお客様とビルドを共有します。

カスタマイズできない内容

  • パスワードの更新画面
  • アカウントの作成画面
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d