uni-app x 类型

配置环境

当前目录建立 .env 文件。

UNI_CORE_DIR="%vuejs-core 仓库路径%/packages/uni-ext-api/src"
UNI_UTS_PLUGIN_API_DIR="%新 uni-app 仓库路径%/api"
UNI_UTS_PLUGIN_MODULES_DIR="%dcloud-uts 仓库路径%/uni_modules"
UNI_COMPLIER_META_DIR="%旧 uni-app 仓库路径%/packages/uni-uts-v1/lib/ext-api"
# 可选。不配置时默认使用项目根目录下的 .uni-module-projects-cache
UNI_MODULE_PROJECTS_CACHE_DIR="%插件项目缓存目录%"

聚合单独插件项目

单独插件项目由构建脚本动态发现，构建时会自动聚合并同步到当前仓库对应分支。

构建脚本会从 GitLab uni-app-x group 搜索名称包含 uni-module 的项目，只保留项目名以 uni-module 开头的仓库。同时会把 uni-app-module-build-config 仓库克隆到缓存目录，并切换到当前仓库对应分支后读取其中的 config.json 黑名单配置；projects[].builtIn === false 的项目会被过滤，builtIn === true 的项目不会过滤。

说明：

• 当前仓库如果在 master 分支，构建脚本会自动映射到插件项目的 main 分支。
• 如果未配置 UNI_MODULE_PROJECTS_CACHE_DIR，脚本会使用项目根目录下的 .uni-module-projects-cache 作为默认缓存目录；该目录已加入 .gitignore。

构建时脚本会对动态发现并过滤后的每个项目执行以下流程：

• 首次构建时自动 git clone
• 后续构建时自动 git fetch --all --prune
• 切换到当前仓库对应分支
• 执行 git pull --ff-only
• 从各项目的 uni_modules/ 中收集插件并参与 dts 构建

如果某个缓存仓库的未提交改动阻碍分支切换或 git pull --ff-only，构建会按 Git 错误停止。

如果多个来源中存在相同的 uni_modules/<plugin>/utssdk/interface.* 相对路径，构建会输出告警并使用后出现的来源。

构建

构建框架内置 Uni Api：

pnpm build:types:core

构建插件 API：

pnpm build:types:plugin:api

构建插件组件类型与 vuedoc：

pnpm build:types:plugin:component

构建业务插件类型：

pnpm build:types:plugin:biz

生成默认参数数据到编译器：

pnpm build:types:meta