// 统一Jenkins构建配置 (Melos Monorepo版本) // 同时支持开发和生产环境 pipeline { agent any options { // 超时时间 timeout(time: 45, unit: 'MINUTES') // 保留构建历史 buildDiscarder(logRotator(numToKeepStr: '20')) // 时间戳显示 timestamps() // 彩色输出 ansiColor('xterm') } environment { // 基础配置 PROJECT_NAME = 'Learning Officer OA' APP_NAME = 'LearningOfficerOA' FVM_VERSION = '3.38.9' // 构建模式 (始终使用 release 获得最佳性能) BUILD_MODE = 'release' // 动态环境配置 (根据参数设置) ENVIRONMENT = "${params.BUILD_ENVIRONMENT}" // 归档配置 RELEASE_DIR = "${env.HOME}/release/oa/${params.BUILD_ENVIRONMENT}" // Melos Monorepo 配置 APP_DIR = 'apps/oa_app' // Fastlane和Flutter配置 LC_ALL = 'en_US.UTF-8' LANG = 'en_US.UTF-8' CI = 'true' FLUTTER_SUPPRESS_ANALYTICS = 'true' FLUTTER_NO_ANALYTICS = 'true' // PATH配置(使用环境变量,避免硬编码用户路径) PATH = "${env.HOME ?: '/Users/yuanxuan'}/.pub-cache/bin:/opt/homebrew/bin:/usr/local/bin:${env.PATH}" // 签名配置 KEYCHAIN_PATH = "${HOME}/Library/Keychains/login.keychain-db" KEYCHAIN_PASSWORD = "${KEYCHAIN_PASSWORD}" // 版本信息 APP_VERSION = '' BUILD_NUMBER = '' MAIN_APK_FOUND = 'false' } parameters { // 🎯 环境选择 (核心参数) choice( name: 'BUILD_ENVIRONMENT', choices: ['development', 'preview', 'production'], description: '🏗️ 构建环境: development(开发测试) | preview(预发布) | production(正式发布)' ) // 📱 平台选择 choice( name: 'PLATFORM', choices: ['android', 'ios', 'all'], description: '📱 构建平台: android | ios | all' ) // 🧹 清理构建 booleanParam( name: 'CLEAN_BUILD', defaultValue: true, description: '🧹 是否执行清理构建 (生产环境推荐开启)' ) // 🍎 iOS配置 (开发/预发布环境) booleanParam( name: 'UPLOAD_TESTFLIGHT', defaultValue: true, description: '🚀 是否自动上传iOS到TestFlight (仅开发/预发布环境有效)' ) // 🍎 iOS分发类型 (生产环境) choice( name: 'IOS_DISTRIBUTION_TYPE', choices: ['testflight', 'adhoc', 'appstore'], description: '🍎 iOS分发类型: adhoc(企业分发) | testflight(外部测试) | appstore(应用商店)' ) } stages { stage('🔧 环境初始化') { steps { script { echo "🚀 开始构建: ${PROJECT_NAME} [${params.BUILD_ENVIRONMENT}]" } sh ''' #!/bin/zsh set +x # 静默加载环境 [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 # 仅输出核心版本信息 if command -v fvm &> /dev/null; then echo " - Flutter: $(fvm flutter --version | head -1)" echo " - Melos: $(melos --version 2>/dev/null || echo '本地依赖')" else echo "❌ 错误: 未找到FVM环境" exit 1 fi ''' } } stage('📥 依赖管理') { steps { script { echo "📦 正在同步 Monorepo 依赖 (Bootstrap)..." sh ''' #!/bin/zsh set +x [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 # 使用 melos bootstrap 初始化所有包 melos bootstrap echo " ✅ 依赖同步完成" ''' } } } stage('📝 版本与生成') { steps { script { sh ''' #!/bin/zsh set +x [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 # 运行版本管理 (在 app 目录) # 运行版本管理 (从根目录运行 Dart 脚本,避免子目录缺少依赖) if [ -f "scripts/version_manager.dart" ]; then # 确保根目录依赖已准备好 (通常在 Bootstrap 阶段完成,但在某些 CI 环境可能需要显式 pub get) # dart pub get # 如果需要,取消注释 eval $(dart scripts/version_manager.dart ci-clean --path ${APP_DIR}/pubspec.yaml) echo " - 目标版本: ${APP_FULL_VERSION}" fi # 代码生成 (使用 melos run generate 覆盖所有包) echo " - 正在为所有包生成代码..." melos run generate echo " ✅ 代码生成完成" ''' } } } stage('🏗️ 编译构建') { steps { script { if (params.PLATFORM == 'android' || params.PLATFORM == 'all') { echo "🤖 正在构建 Android APK..." sh ''' #!/bin/zsh set +x [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 cd ${APP_DIR} if [ "${CLEAN_BUILD}" = "true" ]; then echo " - 执行 flutter clean..." fvm flutter clean fi fvm flutter build apk --release --dart-define=APP_ENV=${ENVIRONMENT} ''' echo " ✅ Android 构建成功" } if (params.PLATFORM == 'ios' || params.PLATFORM == 'all') { echo "🍎 正在构建 iOS IPA (via Melos)..." sh ''' #!/bin/zsh set -e [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 cd ${APP_DIR} if [ "${CLEAN_BUILD}" = "true" ]; then echo " - 执行 flutter clean..." fvm flutter clean fi # clean 后必须重新拉依赖,确保插件注册文件 (.dart_tool/flutter_build) 完整 echo " - 恢复 Flutter 依赖..." fvm flutter pub get # 统一更新 CocoaPods 仓库并按 Podfile 安装依赖 echo " - CocoaPods: repo update + install..." retry=0 until [ $retry -ge 3 ] do if (cd ios && pod install --repo-update); then echo " ✅ CocoaPods 依赖已就绪" break fi retry=$((retry+1)) echo " ⚠️ pod install 失败,重试 ${retry}/3..." sleep 3 done if [ $retry -ge 3 ]; then echo "❌ pod install 连续失败,停止构建" exit 1 fi cd - # Melos 脚本会自动进入 apps/oa_app 目录并执行,通过 -- 传递额外参数 melos run build:ipa -- --dart-define=APP_ENV=${ENVIRONMENT} ''' echo " ✅ iOS 构建成功" } } } } stage('🚀 上传 TestFlight') { when { allOf { anyOf { expression { params.BUILD_ENVIRONMENT == 'development' } expression { params.BUILD_ENVIRONMENT == 'preview' } } expression { params.UPLOAD_TESTFLIGHT == true } anyOf { expression { params.PLATFORM == 'ios' } expression { params.PLATFORM == 'all' } } } } steps { script { echo "📤 准备上传到 TestFlight..." sh ''' #!/bin/zsh set +x [ -f "$HOME/.zshrc" ] && source "$HOME/.zshrc" > /dev/null 2>&1 # 清理环境变量引号 export FASTLANE_APP_STORE_CONNECT_API_KEY_PATH=$(echo "${FASTLANE_APP_STORE_CONNECT_API_KEY_PATH}" | tr -d '"' | tr -d "'") export APP_STORE_CONNECT_API_KEY_KEY_ID=$(echo "${APP_STORE_CONNECT_API_KEY_KEY_ID}" | tr -d '"' | tr -d "'") export APP_STORE_CONNECT_API_KEY_ISSUER_ID=$(echo "${APP_STORE_CONNECT_API_KEY_ISSUER_ID}" | tr -d '"' | tr -d "'") # 获取绝对路径的 IPA 文件 ABS_IPA_PATH=$(ls -t $(pwd)/${APP_DIR}/build/ios/ipa/*.ipa 2>/dev/null | head -1) if [ -z "$ABS_IPA_PATH" ]; then echo "❌ 未找到IPA"; exit 1; fi echo " - 产物: $(basename $ABS_IPA_PATH)" if [ -f "fastlane/Gemfile" ]; then cd fastlane bundle install --quiet echo " - 正在上传 (应用 Fastfile 内部补丁)..." # 1. 清理环境,依赖 Fastfile 顶部的 require 解决兼容性 unset RUBYOPT # 2. 设置 Fastlane 官方环境变量 export SPACESHIP_CONNECT_API_KEY_ID="$APP_STORE_CONNECT_API_KEY_KEY_ID" export SPACESHIP_CONNECT_API_ISSUER_ID="$APP_STORE_CONNECT_API_KEY_ISSUER_ID" export SPACESHIP_CONNECT_API_KEY_PATH="$FASTLANE_APP_STORE_CONNECT_API_KEY_PATH" # 3. 执行上传 (使用绝对路径) bundle exec fastlane upload_to_testflight_with_key ipa:"$ABS_IPA_PATH" fi echo " ✅ TestFlight 上传完成" ''' } } } } post { always { script { echo "🧹 处理构建产物和清理" // 根据环境归档不同的构建产物 echo "📦 归档${params.BUILD_ENVIRONMENT}环境构建产物..." // 归档 APK (仅限 Android 平台) if ((params.PLATFORM == 'android' || params.PLATFORM == 'all') && fileExists('apps/oa_app/build/app/outputs/flutter-apk/app-release.apk')) { echo " - 归档Android Release APK..." archiveArtifacts artifacts: 'apps/oa_app/build/app/outputs/flutter-apk/app-release.apk', fingerprint: true echo " ✅ Android Release APK已归档" } // 归档 AAB (仅限 Android 平台) if ((params.PLATFORM == 'android' || params.PLATFORM == 'all') && fileExists('apps/oa_app/build/app/outputs/bundle/release/app-release.aab')) { echo " - 归档Android AAB..." archiveArtifacts artifacts: 'apps/oa_app/build/app/outputs/bundle/release/app-release.aab', fingerprint: true echo " ✅ Android AAB已归档" } // 归档iOS IPA (仅限 iOS 平台) if (params.PLATFORM == 'ios' || params.PLATFORM == 'all') { def ipaFileCount = sh( script: "find apps/oa_app/build/ios/ipa -name '*.ipa' 2>/dev/null | wc -l | tr -d ' '", returnStdout: true ).trim() if (ipaFileCount && ipaFileCount != '0') { echo " - 归档iOS IPA..." archiveArtifacts artifacts: 'apps/oa_app/build/ios/ipa/*.ipa', fingerprint: true echo " ✅ iOS IPA已归档 (找到 ${ipaFileCount} 个文件)" } else { echo " ⚠️ 未找到iOS IPA文件" } } // 归档FVM配置 if (fileExists('.fvmrc')) { archiveArtifacts artifacts: '.fvmrc', fingerprint: true, allowEmptyArchive: true echo " ✅ FVM配置已归档" } } } success { script { echo "🎉 ${params.BUILD_ENVIRONMENT}环境构建成功!" echo "" echo "✅ 构建总结:" echo " - 项目: ${PROJECT_NAME}" echo " - 应用: ${APP_NAME}" echo " - 环境: ${params.BUILD_ENVIRONMENT}" echo " - 平台: ${params.PLATFORM}" echo " - 项目类型: Melos Monorepo" echo " - Flutter版本: ${FVM_VERSION}" echo " - 归档位置: ${RELEASE_DIR}" echo "" if (params.BUILD_ENVIRONMENT == 'production') { echo "🏭 生产环境特性:" echo " - Release APK (生产签名,可发布)" echo " - iOS ${params.IOS_DISTRIBUTION_TYPE} IPA" echo " - AAB (Google Play Store)" echo "" echo "⚠️ 重要提醒:" echo " - 生产包仅用于正式发布" echo " - 发布前请进行充分测试" echo " - 确认版本号和更新说明" } else if (params.BUILD_ENVIRONMENT == 'preview') { echo "🔍 预发布环境特性:" echo " - Release APK (优化版本,连接预发布库)" echo " - iOS TestFlight版本" if (params.UPLOAD_TESTFLIGHT) { echo " - 已自动上传到TestFlight" } echo "" echo "🚀 下一步:" echo " - 供测试团队/产品验收" } else { echo "🛠️ 开发环境特性:" echo " - Release APK (优化版本,用于测试)" echo " - iOS TestFlight版本" if (params.UPLOAD_TESTFLIGHT) { echo " - 已自动上传到TestFlight" } echo "" echo "🚀 下一步:" echo " - 下载APK进行内部测试" echo " - TestFlight查看iOS测试版本" } } } failure { script { echo "❌ ${params.BUILD_ENVIRONMENT}环境构建失败" echo "" echo "🔍 故障排除建议:" echo " 1. 检查Flutter环境配置" echo " 2. 验证Melos Monorepo依赖配置" if (params.BUILD_ENVIRONMENT == 'production') { echo " 3. 验证iOS Distribution/Ad-hoc证书" echo " 4. 确认Android Release签名配置" echo " 5. 检查生产环境权限和密钥" } else { echo " 3. 验证App Store Connect API密钥配置" echo " 4. 确认TestFlight上传权限" echo " 5. 检查开发/预发布证书配置" } echo " 6. 查看详细构建日志" } } } }