Gradle 是 Android 项目的构建工具,它可以帮助你自动化地打包和分发安卓应用。以下是使用 Gradle 进行安卓应用打包与分发的详细步骤:
1. 配置 Gradle 构建文件
a. 设置 build.gradle
文件
- 项目级
build.gradle
文件(通常在项目根目录下):- 这里定义了 Gradle 插件和项目级别的配置。
// Project-level build.gradle buildscript { repositories { google() mavenCentral() } dependencies { classpath "com.android.tools.build:gradle:8.0.0" // 使用最新的插件版本 } } allprojects { repositories { google() mavenCentral() } }
- 应用级
build.gradle
文件(通常在app
目录下):- 这里配置了应用的构建信息、依赖、版本等。
// App-level build.gradle plugins { id 'com.android.application' } android { compileSdkVersion 34 // 使用最新的编译 SDK 版本 defaultConfig { applicationId "com.example.myapp" minSdkVersion 21 targetSdkVersion 34 versionCode 1 versionName "1.0" testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } signingConfigs { release { keyAlias 'myKeyAlias' keyPassword 'myKeyPassword' storeFile file('path/to/keystore.jks') storePassword 'myStorePassword' } } buildTypes { release { signingConfig signingConfigs.release } } } dependencies { implementation 'androidx.core:core-ktx:1.10.0' implementation 'androidx.appcompat:appcompat:1.7.0' implementation 'com.google.android.material:material:1.9.0' implementation 'androidx.constraintlayout:constraintlayout:2.1.4' testImplementation 'junit:junit:4.13.2' androidTestImplementation 'androidx.test.ext:junit:1.1.5' androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1' }
2. 生成 APK 或 AAB 文件
a. 使用 Gradle 命令行
- 生成 APK:
- 在终端中,导航到项目根目录,运行以下命令:sh复制代码
./gradlew assembleRelease
- 生成的 APK 文件通常位于
app/build/outputs/apk/release/
目录下。
- 在终端中,导航到项目根目录,运行以下命令:sh复制代码
- 生成 AAB (推荐用于 Google Play 发布):
- 运行以下命令:sh复制代码
./gradlew bundleRelease
- 生成的 AAB 文件通常位于
app/build/outputs/bundle/release/
目录下。
- 运行以下命令:sh复制代码
b. 使用 Android Studio
- 在 Android Studio 中:
- 选择菜单
Build
->Build Bundle(s) / APK(s)
->Build APK(s)
或Build Bundle(s)
. - 等待构建完成后,你可以在弹出的对话框中找到生成的 APK 或 AAB 文件位置。
- 选择菜单
3. 签名应用
- 调试签名:通常 Gradle 会自动为调试构建生成一个调试密钥。
- 发布签名:
- 在
build.gradle
文件中配置signingConfigs
和buildTypes
,指定用于发布的签名信息(如前面的build.gradle
文件示例所示)。
- 在
4. 分发应用
a. 上传到 Google Play
- 登录 Google Play Console。
- 创建新的应用条目(如果还未创建)。
- 上传生成的 APK 或 AAB 文件。
- 填写应用的详细信息,如名称、描述、图标、截图等。
- 配置内容评级、隐私政策、价格和分发国家/地区。
- 提交应用进行审核,审核通过后发布到 Google Play。
b. 其他分发方式
- 内部测试:通过 Google Play Console 内部测试渠道分发应用给测试人员。
- 手动分发:将 APK 文件直接分发给用户(例如,通过电子邮件、公司内网等)。注意,用户需要在其设备上允许安装未知来源的应用。
5. 自动化构建与发布
- 持续集成:设置 Jenkins、GitHub Actions 或 GitLab CI/CD 等工具来自动化构建和发布过程。
- Gradle 插件:可以使用 Gradle 插件如 Gradle Play Publisher 来自动上传应用到 Google Play。
使用 Gradle 进行安卓应用打包和分发可以大大简化构建流程,并通过自动化工具提高效率。根据项目需求,你可能需要调整 build.gradle
文件中的配置或使用其他插件和工具。