GitHub自动打包APK

下面将用「魔法厨房」的童话故事，结合代码示例为你揭秘GitHub自动打包Android APK的全流程。在这个童话里：

• 🏰 GitHub仓库 = 魔法厨房
• 📜 YAML配置文件 = 魔法食谱
• 🤖 GitHub Actions = 自动烹饪精灵
• 🔑 签名密钥 = 秘制香料

---

🧙‍♂️ 第一章：准备魔法厨房的秘料（密钥配置）

问题：如何让精灵安全使用签名密钥？
解法：把密钥拆解成魔法卷轴藏在密室（Secrets）

bash

# 本地生成密钥库（魔法香料瓶）
keytool -genkey -v -keystore magic-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias magic-alias

将密钥信息分解为：

1. 创建私有仓库 android-keystore 存放 magic-key.jks
2. 在仓库添加 keystore.properties：

properties

# 香料配方表
storePassword=your_store_password  
keyPassword=your_key_password  
keyAlias=magic-alias  
storeFile=../keystore/magic-key.jks

3. 在项目 Secrets 存入访问密钥仓库的 TOKEN

---

📜 第二章：编写魔法食谱（YAML配置）

创建 .github/workflows/magic-cook.yml：

yaml

name: Android Magic Kitchen

on:
  push:
    tags: 
      - 'v*'  # 当巫师打上v1.0这样的标签时触发魔法

jobs:
  cook-apk:
    runs-on: ubuntu-latest
    steps:
      # 步骤1：召唤食材（代码）
      - name: Checkout Code  
        uses: actions/checkout@v4
        with:
          token: ${{ secrets.TOKEN }}  # 密室钥匙

      # 步骤2：取回秘制香料（密钥）
      - name: Fetch Magic Spices
        uses: actions/checkout@v4
        with:
          repository: YourName/android-keystore  # 香料仓库
          path: keystore  # 存放位置
          token: ${{ secrets.TOKEN }}

      # 步骤3：点燃炉火（JDK环境）
      - name: Ignite JDK Furnace
        uses: actions/setup-java@v3
        with:
          distribution: 'zulu'
          java-version: '17'

      # 步骤4：调配香料（注入签名信息）
      - name: Prepare Spice Mix
        run: |
          cp keystore/magic-key.jks app/
          echo "storeFile=../app/magic-key.jks" >> keystore/keystore.properties
          cat keystore/keystore.properties >> gradle.properties

      # 步骤5：烹饪APK（构建命令）
      - name: Cook Release APK
        run: ./gradlew assembleRelease  # 魔法烹饪咒语

      # 步骤6：包装点心（发布Release）
      - name: Package Magic Dessert
        uses: softprops/action-gh-release@v1
        with:
          files: app/build/outputs/apk/release/*.apk
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}  # 厨房自带的魔法令牌

---

⚡ 第三章：启动魔法烹饪（触发流程）

巫师只需施展两个咒语：

bash

# 1. 标记版本（给点心贴标签）
git tag v1.0.0  

# 2. 推送标签（激活厨房精灵）
git push origin v1.0.0

精灵工作流程：

---

🧪 第四章：魔法升级技巧（高级技巧）

技巧1：自动递增版本号

在 version.properties 中设置：

properties

# 版本魔法计数器
versionCode=100  
versionName=1.0.0

添加Gradle魔法脚本2：

groovy

task incrementVersion {
  doLast {
    def versionProps = new Properties()
    file("version.properties").withInputStream { versionProps.load(it) }
    
    // 版本号自动+1
    versionProps["versionCode"] = (versionProps["versionCode"].toInteger() + 1).toString()
    file("version.properties").withWriter { versionProps.store(it, null) }
  }
}

技巧2：APK风味定制（多渠道打包）

yaml

- name: Cook Flavors
  run: ./gradlew assembleFreeRelease assembleProRelease

技巧3：上传Google Play（自动上架）

yaml

- name: Deliver to Google Play
  uses: r0adkll/upload-google-play@v1
  with:
    serviceAccountJson: ${{ secrets.GCP_KEY }}
    packageName: com.magic.app
    releaseFiles: app/build/outputs/apk/**/*.apk

---

🧭 魔法触发器对照表

触发方式	咒语示例	使用场景
标签推送 (v*)	git push origin v1.0	正式版本发布
分支合并	合并代码到 main 分支	每日构建测试包
手动触发	点击GitHub Actions面板	紧急修复打包
定时任务 (cron)	schedule: '0 3 * * *'	每日凌晨3点自动构建

---

💥 常见魔法事故处理

1. 密钥泄露危机
   → 永远不要把 .jks 文件放在主仓库！用私有仓库存储

2. 版本号冲突
   → 在 gradle.properties 中添加：

   properties

   # 避免多精灵同时烹饪冲突
   org.gradle.parallel=false  
   

3. APK未签名
   → 检查 keystore.properties 路径是否匹配：

   groovy

   storeFile file(keystoreProperties['storeFile'])
   

---

🌟 完整魔法食谱示例

访问 Android Magic Kitchen 示例仓库 获取可直接运行的YAML文件与配置模板。

童话小结：GitHub Actions就像一群勤劳的厨房精灵，只要你配置好魔法食谱（YAML），它们就能自动完成「取食材→调香料→烹制→包装」的全流程。从此巫师只需专注创造魔法（写代码），点心制作（打包）交给精灵！