Windows下Jenkins安装与APP编译配置指南

1. Windows环境下Jenkins的安装与配置

在Windows系统上搭建Jenkins持续集成环境需要特别注意几个关键环节。首先需要确保系统满足基本要求：Windows 7及以上版本（推荐Windows 10/11）、至少4GB内存（编译APP建议8GB+）、JDK 8或11（Jenkins 2.357+需要Java 11）。我推荐使用JDK 11 LTS版本，这是目前Jenkins官方最稳定的支持版本。

安装方式通常有两种选择：

  1. 使用官方war包通过Java命令运行
  2. 下载Windows安装程序（推荐新手）

采用Windows安装程序时，会默认创建系统服务并设置自动启动。安装过程中会要求设置初始管理员账户 - 这里有个实用技巧：安装完成后立即到C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword获取初始密码，而不是在安装界面直接设置密码，这样可以避免后续权限问题。

重要提示：安装路径不要包含中文或空格，否则可能导致插件安装失败。建议使用默认路径或类似D:\Jenkins这样的纯英文路径。

安装完成后，浏览器访问http://localhost:8080进入初始化配置。国内用户建议立即更换更新中心地址为清华镜像源：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

这个步骤能显著加快插件下载速度，特别是在安装Git、Maven等必备插件时。

2. Jenkins编译环境的深度配置

2.1 工具链的安装与管理

编译APP前需要配置完整的工具链。对于Java项目，必须安装：

  • JDK（通过Jenkins的Global Tool Configuration配置）
  • Maven/Gradle（建议与本地开发环境版本一致）
  • Git客户端（Windows版Git需要勾选"Add to PATH"选项）

Android项目还需要额外配置：

  • Android SDK（通过环境变量ANDROID_HOME指定路径）
  • NDK（如果包含原生代码）
  • 建议使用命令行工具sdkmanager安装特定版本的build-tools

配置环境变量时有个实用技巧：在Jenkins的系统管理 → 系统配置 → 全局属性中添加环境变量，这样所有Job都能继承这些配置。比如设置JAVA_HOME、ANDROID_HOME等关键路径。

2.2 节点管理与资源分配

对于大型APP编译，建议设置专用构建节点：

  1. 主节点只做任务调度
  2. 创建Windows从节点专门执行编译
  3. 配置节点标签如"windows-build"

在Manage Nodes and Clouds中新建节点时，启动方式选择"Launch agent via Java Web Start"。实测发现这种方式比Windows服务更稳定，特别是长时间编译任务时不易断开连接。

资源分配方面，建议：

  • 每个执行器(executor)分配至少2核CPU
  • 工作空间(workspace)放在SSD硬盘
  • 设置编译超时时间（避免卡死占用资源）

3. APP编译任务的具体实现

3.1 创建Pipeline项目

现代Jenkins推荐使用Pipeline而非自由风格项目。新建项目时选择"Pipeline"，然后选择"Pipeline script from SCM"方式，将Jenkinsfile与项目代码一起管理。

典型的Android APP编译Pipeline示例：

pipeline { agent any tools { jdk 'jdk11' androidSdk 'android-30' } stages { stage('Checkout') { steps { git branch: 'dev', url: 'https://github.com/yourrepo/app.git' } } stage('Build') { steps { bat './gradlew clean assembleRelease' } } stage('Archive') { steps { archiveArtifacts artifacts: '**/*.apk', fingerprint: true } } } }

3.2 编译参数化构建

实际项目中通常需要动态参数：

  • 版本号
  • 编译变体(flavor)
  • 代码分支

在Pipeline开头添加parameters块：

parameters { choice(name: 'BRANCH', choices: ['dev', 'test', 'master'], description: '选择构建分支') string(name: 'VERSION_CODE', defaultValue: '100', description: '版本号') }

调用Gradle时使用参数：

bat "./gradlew clean assemble${params.BUILD_VARIANT} -PversionCode=${params.VERSION_CODE}"

3.3 Windows特有的编译问题处理

  1. 路径长度限制：Windows默认路径长度限制260字符，可能导致编译失败。解决方案：

    • 启用长路径支持（组策略编辑器 → 计算机配置 → 管理模板 → 文件系统 → 启用Win32长路径）
    • 工作空间路径尽量短（如D:\build）

  2. 文件锁定问题：Windows对文件锁定严格，可能导致清理失败。在bat脚本中添加：

    taskkill /F /IM java.exe del /F /Q build\*.*

  3. 编码问题：建议在所有bat脚本开头添加：

    chcp 65001 set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8

4. 编译优化与持续交付

4.1 构建缓存策略

Windows环境下可配置多级缓存：

  1. Gradle构建缓存：在gradle.properties中添加
    org.gradle.caching=true org.gradle.parallel=true
  2. Jenkins的Pipeline缓存：
    stage('Build') { steps { cache(include: ['**/.gradle/caches/**'], excludes: ['**/tmp/**']) { bat './gradlew assemble' } } }

4.2 构建矩阵与并行化

对于多flavor的APP，使用matrix实现并行构建：

matrix { axes { axis { name 'BUILD_VARIANT' values 'Debug', 'Release', 'Staging' } } stages { stage('Build') { steps { bat "./gradlew clean assemble${BUILD_VARIANT}" } } } }

4.3 构建结果通知与归档

完整的交付流程应包括：

  1. 单元测试报告集成
    post { always { junit '**/test-results/**/*.xml' } }
  2. 邮件通知（需安装Email Extension插件）
  3. APK自动上传到内网分发平台

我在实际项目中发现，Windows环境下Jenkins的性能瓶颈通常在磁盘IO。建议：

  • 定期清理workspace（每天凌晨执行）
  • 使用RAMDisk存放临时文件
  • 禁用Windows Defender实时扫描构建目录

对于大型项目，可以考虑将编译分成两个独立Job：

  1. 代码编译（频繁触发）
  2. 打包发布（手动触发）

这样既能快速获得编译反馈，又能控制发布节奏。最后提醒：所有密码和敏感信息务必使用Jenkins的Credentials管理，切勿硬编码在脚本中。