文档Learning Manager

AdobeLearning Manager移动应用程序中的白色标签

最近更新： 2025年2月6日

Adobe Learning Manager移动应用程序现在支持白色标签 — 这意味着您现在可以按自己的品牌发布该应用程序。

ALM将根据以下时间表提供更新后的白标二进制文件：

  1. 对于移动应用程序的主要版本，将提前两周提供文件。
  2. 对于为紧急修复计划的任何更新，将提前一周提供文件。
  3. 对于计划外、紧急和紧急的修复，将尽最大努力提供文件。

二进制文件将在客户指定的文件夹中提供。 请与您的CSM联系以访问这些文件。 客户负责及时发布及相关流程。

如何开始准备启动贴有白色标签的应用程序

要部署和管理您自己的带白标签的应用程序，请按照以下步骤操作：

  1. 准备资源（如初始屏幕图像）和文本，以便同时用于应用程序和app/play store上的描述。

  2. 分配技术资源，该资源能够：

    • 正在生成推送通知证书文件。
    • 签署ALM团队提供的应用程序二进制文件。
    • 上传和管理发布过程。 发布过程要求您的应用程序管理员与app/play store团队之间进行通信，以确保您的应用程序符合所有发布准则。 从ALM中，您将收到完全兼容的应用程序二进制文件。

概述

白色标签是一种用您自己的品牌重塑应用程序或服务，并像原创者一样对其进行自定义的做法。 在Adobe Learning Manager中，可将白色标签应用于移动应用程序，以便重新品牌化应用程序并使您的用户可使用自己的品牌。

可自定义的内容

可自定义以下各项：

字段

帐户ID
您帐户的ID。 请注意，属于任何其他帐户的学习者将无法访问带白色标签的应用程序。
其他帐户ID
如果需要，可添加多个帐户（子域）。 将子域添加为用逗号分隔且不含空格的形式。 例如，acc01、acc02、acc03等等。
注意： 指定子域时需要添加帐户ID。
应用程序名称
要用于应用程序的名称。
应用程序简称
如果应用程序名称较长，则为应用程序提供一个显示在设备上的简称。
内部应用程序名称
操作系统用来标识应用程序的名称。 通常使用的格式为：com.company-name.product-name。
内部应用程序名称 — iOS
如果用户使用的是iOS，请使用其他方法命名应用程序。 我们建议为iOS和Android使用相同的名称。
应用程序图标

应用程序图标为png。 此图标将显示在您的应用程序上。 名称的格式为account-id_appIcon.png。 应用程序图标的尺寸为512 × 512像素。

请注意，Apple不允许在应用程序图标中使用Alpha渠道。 因此，请确保在提交资源之前移除资源中的Alpha渠道。

应用程序启动屏幕
对于应用程序的启动屏幕，请提供图像(png)，当用户启动应用程序时会显示该图像。 名称的格式为account-id_splashIcon.png。 方形初始屏幕的尺寸为1052 × 1052像素，圆形初始屏幕的尺寸为768 x 768像素。
客户端ID和客户端密钥

您帐户的集成管理员在注册应用程序时提供详细信息。 集成管理员必须使用以下内容：

  • 学习者：读取，学习者：写入为角色
  • 内部应用程序name://redirect作为重定向URL
账户标志
托管您组织的徽标的URL。 提供内容链接作为帐户徽标。 URL需要进行Web编码。
应用程序的App store ID (iOS)
实施强制更新所需的ID。 应用程序需要知道学习者应被重定向到App Store才能更新应用程序。
应用程序的Google play store id (Android)
实施强制更新所需的ID。
用于深层链接的主机名
要托管深层链接，请使用learningmanager。 如果要使用另一个主机名URL作为深层链接，请提供主机的URL。 例如，learningmanager.adobe.com。
NOTE
向您的CSAM提供数据，以便他们可以将数据添加到您的自定义应用程序二进制文件中。

更新站点关联以处理自定义深度链接

如果您使用自定义域或learningmanager*.adobe.com作为主机，则无需执行任何操作。 但是，如果对URL使用自定义解决方案或特定主机名，请添加站点关联文件。

CAUTION
如果文件不存在，则深度链接将不起作用。 确保文件存在。

有关更多信息，请参阅以下链接：

  • Android
  • iOS

生成推送通知

向Android和iOS应用程序发送推送通知需要两种不同的机制。

  • 对于iOS，请生成推送通知证书。
  • 对于Android，请提供从Firebase项目生成的服务器密钥。

按照以下说明在Firebase中设置项目：

在iOS上推送通知

在iOS应用程序开发中，推送通知证书是由Apple颁发的加密凭据，允许服务器通过Apple的推送通知服务(APN)将推送通知安全地发送到iOS设备。

在将推送通知发送到iOS设备时，该证书可确保您的服务器（或提供商）与Apple的APN之间的安全通信。

