阿里云首页 移动开发平台 mPaaS 相关技术圈

工程管理

本文介绍了蚂蚁动态卡片的工程配置信息。

工程目录结构

一个有效的卡片工程由位于工程根目录下的一个配置文件 .act.config.json 和一组卡片描述文件 .vue.css.json 等组成,目录结构如下所示:
.
├── dist            //   编译结果文件夹(执行“编译”操作时自动生成)
│   ├── app.manifest      //  应用配置信息(命名格式固定)
│   ├── test_cube        
|   |   ├── main.bin            //    编译产物的二进制文件
|   |   ├── main.json           //    编译产物的 JSON 格式文件
|   |   ├── main.mock           //    mock.json 的编译产物
|   |   ├── main.zst            //    编译产物的压缩包
|   |   ├── main.js             //    编译产物的JS逻辑段,便于运行时排查JS段异常
|   |   └── main.zip            //    针对卡片所有产物的整体打包文件
├── test_cube
│   ├── main.vue          //  【必需】卡片源码文件,文件名不可改变
│   ├── mock.json        //  【可选】卡片 mock 数据
│   ├── manifest.json    //  【必需】卡片编译配置文件,文件名不可改变
|   └── main.css          //  【可选】卡片样式文件
└── .act.config.json      //  【必需】工程配置文件,文件名不可改变

.act.config.json

.act.config.json 是卡片工程的配置文件,当前由蚂蚁动态卡片命令行工具生成,无需修改,不需关注。

说明

.act.config.json 必需位于工程的根目录下。

//.act.config.json

{
  "type": "templates",      //必填,工程类型,取值支持 templates(普通卡片)
}

manifest.json

manifest.json 是对应卡片的编译配置文件,当前由蚂蚁动态卡片命令行工具生成,无需修改,不需关注。

说明

manifest.json 必需同对应的卡片 main.vue 位于同一路径下。

//        manifest.json

{
  "name": "my-card",                   //选填,卡片名称,卡片发布后以卡片后台 ID 为准。
  "version": "x.x.x",                  //选填,卡片版本,卡片发布后以卡片后台版本为准。
  "compilerType": 1,                   //选填,卡片编译模式,0(静态卡片) | 1(动态卡片,支持 JS,推荐使用),默认 0。
  "jsformat": 1,                       //选填,卡片JS编译格式,0(表达式导出) | 1(IIFE 导出,支持 JS import,推荐使用),默认 0。
  "js_lib": 0,                         //选填,运行时 JS 载入的类库,主要用于优化运行时卡片内存,按需配置,可以通过按位与操作后配置多个 JS 类库;0(基础库) | 1(Base64 库) | 2(wasm 库) | 4(Probuf 库),默认全部载入。
  "js_kernel": 0,                      //选填,运行时 JS 载入的内核模块,主要用于优化运行时卡片内存,按需配置,可以通过按位与操作后配置多个 JS 类库;0(基础模块) | 1(Date 模块) | 2(RegExp 模块) | 4(TypeArrays 模块) | 8(Promise 模块),默认全部载入。
  "immutable": false,                  //选填,是否为不可变模板,适用于运行时内存优化场景,默认 false。
  "miniCubeVersion": "x.x.x",          //选填,卡片适用的 Cube 引擎最小版本号。
}

工程示例

test_cube.zip