5分钟搞定！Luban项目GitHub Actions自动构建全流程

你还在手动打包Luban图片压缩库？每次迭代都要重复繁琐的编译、测试、发布步骤？本文将带你5分钟搭建GitHub Actions自动构建流程，彻底解放双手！读完本文你将获得：

• 从零到一配置GitHub Actions工作流
• 实现代码提交后自动构建Android项目
• 集成单元测试与产物归档功能
• 规避90%的常见CI配置错误

为什么需要自动构建Luban？

Luban作为接近微信朋友圈压缩效果的图片处理库（项目描述），其核心价值在于算法的精准实现。手动构建不仅效率低下，还可能因环境差异导致压缩效果不一致。通过GitHub Actions实现：

• 每次代码提交自动验证压缩算法正确性
• 保证不同开发环境构建结果一致性
• 快速生成可供测试的示例APK（示例工程）

准备工作：认识项目结构

在开始配置前，先熟悉Luban项目的关键文件结构：

Luban/
├── library/           # 核心压缩算法实现
│   ├── src/main/java/ # 鲁班压缩核心代码
│   └── build.gradle   # 库模块构建配置
├── example/           # 演示应用
│   └── src/main/      # 包含压缩效果展示界面
└── gradlew            # gradle构建脚本

核心压缩逻辑位于Luban.java，示例应用的主界面在MainActivity.java，这些文件将在构建过程中被自动编译。

配置步骤：5分钟工作流搭建

1. 创建工作流文件

在项目根目录创建.github/workflows/ci.yml文件，这是GitHub Actions的配置入口。文件路径遵循固定规范，确保Actions能自动识别。

2. 基础配置模板

以下是完整的Luban自动构建配置，包含环境准备、依赖安装、构建测试和产物归档：

name: Luban CI/CD

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - name: 检出代码
      uses: actions/checkout@v4
      
    - name: 配置JDK环境
      uses: actions/setup-java@v4
      with:
        java-version: '17'
        distribution: 'temurin'
        cache: gradle
        
    - name: 构建项目
      run: ./gradlew assembleDebug
      
    - name: 运行单元测试
      run: ./gradlew test
      
    - name: 归档构建产物
      uses: actions/upload-artifact@v3
      with:
        name: luban-example-apk
        path: example/build/outputs/apk/debug/*.apk

3. 关键步骤解析

环境配置部分使用GitHub托管的Ubuntu环境，通过actions/setup-java配置Android构建所需的JDK 17环境，缓存Gradle依赖可使后续构建提速50%。

构建命令调用项目根目录的gradlew脚本，执行assembleDebug任务编译示例应用。该脚本会自动读取gradle.properties中的项目配置。

测试环节执行ExampleUnitTest.java中的单元测试，验证压缩算法的核心功能是否正常。

工作流触发与结果查看

触发条件

配置文件中on字段定义了两种触发场景：

• 代码推送到main分支时自动执行
• 发起Pull Request到main分支时触发验证

这种设置确保核心分支代码始终可构建，有效防止不合格代码合并。

查看构建结果

1. 访问项目GitHub仓库的Actions标签页
2. 选择最新的工作流运行记录
3. 在"Artifacts" section下载生成的示例APK
4. 查看"build"步骤的详细日志排查问题

构建成功后，可直接安装示例APK测试压缩效果，APK包含多种分辨率测试图片的压缩演示。

常见问题与解决方案

错误类型	可能原因	解决方法
编译超时	依赖下载慢	配置国内镜像源
测试失败	压缩算法变更	检查Engine.java实现
产物缺失	路径错误	核对example/build.gradle中的输出配置

进阶优化建议

1. 增加代码质量检查

在工作流中添加静态代码分析：

- name: 代码质量检查
  run: ./gradlew lint

2. 实现自动发布

配合library/build.gradle中的发布配置，添加Maven仓库自动部署步骤：

- name: 发布到Maven仓库
  run: ./gradlew publish
  env:
    MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}

总结与展望

通过本文配置的GitHub Actions工作流，Luban项目实现了"提交即构建，构建即可用"的开发闭环。配合项目的压缩算法文档，开发者可以更专注于算法优化而非构建流程。

下一篇我们将介绍如何通过GitHub Actions实现Luban算法的自动化性能测试，敬请关注！如果本文对你有帮助，请点赞收藏，让更多开发者摆脱重复劳动！