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

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

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

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

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

  2. 分配技术资源,该资源能够:

    • 正在生成推送通知证书文件。
    • 签署ALM团队提供的应用程序二进制文件。
    • 上传和管理发布过程。 发布过程要求您的应用程序管理员与app/play store团队之间进行通信,以确保您的应用程序符合所有发布准则。 从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>操作系统用来标识应用程序的名称。 通常使用的格式为: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像素。<div>请注意,Apple不允许在应用程序图标中使用Alpha渠道。 因此,请确保在提交资源之前移除资源中的Alpha渠道。</div></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>内部应用程序name://redirect作为重定向URL</li></ul></p>
code language-none
<p>账户标志</p>
code language-none
<p>托管您组织的徽标的URL。 提供内容链接作为帐户徽标。 URL需要进行Web编码。</p>
code language-none
<p>应用程序的App store ID (iOS)</p>
code language-none
<p>实施强制更新所需的ID。 应用程序需要知道学习者应被重定向到App Store才能更新应用程序。</p>
code language-none
<p>应用程序的Google play store 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应用程序发送推送通知需要两种不同的机制。

  • 对于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 note
    NOTE
    项目条目格式将为<-accountname->@appspot.gserviceaccount.com。
  6. 转到​ 密钥 ​选项卡,然后选择​ 添加密钥

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

  8. 如果已有密钥,请选择​ 上传现有密钥,粘贴该密钥,然后上传。 这将生成并下载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 ​文件。 运行以下命令以生成带签名的二进制文件:

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

    code language-none
    unzip Runner.xcarchive.zip
    
  2. 导航到应用程序目录:

    code language-none
    cd Runner.xcarchive/Products/Applications/Runner.app
    
  3. 复制移动配置文件:

    code language-none
    cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision
    
  4. 返回<root>文件夹(Runner.xcarchive.zip所在的位置):

    code language-none
    cd <root>
    
  5. 使用xcodebuild导出存档文件:

    code language-none
    xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist
    
  6. 在ipa_path文件夹中找到.ipa文件。

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

  8. 完全上传后,选择​ 发送 ​按钮。

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

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

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

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商店要求使用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中。

如何应用更改

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

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

无法自定义的内容

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