开发者中心

品牌形象插件

概述

在以下文档中,您将了解如何开发一个更改应用程序品牌形象的插件。

在开始使用品牌形象插件之前,我们建议您参考介绍应用程序和插件基本概念的介绍以及"Hello world!"演示插件。

您可以在存储库cumulocity-ui-plugin-examples中的文档中找到相关插件。

品牌形象插件

品牌形象示例

我们的主要CSS是基于流行的CSS框架Bootstrap 3。可以通过简单地覆盖较少变量,基于QuarkIoE的基础品牌形象建立一个品牌形象插件。

由于myBranding示例比其他插件更易扩展,将myBranding文件夹复制到您的plugins文件夹中。 虽然有几个文件,但策略是直接的:定义较少的变量,覆盖基本主题c8yBranding上的设置。

您可以检查较少的文件,以查看可用于配置的变量。

由于品牌插件仅通过其名称进行区分,因此名称必须是唯一的。此外,它必须以品牌形象 (例如 piedpiperBranding)结束。要在应用程序中使用它,请将其添加到应用程序清单的exports语句中,如cumulocity-ui-plugin-examples库。

确保只有一个品牌插件被声明,否则两者都将被加载。要替换核心应用程序中的c8yBranding插件,您必须创建一个至少具有以下内容的目标.json文件:


    {
      "name": "Examples",
      "comment": "Release with new branding plugin",
      "replaceImports": {
      "core/c8yBranding": "myapplication/myBranding"
    }
  }