企业级 RN Android 完整 CI/CD 自动化解决方案

wayne214

已于 2025-08-19 08:26:34 修改

阅读量399

点赞数 10

CC 4.0 BY-SA版权

文章标签： android ci/cd 自动化 react native

于 2025-08-19 08:26:24 首次发布

本文链接：https://blog.csdn.net/wayne214/article/details/150510753

脚本实现功能如下：

自动生成 RN bundle
Debug/Release + 多渠道打包
自动 versionCode / versionName
自动生成 Changelog（Git commit）
APK 上传到蒲公英 + 内部服务器
自动生成下载二维码
自动生成网页渠道列表（带二维码和下载链接）
钉钉/飞书通知构建结果
Jenkins 参数化构建，多渠道循环

1.修改 `scripts/bundle-android.sh`（增加历史版本管理）

#!/bin/bash
# ===============================
# RN Android 多渠道 bundle & APK 自动打包 + Changelog + QR + 网页历史版本
# ===============================

set -e

ROOT_DIR=$(cd "$(dirname "$0")/.." && pwd)
cd $ROOT_DIR

BUILD_TYPE=${1:-Release}   # Release 或 Debug
FLAVOR=${2:-prod}          # 默认 prod 渠道

BUILD_TIME=$(date "+%Y-%m-%d %H:%M")
echo "Build Type: $BUILD_TYPE, Flavor: $FLAVOR, Build Time: $BUILD_TIME"

# RN 版本
RN_VERSION=$(npx react-native --version)
echo "React Native version: $RN_VERSION"

# 清理旧 bundle
rm -rf android/app/src/main/assets/index.android.bundle
rm -rf android/app/src/main/res/*

# 安装依赖 & 打包 bundle
npm install
npm run bundle-android

# 自动 versionCode / versionName
VERSION_CODE=$(date +%Y%m%d%H%M)
VERSION_NAME=$(date +%Y.%m.%d.%H%M)
sed -i "" "s/versionCode .*/versionCode $VERSION_CODE/" android/app/build.gradle
sed -i "" "s/versionName \".*\"/versionName \"$VERSION_NAME\"/" android/app/build.gradle

# 生成 Changelog
CHANGELOG=$(git log --pretty=format:"%h %s" --no-merges -n 10)
echo "$CHANGELOG" > build_changelog.txt

# 编译 APK
cd android
if [ "$BUILD_TYPE" == "Debug" ]; then
    ./gradlew clean assemble${FLAVOR^}Debug
else
    ./gradlew clean assemble${FLAVOR^}Release
fi

