交行定制版 · 版本更新指南

!

更新机制总览

先理解项目结构和两种升级场景

交行定制版基于云枢产品主线（8.7.x）二次开发。前端项目中有两类包，升级方式完全不同：

类型	包含哪些	升级方式
项目工程包	admin、portal、mobile、extension-template、cloudpivot-form-extend	从 FTP 拉取新代码 → Git 合并二开代码
定制依赖包	cloudpivot、cloudpivot-admin-core、cloudpivot-designer、cloudpivot-form、cloudpivot-list、extension-bankcomm	只需修改 `resolutions` 版本号

i

核心区别：项目工程包是你直接修改过的代码，需要 Git 合并来同步产品更新；定制依赖包是通过版本号引用的，升级时改个数字就行。后端同理，二开工程只需修改产品依赖版本号即可。

A

场景 A：升级项目工程包（需要 Git 合并）

产品发版时 FTP 上会放新的工程代码，需要把你的二开代码合并进去

FTP 上发布的是产品的项目工程代码（不是依赖包）。浏览器打开 FTP 地址，选择最新日期的目录下载：

FTP 地址

https://packages.cloudpivot.cn/beta/

目录命名规则：{分支名}-{日期YYYYMMDD}，下载后包含以下目录：

/beta/feature-8.7.x-bankcomm-YYYYMMDD/
  └── packages/
      ├── admin/ ← 管理后台
      ├── cloudpivot-form-extend/ ← 表单扩展
      ├── extension-template/ ← 扩展模板
      ├── mobile/ ← 移动端
      └── portal/ ← 用户门户

拿到后，你需要将自己的二开代码合并进去。推荐使用 Git 操作：

Terminal — 首次升级 / 后续补丁升级

# 1. 确保当前二开代码已全部提交
git add -A && git commit -m "chore: 升级前保存二开代码"

# 2. 创建一个临时分支，将 FTP 的产品代码放进来
git checkout -b upgrade/bankcomm-YYYYMMDD

# 3. 将 FTP 下载的 packages 目录覆盖到对应位置
#    （admin/、mobile/、portal/ 等工程目录）
cp -r /path/to/ftp/packages/admin ./packages/admin
cp -r /path/to/ftp/packages/mobile ./packages/mobile
cp -r /path/to/ftp/packages/portal ./packages/portal
# ... 其他有更新的目录

# 4. 提交产品新代码
git add -A && git commit -m "chore: 导入产品包 bankcomm-YYYYMMDD"

# 5. 切回你的开发分支，合并产品代码
git checkout feature-8.7.x-bankcomm
git merge upgrade/bankcomm-YYYYMMDD

# 6. 解决冲突（如果有），然后提交
#    冲突通常出现在你二开修改过的文件中
git add -A && git commit

!

合并冲突处理：产品代码更新与你的二开代码修改了同一文件时会产生冲突。需要逐个检查冲突文件，保留二开逻辑的同时接受产品的修复和新功能。

i

首次升级 vs 后续补丁：流程一样 — 都是拿到 FTP 新代码后 Git 合并。首次升级冲突可能较多，后续补丁升级通常冲突很少。

B

场景 B：升级定制依赖包（只改版本号）

如果只更新 cloudpivot 系列依赖包，无需合并代码

定制依赖包通过 resolutions 引用，升级时只需要修改版本号，不需要替换任何代码文件。

打开项目根目录的 package.json，找到末尾的 resolutions 字段：

package.json — resolutions

"resolutions": {
  "cloudpivot":            "1.1.0-ai-platform-bankcomm-X.Y",
  "cloudpivot-admin-core": "1.1.0-ai-platform-bankcomm-X.Y",
  "cloudpivot-designer":   "1.1.0-ai-platform-bankcomm-X.Y",
  "cloudpivot-form":       "1.1.0-ai-platform-bankcomm-X.Y",
  "cloudpivot-list":       "1.1.0-ai-platform-bankcomm-X.Y",
  "extension-bankcomm":   "1.1.0-ai-platform-bankcomm-X.Y"
}

示例：将 cloudpivot 从 2.1 升级到 2.2：

版本号变更示例

// 只需把版本号改一下
"cloudpivot": "1.1.0-ai-platform-bankcomm-2.1"
       ↓
"cloudpivot": "1.1.0-ai-platform-bankcomm-2.2"

!

注意：不同包的版本号不一定同步更新。产品团队会通知哪些包有更新以及对应的新版本号。只更新需要升级的包即可。

✓

自动同步：项目内置 sync-local-versions.js（preinstall 钩子），yarn install 时会自动将所有包对定制包的引用对齐为 resolutions 中声明的版本。

!

安装依赖并构建

无论哪种场景，最后都需要执行

Terminal

# 1. 安装依赖（preinstall 会自动同步版本）
yarn install

# 2. 构建全部端（portal + mobile + admin）
yarn build:all

# 或者按需单独构建
yarn build:portal   # 用户门户
yarn build:admin    # 管理后台
yarn build:mobile   # 移动端

✕

常见问题：如果 yarn install 报版本冲突，检查 resolutions 版本号是否正确。必要时删除 node_modules 和 yarn.lock 后重试。

1

修改二开工程依赖版本号

后端升级只需修改版本号，无需替换代码

后端的更新方式非常简单。产品团队发布新版本后，只需在二开工程的依赖配置中，将云枢产品包的版本号更新为最新版本即可。

i

原理：后端二开工程通过 Maven / Gradle 依赖管理引用产品包。产品补丁更新时，产品团队会将新版本发布到私有仓库，二开工程只需修改 pom.xml 或 build.gradle 中的版本号，构建时会自动拉取最新的产品包。

以 Maven 项目为例，在二开工程的 pom.xml 中找到产品依赖版本，更新为新版本号：

pom.xml — 版本号变更示例

<!-- 更新前 -->
<properties>
  <cloudpivot.version>x.x.x-旧版本</cloudpivot.version>
</properties>

<!-- 更新后 -->
<properties>
  <cloudpivot.version>x.x.x-新版本</cloudpivot.version>
</properties>

!

注意：修改前请确认产品团队已将新版本发布到私有 Maven 仓库。版本号由产品团队在发版时通知。

2

重新构建部署

拉取新依赖并打包

Terminal

# Maven 项目
mvn clean package -DskipTests

# 或 Gradle 项目
gradle clean build -x test

构建完成后按正常流程部署即可。二开工程中的定制代码无需任何修改。

✓

小结：后端升级 = 改版本号 + 重新构建，无需替换代码文件，非常简单。

✓

2026-04-24 发布

6 个定制包 · 已发布 4 · 跳过 2（已发布）

包名	版本号	状态	发布地址
`cloudpivot`	`1.1.0-ai-platform-bankcomm-2.1`	已发布	nexus01.authine.cn/npm-cloudpivot
`cloudpivot-admin-core`	`1.1.0-ai-platform-bankcomm-2.1`	已发布	nexus01.authine.cn/npm-cloudpivot
`cloudpivot-designer`	`1.1.0-ai-platform-bankcomm-2.1`	已发布	nexus01.authine.cn/npm-cloudpivot
`extension-bankcomm`	`1.1.0-ai-platform-bankcomm-2.0`	已发布	nexus01.authine.cn/npm-cloudpivot
`cloudpivot-form`	`1.1.0-ai-platform-bankcomm-2.0`	跳过 (已发布)	nexus01.authine.cn/npm-cloudpivot
`cloudpivot-list`	`1.1.0-ai-platform-bankcomm-2.0`	跳过 (已发布)	nexus01.authine.cn/npm-cloudpivot