Appearance
Android打包部署
开发环境准备
必备软件
- Android Studio Hedgehog (2023.1.1) 或更高版本
- JDK 17
- Android SDK (API 26-34)
- Git
项目配置
- 克隆项目
bash
git clone <repository-url>
cd android_app打开Android Studio
- File → Open → 选择android_app目录
- 等待Gradle同步完成
配置签名密钥(Release版本)
- 创建或使用现有的keystore文件
- 配置签名信息
构建APK
Debug版本
Debug版本用于开发和测试:
bash
# 在android_app目录下
./gradlew assembleDebug
# Windows
gradlew.bat assembleDebug生成的APK位置:
app/build/outputs/apk/debug/app-debug.apkRelease版本
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 "修复已知问题,优化性能"脚本流程
验证参数
- 检查版本号格式
- 检查更新描述
更新版本号
- 修改
app/build.gradle中的versionName和versionCode - 自动计算versionCode
- 修改
编译APK
- 执行
gradlew assembleRelease - 等待编译完成
- 执行
重命名APK
- 从
app-release.apk重命名为rizhi-v{version}-release.apk
- 从
上传到服务器
- 通过SCP上传到服务器
- 目标路径:
/var/www/src/uploads/apk/
注册版本
- 调用后端API
/api/app/version - 提交版本信息:
- versionName
- versionCode
- platform (android)
- releaseType (release/debug)
- description
- changelog
- forceUpdate
- minSupportedVersion
- 调用后端API
手动部署
如果不使用脚本,可以手动执行:
1. 更新版本号
编辑 app/build.gradle:
gradle
android {
defaultConfig {
versionCode 20500 // 版本号: 主版本*10000 + 次版本*100 + 修订版本
versionName "2.0.5"
}
}2. 编译APK
bash
./gradlew assembleRelease3. 重命名APK
bash
cp app/build/outputs/apk/release/app-release.apk rizhi-v2.0.5-release.apk4. 上传到服务器
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
本地测试
- 连接Android设备
bash
adb devices- 安装APK
bash
adb install app/build/outputs/apk/release/app-release.apk
# 或使用Android Studio的Run按钮- 查看日志
bash
adb logcat | grep "RizhiApp"Beta测试
- 将APK发送给测试用户
- 收集反馈和崩溃日志
- 修复问题后重新打包
- 重复测试直到稳定
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 → 选择生成的APK4. 启用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'
}发布渠道
内部分发
直接分发APK
- 通过企业内部服务器
- 或企业通讯工具(钉钉/企业微信)
内部应用市场
- 搭建企业内部应用商店
- 提供版本管理和更新
公开发布 (如需)
应用商店
- Google Play (需要开发者账号)
- 华为应用市场
- 小米应用商店
- OPPO软件商店
- Vivo应用商店
- 应用宝
准备材料
- 应用截图(至少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故障排查
编译失败
- 清理项目
bash
./gradlew clean- 重新同步
bash
./gradlew --refresh-dependencies- 检查JDK版本
bash
java -version
# 应该是JDK 17签名失败
- 检查keystore文件路径
- 验证密码是否正确
- 检查keystore文件是否损坏
APK无法安装
- 卸载旧版本
- 检查签名是否一致
- 检查最低SDK版本
运行崩溃
- 查看logcat日志
- 检查混淆规则
- 使用debug版本定位问题
