创建Addon应用

什么是Addon应用

当需要基于已有资产包类型的应用或解决方案（不是单一的应用，某一解决方案会涉及到多个应用）进行定制时，可以选择Addon应用类型创建应用。

使用该方式创建的应用，会继承原有应用或者解决方案包里的应用设置，如站点设置、导航条等，可将原有应用或者解决方案包里应用的组件资产添加到Addon应用里进行定制，复用已有资产，满足业务需求，大大提高开发效率。

基于已有应用创建Addon应用

例如，基于“Facility Management”（设施管理）应用创建Addon应用，需要提前安装好“Facility Management”资产包。

图1 开发环境首页“库”页签中资产

1. 参考如何进入经典开发环境中操作，进入经典版开发环境。
2. 在“首页 > 项目”页签中，单击“行业应用”，再单击“创建Addon应用”。
3. 设置标签和名称，选择依赖的解决方案或者App，单击“创建”。
   图2 创建Addon应用
   

   表1 Addon应用基本信息

   参数	参数说明
   添加图标	新建Addon应用的图标。
   标签	Addon应用展示的名称。
   名称	Addon应用在系统内的唯一标识。输入标签值后单击该参数的输入框，系统会自动生成Addon应用的名称。系统会自动在该名称前，添加命名空间__。
   分类	Addon应用所属的分类。
   描述	描述信息。
   高级设置 > 运行时版本	开发的资产包依赖所选择的运行时版本，若线下运行版本不一致，可能会不兼容。
   依赖	依赖的应用或者解决方案。 须知： 依赖的应用必须为资产包类型，即依赖的应用为开发环境首页“库”页签中存在的应用。因为源码包类型的应用包，包中组件不受保护，可直接进行定制开发，而资产包中的组件是受保护的，当需要基于资产包中组件进行定制时，可创建基于该资产包应用创建Addon应用进行定制开发。

   创建后，页面跳转到Addon应用开发页面，在页面上方为Addon应用定制内容，“External dependencies”里为依赖的应用目录树。

   图3 Addon应用开发页面
   

4. 开发定制内容，如基于依赖应用中的服务编排进行定制。
   1. 鼠标放在Addon应用定制目录下的Logic文件夹上，会出现加号，单击“+”，选择“服务编排”。
   2. 在“添加服务编排”页面，选中“使用已有的服务编排”，勾选需要依赖的服务编排，单击“添加”。
      图4 添加服务编排
      

      添加后，在Addon应用定制目录下的Logic文件夹中，会显示该定制服务编排。

      图5 添加结果
      
   3. 在该服务编排开发页面，定制新功能。定制后，单击，选择新版本或新服务编排保存。
      

      在后续将Addon应用打包时，只能将定制内容打包出去，依赖的内容不会随Addon应用打包发布出去。关于打包操作的详细介绍，请参见如何编译发布应用。

基于解决方案创建Addon应用

1. 参考如何进入经典开发环境中操作，进入经典版开发环境。
2. 在“首页 > 项目”页签中，单击“行业应用”，再单击“创建Addon应用”。
3. 设置标签和名称，选择依赖的解决方案，单击“创建”。
   图6 创建Addon应用
   

   创建后，页面跳转到Addon应用合集开发页面，由于依赖的解决方案中有两个App，可选择具体的App进行定制。

   图7 Addon应用开发页面
   

4. 单击Addon应用后的“+”，选择需要依赖的App，单击“创建”，创建子Addon应用。
   图8 创建子Addon应用
   

   创建成功后，显示如图9所示页面。

   图9 创建成功显示页面
   

5. 双击上一步创建的子Addon应用名称，进入子Addon应用，可依赖于基于的应用进行开发定制，定制过程和基于已有应用创建Addon应用类似。
   图10 进入子Addon应用
   

6. 定制后单击上方菜单的第一层级，例如“testaddon”，进入Addon App合集开发页面，也可以基于第二个应用继续创建子Addon应用进行定制开发。

   定制完成后，可对整个Addon应用合集进行打包发布，打包操作可参考如何编译发布应用。打包时，只能将定制内容打包出去，依赖的内容不会随Addon应用打包发布出去。