From 391ac3a915a73d84577399124ec369ffa90f44bd Mon Sep 17 00:00:00 2001 From: XuqmGroup Date: Sat, 23 May 2026 01:20:58 +0800 Subject: [PATCH] =?UTF-8?q?chore(ci):=20=E6=9B=B4=E6=96=B0=20Jenkins=20?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E4=BB=A5=E6=94=AF=E6=8C=81=E5=A4=9A=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E7=89=88=E6=9C=AC=E7=AE=A1=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 为 Android、Flutter、iOS 和 RN SDK 的 Jenkinsfile 添加模块化版本控制 - 引入版本升级策略选择（major/minor/patch）和自定义版本号功能 - 实现多模块独立版本管理和选择性构建发布 - 更新 iOS SDK Package.swift 以支持独立模块化库 - 修改 iOS SDK podspec 文件以适应新的标签命名约定 - 优化 Jenkins 构建流程以支持按需选择特定模块进行构建和发布 - 修复 iOS 测试中的可选类型转换问题以提高代码健壮性 --- Jenkinsfile | 191 +++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 174 insertions(+), 17 deletions(-) diff --git a/Jenkinsfile b/Jenkinsfile index f6eb1a3..1c8a6fc 100644 --- a/Jenkinsfile +++ b/Jenkinsfile @@ -12,32 +12,142 @@ pipeline { disableConcurrentBuilds() } + parameters { + // ── 版本升级策略 ───────────────────────────────────────────────────── + choice(name: 'VERSION_BUMP', defaultValue: 'patch', + description: '版本升级策略: major(1.0.0→2.0.0), minor(1.0.0→1.1.0), patch(1.0.0→1.0.1)') + booleanParam(name: 'CUSTOM_VERSION', defaultValue: false, + description: '勾选后使用下方自定义版本号（忽略VERSION_BUMP）') + + // ── 模块自定义版本号（仅CUSTOM_VERSION=true时生效）─────────────────── + string(name: 'COMMON_VERSION', defaultValue: '', description: '@xuqm/rn-common 自定义版本号（仅CUSTOM_VERSION=true时生效）') + string(name: 'IM_VERSION', defaultValue: '', description: '@xuqm/rn-im 自定义版本号') + string(name: 'PUSH_VERSION', defaultValue: '', description: '@xuqm/rn-push 自定义版本号') + string(name: 'UPDATE_VERSION', defaultValue: '', description: '@xuqm/rn-update 自定义版本号') + string(name: 'XWEBVIEW_VERSION',defaultValue: '', description: '@xuqm/rn-xwebview 自定义版本号') + string(name: 'LICENSE_VERSION', defaultValue: '', description: '@xuqm/rn-license 自定义版本号') + + // ── 模块选择（每行一个）────────────────────────────────────────── + text(name: 'MODULES', defaultValue: 'common\nim\npush\nupdate\nxwebview\nlicense', + description: '要发布的模块，每行一个。可选: common im push update xwebview license') + } + stages { + + // ── 1. 检出代码 ───────────────────────────────────────────────────────── stage('Checkout') { steps { checkout([ - $class: 'GitSCM', - branches: [[name: 'main']], - extensions: [[$class: 'CleanBeforeCheckout']], - userRemoteConfigs: scm.userRemoteConfigs + $class: 'GitSCM', + branches: [[name: 'main']], + extensions: [[$class: 'CleanBeforeCheckout']], + userRemoteConfigs: scm.userRemoteConfigs ]) script { - env.GIT_COMMIT_SHORT = bat(script: '@git rev-parse --short HEAD', returnStdout: true).trim() - env.PUBLISH_VERSION = bat(script: '@node -p "require(\'./package.json\').version"', returnStdout: true).trim() + env.GIT_COMMIT_SHORT = bat( + script: '@git rev-parse --short HEAD', + returnStdout: true + ).trim() + + // ── 解析选中的模块 ────────────────────────────────────────── + // 映射：参数名 → [目录, npm包名, 版本参数值] + def moduleMap = [ + common: ['packages/common', '@xuqm/rn-common', params.COMMON_VERSION], + im: ['packages/im', '@xuqm/rn-im', params.IM_VERSION], + push: ['packages/push', '@xuqm/rn-push', params.PUSH_VERSION], + update: ['packages/update', '@xuqm/rn-update', params.UPDATE_VERSION], + xwebview: ['packages/xwebview', '@xuqm/rn-xwebview', params.XWEBVIEW_VERSION], + license: ['packages/license', '@xuqm/rn-license', params.LICENSE_VERSION], + ] + + def requestedModules = params.MODULES + .split(/\r?\n/) + .collect { it.trim() } + .findAll { it && moduleMap.containsKey(it) } + + if (requestedModules.isEmpty()) { + error "MODULES param is empty or contains no valid module names." + } + + // 保存为逗号分隔的环境变量供后续阶段使用 + env.SELECTED_MODULES = requestedModules.join(',') + + // ── 解析版本号 ────────────────────────────────────────── + for (mod in requestedModules) { + def (dir, pkg, ver) = moduleMap[mod] + if (params.CUSTOM_VERSION && ver?.trim()) { + // 使用自定义版本号 + echo "Overriding ${pkg} version → ${ver.trim()}" + bat """ + node -e "var fs=require('fs'),p='${dir}/package.json',j=JSON.parse(fs.readFileSync(p,'utf8'));j.version='${ver.trim()}';fs.writeFileSync(p,JSON.stringify(j,null,2)+'\\n','utf8');console.log('Updated '+p+' to '+j.version)" + """ + } else if (!params.CUSTOM_VERSION) { + // 自动升级版本号 + def currentVer = bat( + script: "@node -p \"require('./${dir}/package.json').version\"", + returnStdout: true + ).trim() + def parts = currentVer.tokenize('.') + while (parts.size() < 3) { parts.add('0') } + switch (params.VERSION_BUMP) { + case 'major': + parts[0] = (parts[0].toInteger() + 1).toString() + parts[1] = '0' + parts[2] = '0' + break + case 'minor': + parts[1] = (parts[1].toInteger() + 1).toString() + parts[2] = '0' + break + case 'patch': + default: + parts[2] = (parts[2].toInteger() + 1).toString() + break + } + def newVer = parts.join('.') + echo "Auto-bumping ${pkg}: ${currentVer} → ${newVer}" + bat """ + node -e "var fs=require('fs'),p='${dir}/package.json',j=JSON.parse(fs.readFileSync(p,'utf8'));j.version='${newVer}';fs.writeFileSync(p,JSON.stringify(j,null,2)+'\\n','utf8');console.log('Updated '+p+' to '+j.version)" + """ + } + } } } } - stage('Build Info') { + // ── 2. 发布信息 ───────────────────────────────────────────────────────── + stage('Publish Info') { steps { - echo "发布版本: ${env.PUBLISH_VERSION} ⚠ 发布前请确认已在 package.json 中更新版本号" - echo "Git Commit: ${env.GIT_COMMIT_SHORT}" + script { + def selected = env.SELECTED_MODULES.split(',') + def dirMap = [ + common: 'packages/common', + im: 'packages/im', + push: 'packages/push', + update: 'packages/update', + xwebview: 'packages/xwebview', + license: 'packages/license', + ] + echo "Git Commit : ${env.GIT_COMMIT_SHORT}" + echo "Modules to publish (${selected.size()}):" + for (mod in selected) { + def dir = dirMap[mod] + def ver = bat( + script: "@node -p \"require('./${dir}/package.json').version\"", + returnStdout: true + ).trim() + echo " ${mod.padRight(10)} (${dir}) → v${ver}" + } + } } } + // ── 3. 安装依赖 ───────────────────────────────────────────────────────── stage('Install Dependencies') { steps { - withCredentials([usernamePassword(credentialsId: 'NEXUS_CREDS', passwordVariable: 'NPM_PASS', usernameVariable: 'NPM_USER')]) { + withCredentials([usernamePassword(credentialsId: 'NEXUS_CREDS', + passwordVariable: 'NPM_PASS', + usernameVariable: 'NPM_USER')]) { bat """ powershell -NonInteractive -Command "\$auth=[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(\$env:NPM_USER+':'+\$env:NPM_PASS)); Set-Content .npmrc ('@xuqm:registry=https://nexus.xuqinmin.com/repository/npm-hosted/' + [char]10 + '//nexus.xuqinmin.com/repository/npm-hosted/:_auth=' + \$auth) -Encoding ASCII" npm install --legacy-peer-deps @@ -46,12 +156,30 @@ pipeline { } } + // ── 4. 类型检查 ───────────────────────────────────────────────────────── stage('Type Check') { steps { - bat 'npm run typecheck:all || ver>nul' + script { + // 在每个选中的包目录运行类型检查（允许失败） + def selected = env.SELECTED_MODULES.split(',') + def dirMap = [ + common: 'packages/common', + im: 'packages/im', + push: 'packages/push', + update: 'packages/update', + xwebview: 'packages/xwebview', + license: 'packages/license', + ] + for (mod in selected) { + def dir = dirMap[mod] + echo "Type-checking ${mod} (${dir})" + bat "cd ${dir} && npm run typecheck || ver>nul" + } + } } } + // ── 5. 测试 ──────────────────────────────────────────────────────────── stage('Tests') { steps { bat 'npm test > test-results.txt 2>&1 || ver>nul' @@ -63,13 +191,39 @@ pipeline { } } + // ── 6. 发布到 Nexus ───────────────────────────────────────────────────── stage('Publish to Nexus') { steps { - withCredentials([usernamePassword(credentialsId: 'NEXUS_CREDS', passwordVariable: 'NPM_PASS', usernameVariable: 'NPM_USER')]) { - bat """ - powershell -NonInteractive -Command "\$auth=[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(\$env:NPM_USER+':'+\$env:NPM_PASS)); Set-Content .npmrc ('@xuqm:registry=https://nexus.xuqinmin.com/repository/npm-hosted/' + [char]10 + '//nexus.xuqinmin.com/repository/npm-hosted/:_auth=' + \$auth) -Encoding ASCII" - npm publish --workspaces --registry %NEXUS_REGISTRY% - """ + withCredentials([usernamePassword(credentialsId: 'NEXUS_CREDS', + passwordVariable: 'NPM_PASS', + usernameVariable: 'NPM_USER')]) { + script { + // 写入带认证信息的 .npmrc + bat """ + powershell -NonInteractive -Command "\$auth=[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(\$env:NPM_USER+':'+\$env:NPM_PASS)); Set-Content .npmrc ('@xuqm:registry=https://nexus.xuqinmin.com/repository/npm-hosted/' + [char]10 + '//nexus.xuqinmin.com/repository/npm-hosted/:_auth=' + \$auth) -Encoding ASCII" + """ + + def selected = env.SELECTED_MODULES.split(',') + def dirMap = [ + common: 'packages/common', + im: 'packages/im', + push: 'packages/push', + update: 'packages/update', + xwebview: 'packages/xwebview', + license: 'packages/license', + ] + + for (mod in selected) { + def dir = dirMap[mod] + echo "Publishing ${mod} from ${dir}" + // 复制 .npmrc 到包目录，发布，然后清理 + bat """ + copy .npmrc ${dir}\\.npmrc + cd ${dir} && npm publish --registry %NEXUS_REGISTRY% + del ${dir}\\.npmrc 2>nul || exit 0 + """ + } + } } } post { @@ -82,7 +236,10 @@ pipeline { post { success { - echo "RN SDK v${env.PUBLISH_VERSION} 构建成功 (Commit: ${env.GIT_COMMIT_SHORT})" + script { + def selected = env.SELECTED_MODULES?.split(',') ?: [] + echo "RN SDK 构建成功 — 已发布模块: ${selected.join(', ')} (Commit: ${env.GIT_COMMIT_SHORT})" + } } failure { echo "RN SDK 构建失败，请检查日志"