Adobe Learning Manager行動應用程式中的白色標籤

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

Adobe Learning Manager行動應用程式現在支援貼上白色標籤，這表示您現在可以使用自己的品牌發佈應用程式。

開始準備啟動標示為白色的應用程式的方法

若要部署和管理您自己的白色標籤應用程式，請遵循下列步驟：

準備資產（如啟動畫面影像）和文字，以便兩者都能在應用程式中使用和應用程式/播放商店上的說明。
指派技術資源，該資源應具備以下能力：
- 產生推播通知憑證檔案。
- 簽署ALM團隊提供的應用程式二進位檔。
- 上傳及管理發布程式。發佈程式需要應用程式管理員和應用程式/遊戲商店團隊溝通，確保應用程式符合所有發佈准則。從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

code language-none
`<p>您可視需要新增多個帳戶（子網域）。將子網域新增為逗號分隔（不含空格）。例如，acc01、acc02、acc03等。<br> <b>注意：</b>指定子網域時，您必須新增帳戶識別碼。</br> </p>`

<p>您可視需要新增多個帳戶（子網域）。 將子網域新增為逗號分隔（不含空格）。 例如，acc01、acc02、acc03等。<br> <b>注意：</b>指定子網域時，您必須新增帳戶識別碼。</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>作業系統用來識別應用程式的名稱。通常使用的格式是： 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

code language-none
`<p>應用程式圖示為png。此圖示會顯示在您的應用程式上。名稱的格式為account-id_appIcon.png。應用程式圖示的尺寸為512 × 512畫素。<div>請注意，Apple不允許在應用程式圖示中使用Alpha頻道。因此，在提交之前，請務必從資產中移除Alpha管道。</div></p>`

<p>應用程式圖示為png。 此圖示會顯示在您的應用程式上。 名稱的格式為account-id_appIcon.png。 應用程式圖示的尺寸為512 × 512畫素。<div>請注意，Apple不允許在應用程式圖示中使用Alpha頻道。 因此，在提交之前，請務必從資產中移除Alpha管道。</div></p>

code language-none
`<p>應用程式啟動畫面</p></td>`

code language-none

code language-none
`<p>針對應用程式的啟動畫面，提供使用者啟動應用程式時顯示的影像(png)。名稱的格式為account-id_splashIcon.png。方形啟動顯示熒幕的尺寸為1052 × 1052畫素，圓形啟動顯示熒幕的尺寸為768 x 768畫素。</p>`

<p>針對應用程式的啟動畫面，提供使用者啟動應用程式時顯示的影像(png)。 名稱的格式為account-id_splashIcon.png。 方形啟動顯示熒幕的尺寸為1052 × 1052畫素，圓形啟動顯示熒幕的尺寸為768 x 768畫素。</p>

code language-none
`<p>使用者端ID和使用者端密碼</p>`

code language-none

code language-none
`<p>註冊應用程式時，您帳戶的整合管理員會提供詳細資訊。整合管理員必須使用下列專案：<ul><li>學習者：read，學習者：write as role</li><li>內部應用程式name://redirect作為重新導向URL</li></ul></p>`

<p>註冊應用程式時，您帳戶的整合管理員會提供詳細資訊。 整合管理員必須使用下列專案：<ul><li>學習者：read，學習者：write as role</li><li>內部應用程式name://redirect作為重新導向URL</li></ul></p>

code language-none
`<p>帳戶標誌</p>`

code language-none
`<p>代管您組織標誌的URL。提供內容連結作為帳戶標誌。 URL必須經過網頁編碼。</p>`

