Skip to content

Android打包部署 ​

开发环境准备 ​

必备软件 ​

  • Android Studio Hedgehog (2023.1.1) 或更高版本
  • JDK 17
  • Android SDK (API 26-34)
  • Git

项目配置 ​

  1. 克隆项目
bash
git clone <repository-url>
cd android_app
  1. 打开Android Studio

    • File → Open → 选择android_app目录
    • 等待Gradle同步完成
  2. 配置签名密钥(Release版本)

    • 创建或使用现有的keystore文件
    • 配置签名信息

构建APK ​

Debug版本 ​

Debug版本用于开发和测试:

bash
# 在android_app目录下
./gradlew assembleDebug

# Windows
gradlew.bat assembleDebug

生成的APK位置:

app/build/outputs/apk/debug/app-debug.apk

Release版本 ​

Release版本用于正式发布:

1. 配置签名 ​

编辑 app/build.gradle:

gradle
android {
    signingConfigs {
        release {
            storeFile file("../keystore/release.jks")
            storePassword "your_store_password"
            keyAlias "your_key_alias"
            keyPassword "your_key_password"
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

安全提示

不要将密码提交到Git仓库。使用环境变量或gradle.properties:

gradle
signingConfigs {
    release {
        storeFile file(project.hasProperty('RELEASE_STORE_FILE') ? RELEASE_STORE_FILE : "../keystore/release.jks")
        storePassword project.hasProperty('RELEASE_STORE_PASSWORD') ? RELEASE_STORE_PASSWORD : ''
        keyAlias project.hasProperty('RELEASE_KEY_ALIAS') ? RELEASE_KEY_ALIAS : ''
        keyPassword project.hasProperty('RELEASE_KEY_PASSWORD') ? RELEASE_KEY_PASSWORD : ''
    }
}

2. 构建Release APK ​

bash
# Linux/Mac
./gradlew assembleRelease

# Windows
gradlew.bat assembleRelease

生成的APK位置:

app/build/outputs/apk/release/rizhi-v{version}-release.apk

使用部署脚本 ​

项目提供了自动化部署脚本:deploy-android.sh

脚本功能 ​

  • ✅ 自动编译Release APK
  • ✅ 重命名APK文件(包含版本号)
  • ✅ 上传APK到服务器
  • ✅ 调用后端API注册新版本
  • ✅ 自动填充版本信息

使用方法 ​

bash
# Linux/Mac
./deploy-android.sh [版本号] "[更新描述]"

# 示例
./deploy-android.sh 2.0.5 "修复已知问题,优化性能"

脚本流程 ​

  1. 验证参数

    • 检查版本号格式
    • 检查更新描述
  2. 更新版本号

    • 修改app/build.gradle中的versionName和versionCode
    • 自动计算versionCode
  3. 编译APK

    • 执行gradlew assembleRelease
    • 等待编译完成
  4. 重命名APK

    • 从app-release.apk重命名为rizhi-v{version}-release.apk
  5. 上传到服务器

    • 通过SCP上传到服务器
    • 目标路径:/var/www/src/uploads/apk/
  6. 注册版本

    • 调用后端API /api/app/version
    • 提交版本信息:
      • versionName
      • versionCode
      • platform (android)
      • releaseType (release/debug)
      • description
      • changelog
      • forceUpdate
      • minSupportedVersion

手动部署 ​

如果不使用脚本,可以手动执行:

1. 更新版本号 ​

编辑 app/build.gradle:

gradle
android {
    defaultConfig {
        versionCode 20500  // 版本号: 主版本*10000 + 次版本*100 + 修订版本
        versionName "2.0.5"
    }
}

2. 编译APK ​

bash
./gradlew assembleRelease

3. 重命名APK ​

bash
cp app/build/outputs/apk/release/app-release.apk rizhi-v2.0.5-release.apk

4. 上传到服务器 ​

bash
scp rizhi-v2.0.5-release.apk root@8.147.129.77:/var/www/src/uploads/apk/

5. 注册版本 ​

bash
curl -X POST http://8.147.129.77:3003/api/app/version \
  -F "apk=@rizhi-v2.0.5-release.apk" \
  -F "versionName=2.0.5" \
  -F "versionCode=20500" \
  -F "platform=android" \
  -F "releaseType=release" \
  -F "description=修复已知问题" \
  -F "changelog=详细更新日志"

版本管理 ​

版本号规范 ​

采用语义化版本号:主版本.次版本.修订版本

  • 主版本: 重大功能更新或架构变更
  • 次版本: 新功能添加
  • 修订版本: Bug修复和小改进

示例:

  • 1.0.0 - 初始版本
  • 1.1.0 - 添加新功能
  • 1.1.1 - Bug修复
  • 2.0.0 - 重大更新

VersionCode计算 ​

kotlin
versionCode = 主版本 * 10000 + 次版本 * 100 + 修订版本

// 示例
2.0.5 → 20500
1.2.3 → 10203

版本历史 ​

项目的版本历史记录在:

  • Git提交记录
  • 后端数据库app_versions表
  • CLAUDE.md文件的部署记录

混淆配置 ​

Release版本启用了代码混淆,配置文件:app/proguard-rules.pro

基本规则 ​

proguard
# 保留行号信息
-keepattributes SourceFile,LineNumberTable

# 保留泛型信息
-keepattributes Signature

# 保留注解
-keepattributes *Annotation*

# 保留Serializable
-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    !static !transient <fields>;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}

第三方库规则 ​

proguard
# Retrofit
-dontwarn retrofit2.**
-keep class retrofit2.** { *; }
-keepattributes Signature
-keepattributes Exceptions

# Gson
-keep class com.google.gson.** { *; }
-keep class sun.misc.Unsafe { *; }

# OkHttp
-dontwarn okhttp3.**
-keep class okhttp3.** { *; }

# 数据模型
-keep class com.bjbmkj.rizhi.data.model.** { *; }
-keep class com.bjbmkj.rizhi.domain.model.** { *; }

测试APK ​

本地测试 ​

  1. 连接Android设备
bash
adb devices
  1. 安装APK
bash
adb install app/build/outputs/apk/release/app-release.apk

# 或使用Android Studio的Run按钮
  1. 查看日志
bash
adb logcat | grep "RizhiApp"

Beta测试 ​

  1. 将APK发送给测试用户
  2. 收集反馈和崩溃日志
  3. 修复问题后重新打包
  4. 重复测试直到稳定

APK优化 ​

减小APK体积 ​

1. 启用资源压缩 ​

gradle
android {
    buildTypes {
        release {
            shrinkResources true  // 移除未使用的资源
            minifyEnabled true    // 代码混淆
        }
    }
}

2. 使用WebP格式图片 ​

将PNG/JPG转换为WebP格式,可减少30-90%体积。

3. 分析APK组成 ​

bash
./gradlew :app:assembleRelease
# 在Android Studio中
Build → Analyze APK → 选择生成的APK

4. 启用APK分包 ​

如果APK过大(超过100MB):

gradle
android {
    splits {
        abi {
            enable true
            reset()
            include 'armeabi-v7a', 'arm64-v8a'
            universalApk false
        }
    }
}

性能优化 ​

1. 启用R8优化 ​

R8是新一代代码压缩和混淆工具:

gradle
android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

2. 启用多dex ​

gradle
android {
    defaultConfig {
        multiDexEnabled true
    }
}

dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
}

发布渠道 ​

内部分发 ​

  1. 直接分发APK

    • 通过企业内部服务器
    • 或企业通讯工具(钉钉/企业微信)
  2. 内部应用市场

    • 搭建企业内部应用商店
    • 提供版本管理和更新

公开发布 (如需) ​

  1. 应用商店

    • Google Play (需要开发者账号)
    • 华为应用市场
    • 小米应用商店
    • OPPO软件商店
    • Vivo应用商店
    • 应用宝
  2. 准备材料

    • 应用截图(至少4张)
    • 应用图标(512x512)
    • 应用描述
    • 隐私政策
    • 软件著作权(部分商店需要)

持续集成 (CI/CD) ​

GitHub Actions示例 ​

创建 .github/workflows/android.yml:

yaml
name: Android CI

on:
  push:
    tags:
      - 'v*'

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3

    - name: Set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'temurin'

    - name: Grant execute permission for gradlew
      run: chmod +x android_app/gradlew

    - name: Build Release APK
      run: |
        cd android_app
        ./gradlew assembleRelease

    - name: Upload APK
      uses: actions/upload-artifact@v3
      with:
        name: app-release
        path: android_app/app/build/outputs/apk/release/app-release.apk

故障排查 ​

编译失败 ​

  1. 清理项目
bash
./gradlew clean
  1. 重新同步
bash
./gradlew --refresh-dependencies
  1. 检查JDK版本
bash
java -version
# 应该是JDK 17

签名失败 ​

  1. 检查keystore文件路径
  2. 验证密码是否正确
  3. 检查keystore文件是否损坏

APK无法安装 ​

  1. 卸载旧版本
  2. 检查签名是否一致
  3. 检查最低SDK版本

运行崩溃 ​

  1. 查看logcat日志
  2. 检查混淆规则
  3. 使用debug版本定位问题

参考资料 ​

炳明一企通正式版 · 企业服务与协同管理