Android Studio安卓项目gradle命令行apk打包(详细)-夜雨聆风

Android Studio安卓项目gradle命令行apk打包(详细)

一、知识扫盲

1. 关于build.gradle

Android Studio使用Gradle来构建项目。一个AS项目中可能存在多个build.gradle文件：

Project级别：位于项目根目录下
Module级别：位于app目录或其他模块目录下

如果使用gradle命令进行构建，需要在项目根目录执行相关命令！

2. 关于compileSdkVersion与targetSdkVersion

这两个配置通常出现在app或模块目录下的build.gradle中：

配置项	作用说明
compileSdkVersion	仅用于编译时检查代码的错误和警告，不会影响运行时行为
targetSdkVersion	指定应用程序的目标SDK版本，系统会根据该版本启用相应的功能和特性

需要确保：compileSdkVersion >= targetSdkVersion

实际编译打包时使用compileSdkVersion对应的SDK版本进行打包。

2.1 SDK版本检查

拿到安卓项目时可以优先查看compileSdkVersion，然后检查Android Studio是否安装了对应版本的SDK。一般在点击Gradle提示的Sync Now后会自动安装。

2.2 仓库加速配置

项目根目录下build.gradle中repositories仓库加速，替换为国内源：

参考一（阿里云HTTP）：

maven { url "http://maven.aliyun.com/nexus/content/groups/public/"}maven { url "http://maven.aliyun.com/nexus/content/repositories/jcenter"}maven { url "http://maven.aliyun.com/nexus/content/repositories/google"}maven { url "http://maven.aliyun.com/nexus/content/repositories/gradle-plugin"}

参考二（阿里云HTTPS）：

// google()// jcenter()maven { url "https://www.jitpack.io"}maven { url "https://maven.aliyun.com/repository/releases"}maven { url "https://maven.aliyun.com/repository/google"}maven { url "https://maven.aliyun.com/repository/central"}maven { url "https://maven.aliyun.com/repository/gradle-plugin"}maven { url "https://maven.aliyun.com/repository/public"}

3. Gradle版本管理

不同安卓项目构建用的Gradle版本可能不同，一般AS会自动下载。可在gradle-wrapper.properties文件中查看版本信息。

如果因网络问题下载失败，可以使用国内镜像地址：https://mirrors.cloud.tencent.com

如果项目比较多且Gradle版本不同，建议直接复制对应版本的gradle可执行文件路径，再到项目根目录执行构建命令，无需配置系统环境变量。

3.1 gradlew打包

如果项目根目录有gradlew文件，也可以尝试使用gradlew打包。无论是gradle还是gradlew打包，都需要依靠安卓SDK platforms及build-tools等协同才能完成打包任务。

4. 核心环境组件

想要实现打包构建APK，必须了解以下3个核心概念：

JDK版本
安卓SDK platforms版本
Build-Tools版本

4.1 JDK配置

JDK是Java环境，一般使用1.8.0（对应环境变量JAVA_HOME）。理论上Gradle打包时可以在gradle.properties文件中手动指定JDK路径：

org.gradle.java.home=C:\Program Files\Java\jdk1.8.0_131

也有项目使用Java 11，建议确保安装好对应的JDK版本（安装时勾选设置环境变量即可）。

4.2 SDK Platforms与Build-Tools

安卓平台SDK platforms版本、Build-Tools、NDK其实都是Android SDK的组件！可以将Android SDK理解成开发组件管理器，它下面可以管理很多不同版本的组件。

版本对应关系：

SDK platforms版本跟compileSdkVersion相关
如果build.gradle配置compileSdkVersion 28，需要SDK platforms有安卓28版本（Android 9.0 Pie对应API 28）
新版AS会根据platforms版本自动选择对应的Build-Tools版本
一般来说：platforms数字版本 ≈ build-tools数字版本