管理应用程序主题

（仅限本机/MDK）作为管理员，您可以从 SAP 移动服务主控室 管理应用程序主题并为所选移动应用指示默认主题。

主题更改移动客户端在用户设备上的外观。移动服务 服务器使用这些设置将主题应用到移动应用客户端。每个主题定义都包含主题的浅色和深色版本。移动客户端用户可以从设备设置活动主题。主题在空间级别进行管理。

必须使用 SAP 主题设计器和 SAP Horizon 深色/浅色主题作为基础定义主题。只能更改背景颜色和文本颜色。主题必须导出为 ZIP 格式。上传后，您可以设置活动主题。如果您决定取消选择主题，SDK 应用程序不会从 移动服务 服务器获取主题。

请注意，对于单个应用程序主控室（软件即服务，SaaS），仅有一个定制主题可供用户使用。启用定制主题后，会自动为应用程序启用主题。您可以更新和删除主题。如果删除了主题，SDK 应用程序将使用初始默认主题，而不是从 移动服务 服务器获取主题。外观信息已清除，可以导入其他主题。

管理应用主题

您可以使用 SAP 移动服务主控室 管理中央位置中的所有主题。必须使用 SAP 主题设计器和 SAP Horizon 深色/浅色主题作为基础创建主题。只能更改背景颜色和文本颜色。必须使用导出选项可选设置（针对专家）> 源文件 + CSS 并取消选择 UI 技术，将主题导出为 ZIP 格式

theme.zip 文件包含主题的浅色和深色版本，包括 JPG 格式的公司徽标、Android 应用的 JSON 源文件和 iOS 应用的 NSS 源文件。

SAP Mobile Services 服务器会在将 theme.zip 文件上传到存储服务时对其进行验证，以确保安全性和部件有效性。检查这些验证规则：

• 上传的主题文件必须为 ZIP 格式。

• 上传的主题文件的最大大小为 10M。

• 上传的主题设计器 ZIP 必须为 sap_horizon 类型。

• 上传的主题 ZIP 文件必须通过病毒扫描。

• 用户最多可以在一个请求中上传两个主题 ZIP 文件。

• 必须通过以下 ZIP 文件内容检查：

  • 必须包含 Base/baseLib/<theme_name>/.theming 文件，并且文件内容必须是有效的 JSON 格式。

    JSON 内容必须包含以下属性和相应的值： * sId * sLabel * oExtends * aBadgeParameters

  • 必须包含 Base/baseLib/<theme_name>/.less_variables.less 文件。

• 如果任何验证失败，则会为其创建一个事件日志。使用存储服务的“客户端设置”过滤器检查事件日志，如查看事件日志中所述。

在初始上传到应用主题管理器后，要更新主题，您可以执行以下操作：

• 使用 SAP 主题设计器修改主题，将其导出为新的 ZIP 文件，然后上传到 SAP 移动服务主控室 主题管理器。

• 从主题管理器（提供者）和外观（SaaS 应用程序）下载包含 NSS 和 JSON 文件的 ZIP 文件。直接修改最终处理的主题 ZIP，完成后上传。

要管理主题：

1. 在 SAP 移动服务主控室 中，选择设置 > 应用主题管理器。

2. 查看已上传的主题列表。

   列	描述
   名称	与主控室主题列表中列出的主题相关联的唯一名称。
   标识	已分配至 SAP 主题设计器的标识符。请注意，可以重复使用标识，例如，如果主题设计器 ZIP 文件同时包含浅色和深色主题。
   标题	描述性主题标题，例如自定义高对比度早晨或自定义晚上。
   颜色	为主题定义的浅色和深色调色板。
   创建日期 (UTC+0000)	创建主题的日期和时间，采用 YYYY-MM-DD HH:MM:SS:ss 格式。
   用户选择	主题是否显示在应用程序外观主题列表中。如果主题显示在主题列表中，用户可以选择它以使主题对应用程序处于活动状态。
   默认	是否应将主题用作默认主题。默认主题成为空间中所有应用程序的活动主题。
   操作	管理员可以执行的操作，例如将主题 ZIP 文件下载到本地；使用 SAP 主题设计器的最新版本更新主题或在本地修改；或删除主题定义。

3. 选择 以添加新主题。在添加主题中，提供主题定义，然后选择保存。

   主题定义

   字段	描述
   主题名称	提供描述性名称以标识应用主题。主题的浅色和深色版本都使用此名称标识。保存后无法更改主题名称。
   浅色主题	浏览以选择应用主题的较亮版本。
   深色主题	浏览以选择应用主题的较暗版本。要了解有关实施 Android 深色主题的详细信息，请参阅深色主题。

4. 选择 以将 theme.zip 文件下载到您的本地设备。或者您可以更新文件以更改主题。

5. 选择更新以使用最新版本更新主题。您可以：

   • 上传主题设计器 zip - 选择此选项以上传最新的浅色或深色主题版本。

   • 上传已处理主题 zip - 如果您在本地修改文件以更改主题定义，则选择此选项以上传修改的 ZIP 文件。

