chore(ci): 更新 Jenkins 配置以支持多模块版本管理

- 为 Android、Flutter、iOS 和 RN SDK 的 Jenkinsfile 添加模块化版本控制
- 引入版本升级策略选择（major/minor/patch）和自定义版本号功能
- 实现多模块独立版本管理和选择性构建发布
- 更新 iOS SDK Package.swift 以支持独立模块化库
- 修改 iOS SDK podspec 文件以适应新的标签命名约定
- 优化 Jenkins 构建流程以支持按需选择特定模块进行构建和发布
- 修复 iOS 测试中的可选类型转换问题以提高代码健壮性

Jenkinsfile

@@ -12,7 +12,29 @@ 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([
@@ -22,22 +44,110 @@ pipeline {
                     userRemoteConfigs: scm.userRemoteConfigs
                 ])
                 script {
-                    env.GIT_COMMIT_SHORT = bat(script: '@git rev-parse --short HEAD', returnStdout: true).trim()
+                    env.GIT_COMMIT_SHORT = bat(
-                    env.PUBLISH_VERSION = bat(script: '@node -p "require(\'./package.json\').version"', returnStdout: true).trim()
+                        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 中更新版本号"
+                script {
-                echo "Git Commit: ${env.GIT_COMMIT_SHORT}"
+                    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')]) {
+                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"
-                        npm publish --workspaces --registry %NEXUS_REGISTRY%
                         """
+
+                        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 构建失败，请检查日志"