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

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

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

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

概要

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

カスタマイズ可能な項目

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

フィールド

<p>アカウントID</p>

<p>アカウントのID。 他のアカウントに属する学習者は、白いラベルのアプリにアクセスできません。</p>

<p>追加のアカウントId</p>

<p>必要に応じて、複数のアカウント（サブドメイン）を追加します。 サブドメインをスペースなしでコンマ区切りとして追加します。 たとえば、 acc01、acc02、acc03などです。<br> <b>注意：</b>サブドメインを指定するときは、アカウントIDを追加する必要があります。</br> </p>

<p>アプリ名</p></td>

<p>アプリに使用する名前です。</p>

<p>アプリの短い名前</p>

<p>アプリ名が長い場合は、デバイスに表示される短い名前をアプリに付けます。</p>

<p>内部アプリ名</p></td>

<p>OSがアプリを識別するために使用する名前です。 通常使用される形式は、 com.company-name.product-nameです。</p>

<p>内部アプリ名 – iOS</p>

<p>ユーザーがiOSを使用している場合は、アプリに別の名前を付けてください。 iOSとAndroidの両方に同じ名前を使用することをお勧めします。</p>

<p>アプリアイコン</p>

<p>アプリアイコンをpngに変換します。 このアイコンはアプリに表示されます。 名前の形式はaccount-id_appIcon.pngです。 アプリアイコンのサイズは512 × 512ピクセルです。<div>Appleのアプリアイコンでは、Alphaチャンネルを使用できません。 そのため、必ずアセットからAlphaチャンネルを削除してから送信してください。</div></p>

<p>アプリのスプラッシュ画面</p></td>

<p>アプリのスプラッシュ画面には、ユーザーがアプリを起動したときに表示される画像(png)を指定します。 名前の形式はaccount-id_splashIcon.pngです。 正方形ベースのスプラッシュ画面の寸法は1052×1052ピクセルであり、円ベースのスプラッシュ画面は768 x 768ピクセルである。</p>

<p>クライアントIDとクライアントシークレット</p>

<p>アプリの登録時に、アカウントの統合管理者が詳細を提供します。 統合管理者は、以下を使用する必要があります。<ul><li>学習者：読み取り，学習者：ロールとして書き込み</li><li>リダイレクトURLとしての内部アプリname://redirect</li></ul></p>

<p>アカウントロゴ</p>

<p>組織のロゴをホストするURL。 アカウントロゴとしてcpcontentsリンクを提供します。 URLはWebでエンコードする必要があります。</p>

<p>アプリのアプリストアID(iOS)</p>

<p>強制更新の実装に必要なIDです。 アプリを更新するには、学習者をアプリストアにリダイレクトする必要があることをアプリに伝える必要があります。</p>

<p>アプリのGoogle playストアID(Android)</p>

<p>強制更新の実装に必要なIDです。</p>

<p>ディープリンクのホスト名</p>

<p>ディープリンクをホストするには、learningmanagerを使用します。 別のホスト名URLをディープリンクとして使用する場合は、ホストのURLを指定します。 例えば、learningmanager.adobe.comのように入力します。</p>

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

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

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

プッシュ通知の生成

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

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

iOSでのプッシュ通知

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

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

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

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

以下の手順に従います。

- 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ファイルをダウンロードするには、次の手順に従います。

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

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

Android

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

プロジェクトをFirebaseに追加し、google-services.json ​ファイルを取得します。

iOS

プロジェクトをFirebaseに追加し、GoogleService-Info.plist ​ファイルを取得します。

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

iOS

<root>フォルダーには、Runner.xcarchive.zip ​ファイルが含まれています。 次のコマンドを実行して、署名されたバイナリを生成します。

デバイスがプロビジョニングプロファイルに含まれている場合は、デバイス上でインストールが続行されます。

Android

APKファイルの場合

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

aabファイルの場合

Playストアでは、公開するためにaab形式のAndroidバイナリが必要です。 したがって、署名されていない.aabファイルを提供します。

.aabファイルに署名するには、次の手順を実行します。

次のコマンドを実行します。

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

プロンプトが表示されたら、次のパスワードを入力してください。

付属のapkを使用できます。 ただし、aabファイルからapkを生成する必要がある場合は、次の手順に従います。

次のコマンドを実行して、apkファイルを作成します。

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

ファイルを解凍するには、次のコマンドを実行します。

unzip my_app.apks -d output_dir

output_dir ​フォルダーからapkファイルを取得します。

次のステップ

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

変更を適用する方法

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

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

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