跳转至

创建构建作业

为所选应用程序创建构建作业。

构建作业合并了项目设置和构建设置（如签名参数文件）。选择创建构建作业按钮为移动开发工具包客户端创建构建作业。

作为开发人员，您可以并行配置多个自定义 移动开发工具包客户端 配置，以尝试品牌化和其他构建设置。您可以在配置之间切换，查看构建作业状态，下钻到构建作业详细信息和执行日志，并尝试通过二维码在设备上安装应用。有关详细信息，请参阅为定制的移动开发工具包客户端创建构建作业。

  1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

  2. 选择应用程序，导航到设置标签，然后从已分配功能部分中选择云构建（或先进行添加）。

  3. 选择创建构建作业创建新的构建作业。

  4. 在创建构建作业中，选择客户端类型。

    支持的客户端类型如下所示：

    • 移动开发工具包客户端
    • 定制的移动开发工具包客户端客户端
    • SAP Asset Manager

    有关不同的应用类型和所需打包详细信息的内容，请参见支持的客户端类型、打包详细信息和构建选项。

  5. 在基本信息页面上填写所选客户端类型的信息。这些字段是动态的，并根据您所做的选择显示。

    有关信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  6. 在平台页面上填写平台相关信息。

    • (移动开发工具包客户端)

      在 Android 和 iOS 构建下，输入 URL 模式。

      在 Android 构建下，输入 Google 服务 JSON 文件，或浏览以找到该文件。

      选择显示内容以查看 JSON 文件的内容。如果不是正确的文件，单击移除文件，然后重试。保存后，将上传 JSON 文件。

      选择要使用的二进制格式，APK（Android 包套件，缺省值）或 AAB（Android 应用包）。

      然后选择目标部署、设备（ARM）和/或模拟器（X86），然后单击下一步。

    • (SAP Asset Manager)

      在 Android 和 iOS 构建下，输入 URL 模式。

      在 Android 构建下，输入 Google 服务 JSON 文件，或浏览以找到该文件。

      选择显示内容以查看 JSON 文件的内容。如果不是正确的文件，单击移除文件，然后重试。保存后，将上传 JSON 文件。

      选择要使用的二进制格式，APK（Android 包套件，缺省值）或 AAB（Android 应用包）。

      然后选择目标部署、设备（ARM）和/或模拟器（X86），然后单击下一步。

  7. 在多媒体页面上，根据所选的应用类型识别启动图标和启动屏幕图标。您可以使用缺省图标，上传符合大小标准的新图标，或单击重置恢复为缺省图标。单击图像标题以预览该图标。

  8. 在构建选项页面上提供构建选项：

    • 平台 - 构建的平台（如 Android 和 iOS）。

      注释

      移动开发工具包客户端 和 SAP Asset Manager同时支持 Android 和 iOS 平台。

    • 签名参数文件 ‒ Android 和 iOS 平台的参数文件。请参阅创建签名参数文件

      注释

      如果较早的签名参数文件报告空对象异常，则必须重新加载参数文件。

    • 最低平台版本 - Android 和 iOS 平台所需的最低操作系统版本。

    • SDK 版本 - 从列表中选择支持的版本。始终建议使用缺省版本（它会随时间变化），但您可以选择较旧的 SDK 版本。The SDK version is no longer supported消息表明您应该使用较新的版本进行构建。

    • 构建选项 - 定义构建的二进制类型。

      • 创建已启用调试的二进制

      • 包括演示模式

      有关不同构建选项的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  9. 选择完成。

为定制的移动开发工具包客户端创建构建作业

从 SAP 移动服务主控室为定制的移动开发工具包客户端创建构建作业。构建包括运行定制扩展、应用程序资源和登录以及在 Cloud Foundry 架构中运行演示模式的功能。