APK_PATH=$(ls app/build/outputs/apk/${FLAVOR}/${BUILD_TYPE,,}/*.apk)
echo $APK_PATH > ../last_apk_path.txt

# 生成二维码
APK_URL="http://your.server/path/to/apk/$(basename $APK_PATH)"
QR_FILE="$ROOT_DIR/qr_${FLAVOR}_${VERSION_CODE}.png"
python3 - <<EOF
import qrcode
img = qrcode.make("$APK_URL")
img.save("$QR_FILE")
EOF

# 更新网页历史版本列表
HTML_FILE="$ROOT_DIR/apk_list.html"

# 创建 HTML 文件头
if [ ! -f "$HTML_FILE" ]; then
cat <<EOT > "$HTML_FILE"
<html>
<head>
<title>Android APK 历史版本</title>
<meta charset="utf-8">
</head>
<body>
<h2>Android APK 下载历史版本</h2>
<ul id="apk-list">
</ul>
</body>
</html>
EOT
fi

# 生成单条 HTML
ENTRY="<li><b>${BUILD_TIME} ${FLAVOR} (${BUILD_TYPE}) v${VERSION_NAME}</b><br>"
ENTRY+="<a href='${APK_URL}'>下载 APK</a><br>"
ENTRY+="<img src='qr_${FLAVOR}_${VERSION_CODE}.png' width='150'/><br>"
ENTRY+="<pre>${CHANGELOG}</pre></li>"

# 使用 sed 插入到 <ul id="apk-list"> 内
sed -i "" "/<ul id=\"apk-list\">/a\\
$ENTRY
" "$HTML_FILE"

echo "✅ Build finished: ${BUILD_TYPE}-${FLAVOR}, APK: $APK_PATH"

2. Jenkinsfile 修改（保留历史版本 + 汇总通知）

pipeline {
    agent any

    parameters {
        choice(name: 'BUILD_TYPE', choices: ['Debug','Release'], description: '选择构建类型')
        string(name: 'FLAVORS', defaultValue: 'prod,test,dev', description: '选择要打的渠道，多渠道用逗号分隔')
    }

    environment {
        NODE_HOME = "/usr/local/bin/node"
        NPM_HOME  = "/usr/local/bin/npm"
        JAVA_HOME = "/usr/lib/jvm/java-11-openjdk"
        ANDROID_HOME = "/usr/local/android-sdk"
        PATH = "${env.ANDROID_HOME}/tools:${env.ANDROID_HOME}/platform-tools:${env.NODE_HOME}:${env.NPM_HOME}:${env.PATH}"

        UPLOAD_PGY = "https://www.pgyer.com/apiv2/app/upload"
        PGY_API_KEY = "your_pgy_api_key"

        INTERNAL_SERVER = "user@your.server:/path/to/apk"
        NOTIFY_WEBHOOK = "https://oapi.dingtalk.com/robot/send?access_token=your_token"
    }

    stages {
        stage('Checkout') { steps { checkout scm } }
        stage('Install Dependencies') { steps { sh 'npm install' } }

        stage('Build & Upload APKs') {
            steps {
                script {
                    def flavorList = params.FLAVORS.split(',')
                    for (flavor in flavorList) {
                        flavor = flavor.trim()
                        echo "------------------ Building ${params.BUILD_TYPE}-${flavor} ------------------"
                        sh "./scripts/bundle-android.sh ${params.BUILD_TYPE} ${flavor}"

                        def apkPath = readFile('last_apk_path.txt').trim()
                        def qrFile = "qr_${flavor}_*.png"

                        // 上传 APK + QR 到服务器
                        sh "scp ${apkPath} ${INTERNAL_SERVER}"
                        sh "scp ${qrFile} ${INTERNAL_SERVER}"

                        // 上传蒲公英
                        sh """
                        curl -F "file=@${apkPath}" -F "_api_key=${PGY_API_KEY}" ${UPLOAD_PGY}
                        """
                    }

                    // 上传网页历史版本列表
                    sh "scp apk_list.html ${INTERNAL_SERVER}"
                }
            }
        }
    }

    post {
        success {
            echo "✅ All builds finished successfully!"
            // 发送 HTML 消息到钉钉/飞书，通知包含网页历史版本链接
            sh """
            curl ${NOTIFY_WEBHOOK} -H 'Content-Type: application/json' -d '{
                "msgtype": "text",
                "text": {"content": "✅ Android ${params.BUILD_TYPE} 构建成功，历史版本页面: http://your.server/path/to/apk_list.html"}
            }'
            """
        }
        failure {
            echo "❌ Build failed!"
            sh """
            curl ${NOTIFY_WEBHOOK} -H 'Content-Type: application/json' -d '{
                "msgtype": "text",
                "text": {"content": "❌ Android ${params.BUILD_TYPE} 构建失败，请检查 Jenkins 日志！"}
            }'
            """
        }
    }
}

3.工程目录结构示意

rn-jenkins-demo/
├─ android/
│  ├─ app/
│  │  ├─ src/main/assets/
│  │  ├─ src/main/res/
│  └─ build.gradle
├─ ios/
├─ scripts/
│  └─ bundle-android.sh
├─ index.js
├─ package.json
├─ Jenkinsfile
└─ ...