Android和iOS都使用Firebase Cloud Messaging (FCM)作为向设备发送推送通知的服务。

如何在iOS上生成证书

请按以下步骤操作：

  1. 生成或下载​ 推送通知证书 ​和私钥(.p12)。 有关详细信息，请参阅Apple开发人员文档。

  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
    项目条目格式将为<-accountname->@appspot.gserviceaccount.com。

  6. 转到​ 密钥 ​选项卡，然后选择​ 添加密钥。

  7. 如果没有密钥，请选择​ 创建新密钥，然后选择​ JSON ​作为密钥类型。 这将生成并下载JSON文件。

  8. 如果已有密钥，请选择​ 上传现有密钥，粘贴该密钥，然后上传。 这将生成并下载JSON文件。

联系CSM团队并共享JSON文件，以将条目添加到AWS上的SNS服务。 用户必须在SNS服务中注册推送通知的条目，这将要求他们共享上面生成的证书以进行验证。

在Firebase中创建项目

Android

将您在上述步骤中创建的相同项目重新用于推送通知。

在Firebase中添加项目并检索​ google-services.json ​文件。

iOS

将项目添加到Firebase并检索​ GoogleService-Info.plist ​文件。

IMPORTANT
将文件发送到Adobe Learning Manager CSAM团队，以包含在应用程序二进制文件的构建中。

生成已签名的二进制文件

iOS

<root>文件夹包含​ Runner.xcarchive.zip ​文件。 运行以下命令以生成带签名的二进制文件：

  1. 运行以下命令以解压缩存档文件：

    unzip Runner.xcarchive.zip

  2. 导航到应用程序目录：

    cd Runner.xcarchive/Products/Applications/Runner.app

  3. 复制移动配置文件：

    cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision

  4. 运行以下命令以将签名信息更新到框架库：

    codesign -f -s "Distribution Certificate Name" Frameworks/*

  5. 返回<root>文件夹（Runner.xcarchive.zip所在的位置）：

    cd <root>

  6. 使用xcodebuild导出存档文件：

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

  7. 在ipa_path文件夹中找到.ipa文件。

  8. 将.ipa文件上传到Diawi网站。

  9. 完全上传后，选择​ 发送 ​按钮。

  10. 完成后，您将收到一个二维码和一个链接。

  11. 在Safari中直接打开二维码或链接。

如果设备包含在预配配置文件中，则应在设备上继续安装。

NOTE
您需要具备XCode 15.2或更高版本才能构建已签名的二进制文件。

Android

对于apk文件

IMPORTANT
在运行apksigner命令之前，请执行以下命令，将keystore密码和密钥别名密码导出为环境变量：
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 """
NOTE
apksigner工具的路径通常如下所示： ~/Library/Android/sdk/build-tools/30.0.3/apksigner。

对于aab文件

NOTE
您需要使用Android sdk生成工具来生成已签名的二进制文件。

Play商店要求使用aab格式的Android二进制文件才能发布。 因此，我们将提供未签名的.aab文件。

NOTE
创建keystore文件时，需要生成keystore密码、签名密钥别名和签名密钥别名密码。

请按照以下步骤对.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中。

正在将应用程序推送到应用商店以供审阅

获取最终二进制文件后，可将其上传到相应的应用程序商店(iOS或Android)以供审阅。 按照以下步骤将二进制文件上传到应用商店。

iOS

  1. 使用您的App Store凭据登录传输应用程序。
  2. 选择左上角的​ + ​按钮，然后上传生产证书（.ipa文件）。
  3. 如果.ipa文件正确，系统将提示您将该应用程序上传到App Store。
  4. 在交付应用程序后，登录到App Store 。 在几个小时内，该二进制文件将显示在“试飞”部分中。 您可以在应用程序审阅之前在TestFlight中启用它进行最终完整性测试，并在提交应用程序以发布新版本时将此应用程序用作二进制文件。

Android

  1. 打开Google Play Store控制台。
  2. 转到​ 仪表板 > 查看应用程序版本 > 版本仪表板，然后选择​ 创建新版本。
  3. 将生成的.aab文件作为应用程序捆绑包上传，然后键入版本号、“新增功能”等版本详细信息。
  4. 保存更改并提交应用程序以供审阅。
  5. 确保将应用程序分布设置为100%(Google默认情况下设置为20%)。

有关应用程序发布的有用链接

Android

创建并设置应用程序
准备您的应用程序以供审阅

iOS

提交以供审阅

如何应用更改

将所需的资源和文件发送给CSM团队。 然后，CSM团队使用所需的更改填写表单并附加所需的资源。 然后，该团队将进行审查并向工程团队通知相关更改。 然后，工程团队将生成生成版本并与CSM团队共享。

CSM团队将与客户共享该构建。

无法自定义的内容

  • “更新密码”屏幕
  • 创建帐户屏幕
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d