6. 选择 以删除主题。

在应用级别管理主题

（仅限本机/MDK）您可以管理可用于所选应用程序的主题。

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

2. 选择应用程序，导航到设置标签，然后选择客户端设置。

3. 选择客户端配置标签。

4. 在外观下，确保已选择启用自定义主题。

5. 查看已上传的主题列表。主题列表反映应用主题管理器中进行的设置。请参阅管理应用主题。

6. 在活动列中，选择要为所选应用程序激活的主题，然后保存。主题的浅色和深色版本都可供移动客户端用户选择。

应用程序主题颜色映射

描述应用程序主题管理器在针对 iOS 和 Android 的 Web 颜色和运行时应用颜色之间使用的颜色映射。

iOS 颜色映射

Web 颜色	浅色主题	深色主题
sapBrandColor	@tintColor @tintColor_elevatedLightBackground @tintColor2 @tintColor2_elevatedLightBackground @tintColorTapState @tintColorTapState_elevatedLightBackground	@tintColor_darkBackground @tintColor_elevatedDarkBackground @tintColor2_darkBackground @tintColor2_elevatedDarkBackground @tintColorTapState_darkBackground @tintColorTapState_elevatedDarkBackground
sapShellColor	@header @header_elevatedLightBackground @headerBlended @headerBlended_elevatedLightBackground @barTransparent @barTransparent_elevatedLightBackground	@header_darkBackground @header_elevatedDarkBackground @headerBlended_darkBackground @headerBlended_elevatedDarkBackground @barTransparent_darkBackground @barTransparent_elevatedDarkBackground
sapBaseColor	@primaryBackground @primaryBackground_elevatedLightBackground @tertiaryBackground @tertiaryBackground_elevatedLightBackground @secondaryGroupedBackground @secondaryGroupedBackground_elevatedLightBackground	@primaryBackground_darkBackground @primaryBackground_elevatedDarkBackground @tertiaryBackground_darkBackground @tertiaryBackground_elevatedDarkBackground @secondaryGroupedBackground_darkBackground @secondaryGroupedBackground_elevatedDarkBackground
sapBackgroundColor	@secondaryBackground @secondaryBackground_elevatedLightBackground @primaryGroupedBackground @primaryGroupedBackground_elevatedLightBackground @tertiaryGroupedBackground @tertiaryGroupedBackground_elevatedLightBackground	@secondaryBackground_darkBackground @secondaryBackground_elevatedDarkBackground @primaryGroupedBackground_darkBackground @primaryGroupedBackground_elevatedDarkBackground @tertiaryGroupedBackground_darkBackground @tertiaryGroupedBackground_elevatedDarkBackground
sapShell_TextColor	@customColor1 @customColor1_elevatedLightBackground @navBarTitleLabel @navBarTitleLabel_elevatedLightBackground	@customColor1_darkBackground @customColor1_elevatedDarkBackground @navBarTitleLabel_darkBackground @navBarTitleLabel_elevatedDarkBackground
sapTextColor	@primaryLabel @primaryLabel_elevatedLightBackground	@primaryLabel_darkBackground @primaryLabel_elevatedDarkBackground
sapContent_LabelColor	@secondaryLabel @secondaryLabel_elevatedLightBackground @tertiaryLabel @tertiaryLabel_elevatedLightBackground @quarternaryLabel @quarternaryLabel_elevatedLightBackground	@secondaryLabel_darkBackground @secondaryLabel_elevatedDarkBackground @tertiaryLabel_darkBackground @tertiaryLabel_elevatedDarkBackground @quarternaryLabel_darkBackground @quarternaryLabel_elevatedDarkBackground
sapNegativeColor	@negativeLabel @negativeLabel_elevatedLightBackground	@negativeLabel_darkBackground @negativeLabel_elevatedDarkBackground
sapCriticalColor	@criticalLabel @criticalLabel_elevatedLightBackground	@criticalLabel_darkBackground @criticalLabel_elevatedDarkBackground
sapPositiveColor	@positiveLabel @positiveLabel_elevatedLightBackground	@positiveLabel_darkBackground @positiveLabel_elevatedDarkBackground

Android 颜色映射

Web 颜色	浅色主题	深色主题
sapBrandColor	s2 t4 t6 t7 b3 b4 r3	s2_dark t4_dark t6_dark t7_dark b3_dark b4_dark r3_dark
sapShellColor	s6	s6_dark
sapBaseColor	s1	s1_dark
sapBackgroundColor	s0 s4	s0_dark s4_dark
sapShell_TextColor	t8	t8_dark
sapTextColor	t1	t1_dark
sapContent_LabelColor	t2 t3	t2_dark t3_dark
sapNegativeColor	semantic_negative	semantic_negative_dark
sapCriticalColor	semantic_critical	semantic_critical_dark
sapPositiveColor	semantic_positive	semantic_positive_dark

---

最后更新: November 4, 2025