Adobe Learning Manager行動應用程式中的白色標籤
Adobe Learning Manager行動應用程式現在支援貼上白色標籤,這表示您現在可以使用自己的品牌發佈應用程式。
ALM會根據下列時間表,提供已更新並標示為白色的二進位檔案:
- 若為行動應用程式的主要發行版本,檔案將提前兩週提供使用。
- 對於任何計畫中的緊急修正更新,將提前一週提供檔案。
- 針對計畫外、緊急和立即的修正,我們將盡最大努力提供檔案。
二進位檔將可在客戶指定的資料夾中使用。 請連絡您的CSM以存取檔案。 客戶負責及時發佈和相關流程。
開始準備啟動標示為白色的應用程式的方法
若要部署和管理您自己的白色標籤應用程式,請遵循下列步驟:
-
準備資產(如啟動畫面影像)和文字,以便兩者都能在應用程式中使用和應用程式/播放商店上的說明。
-
指派技術資源,該資源應具備以下能力:
- 產生推播通知憑證檔案。
- 簽署ALM團隊提供的應用程式二進位檔。
- 上傳及管理發布程式。 發佈程式需要應用程式管理員和應用程式/遊戲商店團隊溝通,確保應用程式符合所有發佈准則。 從ALM,您將會收到完全相容的應用程式二進位檔。
概觀
使用白色標籤是將應用程式或服務重新品牌化為您自己的品牌,並自訂它,就好像您是原始建立者一樣。 在Adobe Learning Manager中,您可以將白色標籤套用至行動應用程式,藉此重新命名應用程式,並讓您的使用者在自己的品牌下使用應用程式。
可自訂的專案
下列是可自訂的:
欄位
注意: 指定子網域時,您必須新增帳戶識別碼。
應用程式圖示為png。 此圖示會顯示在您的應用程式上。 名稱的格式為account-id_appIcon.png。 應用程式圖示的尺寸為512 × 512畫素。
請注意,Apple不允許在應用程式圖示中使用Alpha頻道。 因此,在提交之前,請務必從資產中移除Alpha管道。
註冊應用程式時,您帳戶的整合管理員會提供詳細資訊。 整合管理員必須使用下列專案:
- 學習者:read,學習者:write as role
- 內部應用程式name://redirect作為重新導向URL
更新網站關聯以處理自訂深層連結
如果您使用自訂網域或learningmanager*.adobe.com作為主機,則不需要採取任何動作。 不過,如果您使用自訂解決方案或URL的特定主機名稱,請新增網站關聯檔案。
如需詳細資訊,請參閱下列連結:
產生推播通知
將推播通知傳送至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
專案專案格式將為<-accountname->@appspot.gserviceaccount.com。 -
移至 金鑰 索引標籤並選取 新增金鑰。
-
如果沒有金鑰,請選取 建立新金鑰 並選取 JSON 作為金鑰型別。 如此將可產生並下載JSON檔案。
-
如果已經有金鑰,請選取 上傳現有的金鑰,貼上金鑰並上傳。 如此將可產生並下載JSON檔案。
請聯絡CSM團隊並分享JSON檔案,以將專案新增至AWS上的SNS服務。 使用者必須在SNS服務中針對推播通知註冊專案,這將要求他們共用上述產生以供驗證的憑證。
在Firebase中建立專案
Android
針對推播通知,重複使用您在上述步驟中建立的相同專案。
在Firebase中新增專案,並擷取 google-services.json 檔案。
iOS
將專案新增至Firebase並擷取 GoogleService-Info.plist 檔案。
產生已簽署的二進位檔案
iOS
<root>
資料夾包含 Runner.xcarchive.zip 檔案。 執行以下命令來產生已簽署的二進位檔案:
-
執行以下命令以解壓縮封存:
unzip Runner.xcarchive.zip
-
導覽至應用程式目錄:
cd Runner.xcarchive/Products/Applications/Runner.app
-
複製行動布建檔案:
cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision
-
執行以下命令,將您的簽署資訊更新至框架程式庫:
codesign -f -s "Distribution Certificate Name" Frameworks/*
-
返回
<root>
資料夾(Runner.xcarchive.zip所在位置):cd <root>
-
使用xcodebuild匯出封存:
xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist
-
在ipa_path資料夾中找到.ipa檔案。
-
將.ipa檔案上傳至
Diawi
網站。 -
完全上傳後,選取 Send 按鈕。
-
完成後,您將會收到QR碼和連結。
-
直接在Safari中開啟QR碼或連結。
如果裝置包含在布建設定檔中,則應在裝置上繼續進行安裝。
Android
適用於apk檔案
apksigner
命令之前,請執行以下命令,將您的金鑰存放區密碼和金鑰別名密碼匯出為環境變數:export KS_PASS=your_keystore_password
export KEY_PASS=your_key_password
sh""" <path>/apksigner sign --ks $storeFile. --ks-pass env:KS_PASS --ks-key-alias $key_alias --key-pass env:KEY_PASS --out app-release-signed.apk -v app-release.apk """
apksigner
工具的路徑通常如下所示: ~/Library/Android/sdk/build-tools/30.0.3/apksigner。適用於aab檔案 的
Play Store需要aab格式的Android二進位檔才能發佈。 因此,我們將提供未簽署的.aab檔案。
請依照下列步驟簽署.aab檔案:
執行以下命令:
<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>
出現提示時,請輸入下列密碼:
- 金鑰存放區密碼
- 簽署金鑰別名的密碼
您可以使用提供的應用程式。 不過,如果您需要從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 Store或App Store。
正在推送應用程式至商店以供檢閱
取得最終二進位檔後,您可以將其上傳至個別應用程式商店(iOS或Android)進行檢閱。 請依照下列步驟,將二進位檔上傳至應用程式商店。
iOS
- 使用您的App Store憑證登入「傳輸程式」應用程式。
- 選取左上方的 + 按鈕並上傳生產憑證(.ipa檔案)。
- 如果.ipa檔案正確,系統會提示您上傳應用程式至App Store。
- 應用程式傳送後,請登入App Store。 幾小時後,二進位檔就會顯示在TestFlight區段中。 您可以在應用程式稽核前,先在TestFlight中啟用它以進行最終的健全度測試,並在提交新版本的應用程式時,使用此IPA作為二進位。
Android
- 開啟Google Play Store Console。
- 前往 Dashboard > View App Releases > Release Dashboard,然後選取 Create New Release。
- 上傳產生的.aab檔案作為應用程式套件組合,並輸入版本詳細資料,例如版本號碼和新增功能資訊。
- 儲存您的變更並提交應用程式以供檢閱。
- 請務必將應用程式發佈設為100% (Google預設會將其設為20%)。
應用程式發佈的實用連結
Android
iOS
如何套用變更
將所需的資產和檔案傳送到CSM團隊。 然後CSM團隊會以必要的變更填入表單並附加必要的資產。 然後團隊將稽核並通知工程團隊相關變更。 工程團隊將隨即產生組建並與CSM團隊共用。
CSM團隊將與客戶共用組建。
無法自訂的專案
- 更新密碼畫面
- 建立帳戶畫面