自定义移动开发工具包项目 ZIP 文件必须以有效格式准备，并且必须对云构建服务中可用的当前移动开发工具包版本有效，否则您可能会在运行应用时看到构建失败或事件失败。以下是遵循验证规则的核心结构示例，但不是所支持内容的详尽表示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
```text
    template.mdkproject.zip
      └──xxxxx.mdkproject
         ├──App_Resources/
         │  ├── Android/
         │  │   ├── google-services.json
         │  │   └── src/
         │  │       └── main/
         │  │           └── assets/
         │  └── iOS/
         ├──BrandedSettings.json   (Required)
         ├──MDKProject.json        (Required)
         ├──demo/
         ├──extensions/
         └──metadata/
```

云构建服务要求上传的文件包含一个根文件夹（包括 .mdkproject 后缀）。为此，开发人员必须压缩本地 .mdkproject。

上传移动开发工具包项目 ZIP 文件时，将对文件执行以下验证：

  • 文件必须通过病毒扫描，如果失败，则报告错误。

  • 文件必须为 ZIP 文件格式，否则报告错误。

  • 以迭代方式处理 ZIP 文件内容以验证以下事项：

    • 您的 xxxxx.mdkproject 位于 ZIP 文件的根。

    • BrandedSettings.json 直接位于根文件夹 xxxxx.mdkproject 下，否则报告错误（错误请求）。

    • MDKProject.json 直接位于根文件夹 xxxxx.mdkproject 下，否则报告错误（错误请求）。

    • 可以解析 BrandedSettings.json 和 MDKProject.json，如果格式不正确，则报告错误（内部服务器错误）。

    • 使用以下规则验证上述解析值：

      • MDKProject.json 中的 AppName（必填）：必须以字母开头，后面只能是字母和数字的组合，最大长度为 80 个字符。

        注意：AppName 不能包含破折号、空格或下划线等特殊字符。

      • MDKProject.json 中的 AppVersion （必需）：必须与其中一个正则表达式匹配：

        /^[1-9][0-9]{0,3}.([0]|[1-9][0-9]{0,1})$/

        /^[1-9][0-9]{0,3}.([0]|[1-9][0-9]{0,1}).([0]|[1-9][0-9]{0,1}$/

        • 必须包含两段或三段，以句点 (".") 分隔

        • 每段仅包含数字。

        • 第一段必须以大于 0 的数字开头，后跟 0 或 3 位。

        • 第二段和第三段必须包含从 0 到 99 的数字。

      • MDKProject.json 中的 UrlScheme（可选）：必须以字母开头，后跟字母、数字、加号 ("+")、句点 (".") 或破折号 ("-")，且长度不能超过 255 个字符。

      • MDKProject.json 中的 BundleID（必需）：必须以字母开头，后跟字母、数字、句点 (".") 或下划线 ("_")，且长度不能超过 64 个字符。

      • Google-services.json 可选：必须是有效的 JSON 文件，且 MDKProject.json 中的 BundleID 必须是 google-services.json 中列出的包之一。

      • BrandedSettings.json 中的 ApplicationDisplayName（可选）：检查长度，长度不能超过 128 个字符。

      • BrandedSettings.json 中的 DetailLabelViewText（可选）：检查长度，长度不能超过 128 个字符。

要创建定制的移动开发工具包客户端：

  1. 选择创建构建作业创建新的构建作业。

  2. 在创建构建作业中，为客户端类型从列表中选择定制的移动开发工具包客户端。

  3. 在基本信息页面上填写定制 移动开发工具包 客户端的信息。

    • 对于构建作业名称，输入名称以替换缺省名称。

    • 对于移动开发工具包项目 ZIP 文件，提供要使用的项目文件的名称，或浏览以选择该文件。您还可以上传新版本的项目文件，例如，在修复上传期间的验证失败后。

    如果无法上传项目文件，请检查错误报告并进行更改，直到成功完成所有验证检查。

    如果项目文件有效，则会根据 ZIP 文件中包含的值更新设备应用名称和后续字段。在某些情况下，您可能需要修改连接属性（有关信息，请参阅连接属性）。

    选择下一步导航到后续页面。有关条目的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  4. 在平台页面上填写平台信息。

    • 在 Android 和 iOS 构建下，输入 URL 模式。

    • 在 Android 构建下，您可以浏览以检查 ZIP 文件中包含的现有 google-services.json 文件内容，也可以上传新 google-services.json 文件以将其覆盖。同时选择要使用的二进制格式，APK（Android 包套件，缺省值）或 AAB（Android 应用包）。

      保存后，将上传 google-services.json 文件。您可以选择显示内容以查看 JSON 文件的内容。如果不是正确的文件，单击移除文件，然后重试。

    选择下一步导航到后续页面。有关条目的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  5. 在多媒体页面上，根据所选的应用类型识别启动和启动屏幕图标。对于 Android 构建，您可以定制通知图标。您可以使用缺省图标；上传符合大小标准的新图标以覆盖 ZIP 文件中包含的内容；或单击重置恢复为缺省值。单击图像标题以预览该图标。

    选择下一步导航到后续页面。有关条目的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  6. 在构建选项页面上修改定制 移动开发工具包 客户端的构建选项。

    1. 签名参数文件 - 选择 Android 和 iOS 平台的参数文件。请注意，如果较早的签名参数文件报告空对象异常，则必须重新加载参数文件。

    2. 最低平台版本 - 选择 Android 和 iOS 平台所需的最低操作系统版本。

    3. 创建已启用调试的二进制 - 在已启用调试的情况下创建二进制版本。

    有关条目的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  7. 选择完成。如果所有条目均有效，则新作业将显示在构建作业列表中。

  8. （可选）检查构建作业标签以查看构建状态。状态值包括：

    • 需要构建 - 已创建构建作业。选择操作下的构建以运行构建作业。

    • 构建已完成 - 构建作业已成功运行。

    • 构建失败 - 构建失败。调查原因，然后再次运行构建作业。

连接属性

连接属性可通过构建作业自动设置，或者可能需要根据多个条件手动设置它们。

BrandedSettings.json 文件的 ConnectionSettings 部分中的 AppId 始终由构建作业使用创建构建作业的应用程序的标识值设置。如果该属性不存在或其值在 BrandedSettings.json 文件中设置为空 ('')，则其他 ConnectionSettings 属性（ClientId、SapCloudPlatformEndpoint、AuthorizationEndpointUrl、RedirectUrl 和 TokenUrl）也由构建作业设置。当应用要登录到构建应用二进制文件的同一架构时，使用此方法。

请注意，从 移动开发工具包 版本 5.2 开始，SapCloudPlatformEndpoint 重命名为 ServerUrl。出于向后兼容性原因，移动开发工具包 同时支持这两个属性。如果两个属性都在 BrandedSettings.json 文件中定义，则 移动开发工具包 使用 ServerUrl。归并原则包括：

  • 最后两个属性设置为相同的值。

  • 如果两个属性均缺失或为空或以占位符开头，则该值由构建作业设置。

  • 如果 SapCloudPlatformEndpoint 具有值但 ServerUrl 缺失或为空或以占位符开头，则使用 SapCloudPlatformEndpoint 值。

  • 如果 SapCloudPlatformEndpoint 缺失或为空或以占位符开头但 ServerUrl 具有值，则使用 ServerUrl 值。

  • 如果 SapCloudPlatformEndpoint 和 ServerUrl 都有值，则使用 ServerUrl 值。

如果应用要登录构建应用二进制文件的不同架构，则必须将 BrandedSettings.json 中的每个连接属性设置为登录架构中同一应用程序的相应属性值。

要使应用成功登录，应用程序标识在构建和登录环境中必须相同。

构建作业设置上述属性的另一个条件是，删除开头和结尾的空格后，值是否以 "<Enter" 开头。添加该条件是因为如果从默认模板 mdkproject 复制 BrandedSettings.json，则提及的属性通常带有占位符值。这些值不为空但不正确，因此构建作业视为需要使用正确的值填充它们。

创建使用证书的构建作业

您可以使用云构建服务构建具有基于证书的验证的 移动开发工具包客户端 或 SAP Asset Manager 客户端。启用后，如果身份提供者 (IdP) 请求，客户端可以在登录期间访问设备上的证书。

客户端类型必须实施 OAuth 安全配置，并且您必须配置重定向 URL（不能使用缺省值）。

有关详细步骤，请参阅创建构建作业。这些步骤关注使用基于证书的验证构建 移动开发工具包客户端 或 SAP Asset Manager 客户端的说明。

  1. 在 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

  2. 选择应用程序，导航到设置标签，然后从已分配功能部分中选择云构建（或先进行添加）。

  3. 选择创建构建作业创建新的构建作业。

  4. 在创建构建作业中，从列表中选择客户端类型。证书选项支持的客户端类型包括：

    • 移动开发工具包客户端
    • SAP Asset Manager

    有关不同的应用类型和所需打包详细信息的内容，请参见支持的客户端类型、打包详细信息和构建选项。

  5. 在基本信息页面上填写所选客户端类型的信息。这些字段是动态的，并根据您所做的选择显示。

    如果身份提供者 (IdP) 请求，选择允许证书以使 移动开发工具包客户端 或 SAP Asset Manager 客户端能够在登录期间访问客户端设备上的证书。

    有关附加条目的信息，请参阅支持的客户端类型、打包详细信息和构建选项。

  6. 完成其余向导页面的条目，然后选择完成。

编辑构建作业

编辑所选应用程序的构建作业。

  1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

  2. 选择应用程序，导航到设置标签，然后从已分配功能部分中选择云构建（或先进行添加）。

  3. 在构建作业标签的操作下选择 edit 以编辑构建作业。

  4. 使用编辑构建作业向导对构建作业进行更改。有关字段定义，请参阅创建构建作业。每个页面上显示的字段取决于所选客户端类型。

  5. 选择完成。构建作业状态更改为“需要构建”，并在下次运行构建时使用新值。

启用详细事件日志记录

在 SAP 移动服务主控室上启用或禁用云构建独立服务的详细事件日志记录。

禁用时，错误日志记录将继续，但不包括详细的创建、读取、更新和删除操作。

  1. 在 SAP 移动服务主控室中，选择设置 > 云构建。

  2. 选择右上角的启用详细事件日志以开始记录云构建缺省清除设置的初始化。 要查看与云构建的构建流程相关的详细事件日志，您需要在应用程序级别启用云构建功能的详细事件日志（请参阅查看事件日志）。

  3. 随时选择禁用详细事件日志以停止记录这些操作。错误日志记录将继续。

清除云构建部件

设置清除云构建日志和构建输出的计划。

在租户级别进行清除。云构建日志将保留指定的天数，并在计划器任务运行时清除。 输出和部件将保留指定的天数，并在计划器任务运行时清除。

  1. 在 SAP 移动服务主控室中，选择设置 > 云构建 > 清除设置。

  2. 如果启用清除设置已禁用，则选择 edit 。

  3. 选择启用清除设置，然后编辑清除设置。

    清除设置

    设置 描述
    在此时间后清除成功构建的日志 确定何时清除成功构建的日志 - 立即，或在 1、3、7 或 30 天之后。缺省值为 7 天。
    在此时间后清除未成功构建的日志 确定何时清除未成功构建的日志 - 立即，或在 1、3、7 或 30 天之后。缺省值为 7 天。
    保留每个应用过去 n 个成功构建的输出 确定过去 1-5 个成功的应用构建中部件的保留时间。缺省值为 3 个成功的构建。
    保留每个应用过去 n 个未成功构建的输出 确定过去 1-5 个未成功的应用构建中部件的保留时间。缺省值为 3 个未成功的构建。
    上次清除 以 YYYY-MM-DD HH:MM:SS 格式（本地或 UTC 时区）显示上次成功的清除。

  4. 选择保存。

除非服务器端另有配置，否则数据将一直保存到计划器任务运行（通常 每 12 小时运行一次）。状态为PENDING的构建不会受清除设置的影响。

最后更新: February 12, 2025