code language-none
`<p>應用程式(iOS)的應用程式商店ID</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，讓CSAM可以將其新增至您的自訂應用程式二進位檔。

更新網站關聯以處理自訂深層連結

如果您使用自訂網域或learningmanager*.adobe.com作為主機，則不需要採取任何動作。不過，如果您使用自訂解決方案或URL的特定主機名稱，請新增網站關聯檔案。

CAUTION

如果檔案不存在，深層連結將無法運作。確認檔案存在。

如需詳細資訊，請參閱下列連結：

Android
iOS

產生推播通知

將推播通知傳送至Android和iOS應用程式需要兩種不同的機制。

針對iOS，產生推播通知憑證。
對於Android，請提供從Firebase專案產生的伺服器金鑰。

請依照下列指示，在Firebase中設定專案：

iOS上的推播通知

在iOS應用程式開發中，推播通知憑證是Apple所核發的密碼編譯認證，可讓伺服器透過Apple的推播通知服務(APN)安全地傳送推播通知至iOS裝置。

向iOS裝置傳送推播通知時，憑證可確保您的伺服器（或提供者）與Apple的APNs之間安全通訊。

Android和iOS都使用Firebase Cloud Messaging (FCM)作為傳送推播通知至裝置的服務。

如何在iOS上產生憑證

請遵循下列程式：

產生或下載 推播通知憑證 和私密金鑰(.p12)。如需詳細資訊，請參閱Apple開發人員檔案。
在下載檔案之後安裝p12檔案。使用密碼以安裝在您的 鑰匙圈存取 中。
瀏覽至 我的憑證 並匯出憑證。請務必選取mime型別.cer。
在擁有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檔案，請遵循下列步驟：

登入 Firebase 主控台。
移至 專案設定 並選取 雲端訊息。
尋找 Firebase Cloud Messaging API 並選取 管理服務帳戶。
在 服務帳戶 頁面中，選取左側面板中的 服務帳戶。

尋找您的專案專案，然後選取[動作]下的[管理詳細資料] 。

note note
NOTE
專案專案格式將為<-accountname->@appspot.gserviceaccount.com。

移至金鑰索引標籤並選取 新增金鑰。
如果沒有金鑰，請選取 建立新金鑰 並選取 JSON 作為金鑰型別。如此將可產生並下載JSON檔案。
如果已經有金鑰，請選取 上傳現有的金鑰，貼上金鑰並上傳。如此將可產生並下載JSON檔案。

請聯絡CSM團隊並分享JSON檔案，以將專案新增至AWS上的SNS服務。使用者必須在SNS服務中針對推播通知註冊專案，這將要求他們共用上述產生以供驗證的憑證。

在Firebase中建立專案 create-project-in-firebase

Android

針對推播通知，重複使用您在上述步驟中建立的相同專案。

在Firebase中新增專案，並擷取 google-services.json 檔案。

iOS

將專案新增至Firebase並擷取 GoogleService-Info.plist 檔案。

IMPORTANT

將檔案傳送至Adobe Learning Manager CSAM團隊，以納入應用程式二進位檔案的建置。

產生已簽署的二進位檔案

iOS

<root>資料夾包含 Runner.xcarchive.zip 檔案。執行以下命令來產生已簽署的二進位檔案：

執行以下命令以解壓縮封存：

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

導覽至應用程式目錄：

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

複製行動布建檔案：

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

返回<root>資料夾（Runner.xcarchive.zip所在位置）：

code language-none
`cd <root>`

使用xcodebuild匯出封存：

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

在ipa_path資料夾中找到.ipa檔案。
將.ipa檔案上傳至Diawi網站。
完全上傳後，選取 Send 按鈕。
完成後，您將會收到QR碼和連結。
直接在Safari中開啟QR碼或連結。

如果裝置包含在布建設定檔中，則應在裝置上繼續進行安裝。

NOTE

您需要有XCode 15.2或更新版本才能建置已簽署的二進位檔。

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檔案的

NOTE

您需要Android sdk建置工具，才能建置已簽署的二進位檔。

Play Store需要aab格式的Android二進位檔才能發佈。因此，我們將提供未簽署的.aab檔案。

NOTE

建立金鑰存放區檔案時，您需要產生金鑰存放區密碼、簽署金鑰別名以及簽署金鑰別名密碼。

請依照下列步驟簽署.aab檔案：

執行以下命令：

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

NOTE

jarsigner 包含在Java中。確定您使用的是Java 21。

出現提示時，請輸入下列密碼：

金鑰存放區密碼
簽署金鑰別名的密碼

您可以使用提供的應用程式。不過，如果您需要從aab檔案產生apk，請遵循下列步驟：

NOTE

您必須安裝 bundletool 才能產生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 Store或App Store。

如何套用變更

將所需的資產和檔案傳送到CSM團隊。然後CSM團隊會以必要的變更填入表單並附加必要的資產。然後團隊將稽核並通知工程團隊相關變更。工程團隊將隨即產生組建並與CSM團隊共用。

CSM團隊將與客戶共用組建。

無法自訂的專案

更新密碼畫面
建立帳戶畫面

recommendation-more-help

d5e5961a-141b-4c77-820e-8453ddef913d