Jenkins在游戏开发中的应用

概览与价值

• 面向游戏研发全链路，Jenkins 将代码拉取、引擎构建、资源处理、自动化测试、产物归档与分发、通知整合为可编排的流水线，显著降低人工打包出错率与等待时间，适合H5/小游戏、Cocos、Unity等多引擎、多平台项目。
• 典型收益：
  • 效率提升：一键多平台构建、并行执行、定时/提交触发，缩短从提交到可测包的时间。
  • 质量可控：构建后自动跑集成/回归测试、日志错误检测、产物校验，失败即阻断并回滚提醒。
  • 可追溯与协作：构建产物与日志长期留存，支持邮件/IM通知，便于策划、测试、美术协同验收。

典型工作流

• 触发与代码准备
  • 触发方式：代码提交触发或定时轮询（如每5分钟）；源码管理使用 Git（亦可 SVN/Mercurial）。
  • 节点与工具：按平台准备 Windows/macOS/Linux 构建节点；全局配置 JDK 11/17、Git、Node.js、引擎 CLI（如 Cocos Creator、Unity Hub/Editor）。
• 构建与资源处理
  • 引擎构建：调用 Cocos Creator CLI 或 Unity -batchmode -executeMethod 执行无头构建；按平台/配置（如 Windows/Android/iOS/WebGL × Debug/Release）产出产物。
  • 资源与包体：执行纹理压缩、模型优化、版本哈希；对 JS/TS 与图片资源做混淆/水印；生成 version.txt/构建元数据。
• 产物分发与验收
  • 上传与部署：将包体与符号文件同步到CDN/制品库/本地网盘；移动端产物可上传到平台分发并生成预览二维码；归档到 Jenkins 并提供下载链接。
  • 质量门禁：解析构建日志、运行自动化测试（如 LuaUnit 输出 XML 报告），失败则阻断并告警。

引擎与平台实践要点

Pipeline 示例与关键配置

• 参数化与节点
  • 参数：Version、Build、Preview、Upload、Obfuscation、UploadBundle、EmailNotice 等，按需开关步骤。
  • 节点：按平台打标签（如 agent { label ‘game-builder’ }），或使用分布式构建在多机并行。
• 触发器与缓存
  • 触发器：代码提交触发或 *Poll SCM（如 H/5 * * * ） 定时轮询。
  • 缓存：对 Unity Library/ 等中间产物做缓存，显著缩短全量构建时间。
• 核心片段（声明式 Pipeline 骨架）
  • 说明：以下为简化骨架，需按项目替换路径、命令与凭据。

  pipeline {
    agent { label 'game-builder' }
    triggers { pollSCM('H/5 * * * *') }
    parameters {
      string(name: 'Version', defaultValue: '', description: '版本号')
      booleanParam(name: 'Build', defaultValue: true)
      booleanParam(name: 'Preview', defaultValue: false)
      booleanParam(name: 'Upload', defaultValue: false)
      booleanParam(name: 'Obfuscation', defaultValue: false)
      booleanParam(name: 'UploadBundle', defaultValue: false)
      booleanParam(name: 'EmailNotice', defaultValue: true)
    }
    environment {
      JAVA_HOME = 'C:\\Program Files\\Java\\jdk-11'
      UNITY_PATH = 'C:\\Program Files\\Unity\\Hub\\Editor\\2021.3.11f1\\Editor\\Unity.exe'
      BUILD_TYPE = 'Development'
    }
    options { skipDefaultCheckout true }
    stages {
      stage('Checkout') {
        steps { git branch: 'main', url: 'https://example.com/repo.git', credentialsId: 'git-cred-id' }
      }
      stage('Restore Cache') {
        steps {
          cache(path: 'Library', includes: '**/*', key: "unity-library-${BUILD_ID}") {
            // 命中缓存可加速构建
          }
        }
      }
      stage('Build') {
        steps {
          script {
            def code = bat returnStatus: true, script: "\"${env.UNITY_PATH}\" -batchmode -quit -buildTarget win64 -executeMethod BuildPipeline.Build -logFile build.log"
            if (code != 0) error("Unity build failed with code ${code}")
            // 可调用日志检查脚本：python check_log.py build.log
          }
        }
      }
      stage('Obfuscate') {
        when { expression { params.Obfuscation } }
        steps {
          bat 'python obfuscate_js.py build/output'
          bat 'python obfuscate_images.py build/output'
        }
      }
      stage('Upload to CDN') {
        when { expression { params.UploadBundle } }
        steps { bat 'python upload_cdn.py build/remote https://cdn.example.com' }
      }
      stage('Preview & Upload') {
        when { expression { params.Preview || params.Upload } }
        steps {
          bat 'tmg preview -o qrcode.png'
          bat 'python process_qr.py qrcode.png'
          script {
            if (params.Upload) { bat "tmg upload -v ${params.Version}" }
          }
        }
      }
    }
    post {
      success {
        script {
          if (params.EmailNotice) {
            mail to: 'team@example.com', subject: "Build Success - ${env.BUILD_NUMBER}", body: "See ${env.BUILD_URL}"
          }
        }
      }
      failure {
        script {
          if (params.EmailNotice) {
            mail to: 'team@example.com', subject: "Build Failed - ${env.BUILD_NUMBER}", body: "See ${env.BUILD_URL}"
          }
        }
      }
    }
  }
  

  • 要点：引擎路径、凭据 credentialsId、构建日志与产物路径需与项目一致；iOS 签名与证书请提前在构建节点配置好 Keychain/Provisioning Profile。