新手简易版教程
一、简单理解Gradle
配置gradle的过程与配置mk、bp一样. 可以简单理解为: 为打包apk项目配置编译环境与编译资源.
1、编译资源
- Source Code (java代码)
- Resource Files (xml资源)
- AIDL Files (IPC)
- Dependencies (jar 、aar 、jni等 )
- AndroidManifest (清单文件)
- Assets (不压缩资源)
2、编译环境
- JAVA环境
- Android环境
- Gradle环境
- NDK环境
下面压缩包中带了默认环境, 可以不做修改. 想了解更多,参考 Gradle 编译环境
二、迁移指南
为了更直观的理解配置gradle的过程. 以NetworkOptimization为例.
从原本的Android.mk编译, 更换为Gradle编译, 需要进行如下操作:
1、补充必要成员
针对当前的mk项目,需要补充必要的gradle成员.
以下为使用gradle编译所需的成员
gradle目录、gradlew、gradlew.bat、gradle.properties、.gitignore
local.properties文件 、setting.gradle文件、build.gradle文件
想了解成员定义, 参考 Gradle 成员介绍
可以直接下载压缩包,根据"添加后"的项目结构放置成员
image.png
补充完成之后对比"添加后"项目结构.保持一致即可.
image.png
2、修改成员
local.properties用于配置本地Android SDK目录, 即Android环境
sdk.dir="你本地的sdk目录"
如果本地没有Android SDK , 参考下面文档进行下载
下载Android IDE IDE指南 更新 IDE 和 SDK 工具 命令行更新sdk
gradle默认rootProject指定为根目录, 如果项目结构满足则不修改setting.gradle, 否者参考 Gradle - setting
3、参照mk配置资源
各种编译资源在build.gradle中配置
3-1、Source Code (java代码)
image.png
3-2、Resource Files (xml资源)
image.png
3-3、AIDL Files
image.png
3-4、Jni
3-4-1、so
image.png
3-4-2 、c & cpp
image.png
3-5、assets
image.png
3-6、AndroidManifest
image.png
3-7、Dependencies
静态资源
image.png
动态资源
image.png
Gradle更多依赖方式参考Gradle 依赖方式与差异
更多举例参考 Gradle .mk .bp三者差异
4、配置build.gradle中的其他项
4-1、混淆
build.gradle 配置混淆
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
更多混淆说明 参考 混淆
4-2、签名
签名说明 参考 Gradle 应用签名
4-3、变体
存在依据不同条件,有不同配置的情况参考(if else) Gradle Flavor
5、最终配置对比
5-1、Android.mk
LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)
LOCAL_PACKAGE_NAME := xxx
# 证书
LOCAL_CERTIFICATE := xxx
...
# manifest
LOCAL_MANIFEST_FILE := AndroidManifest.xml
# src
LOCAL_SRC_FILES := $(call all-java-files-under, src)
# res
LOCAL_RESOURCE_DIR += \
$(addprefix $(LOCAL_PATH)/app/, res) \
$(addprefix $(LOCAL_PATH)/, res)
# assets
LOCAL_ASSET_DIR := $(LOCAL_PATH)/assets
# dependencies
LOCAL_JAVA_LIBRARIES += \
miui-gson \
miui-eventbus \
LOCAL_STATIC_JAVA_LIBRARIES += \
geo_izatsdk \
geo_AMap2DMap \
geo_rxjava \
geo_rxandroid \
androidx.vectordrawable_vectordrawable-animated \
androidx.exifinterface_exifinterface \
androidx.swiperefreshlayout_swiperefreshlayout \
androidx.localbroadcastmanager_localbroadcastmanager \
androidx.appcompat_appcompat-latest
LOCAL_STATIC_ANDROID_LIBRARIES += \
androidx.fragment_fragment-latest \
androidx.appcompat_appcompat-resources-latest \
androidx.appcompat_appcompat-latest \
androidx.preference_preference-latest \
androidx.vectordrawable_vectordrawable-animated \
androidx.exifinterface_exifinterface \
androidx.swiperefreshlayout_swiperefreshlayout \
androidx.localbroadcastmanager_localbroadcastmanager \
androidx.legacy_legacy-support-v13 \
androidx.recyclerview_recyclerview \
androidx.annotation_annotation \
include $(BUILD_PACKAGE)
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES += \
geo_izatsdk:libs-mk/izatsdk.jar \
geo_AMap2DMap:libs-mk/AMap2DMap_6.0.0_AMapSearch_7.3.0_AMapLocation_5.0.0_20200609.jar \
geo_rxjava:libs-mk/rxjava-1.1.0.jar \
geo_rxandroid:libs-mk/rxandroid-0.24.0.jar \
include $(BUILD_MULTI_PREBUILT)
include $(call all-makefiles-under,$(LOCAL_PATH))
5-2、Gradle
// 编译需要的仓库和依赖
buildscript {
repositories {
maven { url 'http://sdk.pt.miui.com/miuisdk/maven2/' }
maven { url 'http://sdk.pt.miui.com/miuisdk/miuix/' }
maven { url 'http://artifactory.d.xiaomi.net/artifactory/artifactory-releases/' }
google()
jcenter()
mavenCentral()
}
dependencies {
classpath 'com.miui.tools.build:gradle:3.4.0'
}
}
// 应用'com.android.application'插件, 项目编译为android application
apply plugin: 'com.android.application'
android {
sourceSets {
main {
manifest.srcFile "AndroidManifest.xml"
java.srcDirs = [
"src",
]
res.srcDirs = [
"res",
"app/res",
]
assets.srcDirs = [
"assets",
]
}
}
// 编译sdk版本
compileSdkVersion 29
// 编译工具版本
buildToolsVersion "28.0.3"
// jdk环境
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
// 签名
signingConfigs {
platformKey {
keyAlias 'platform_key'
keyPassword 'android'
storeFile rootProject.file('keystore/platform.debug.keystore')
storePassword 'android'
}
}
// 不同条件的多样性
buildTypes {
release {
signingConfig signingConfigs.platformKey
}
}
// lint检查设置
lintOptions {
checkReleaseBuilds false
abortOnError false
}
}
dependencies {
implementation("org.greenrobot:eventbus:3.3.1")
implementation "com.google.code.gson:gson:2.6.2"
implementation files('libs-mk/izatsdk.jar')
implementation files('libs-mk/AMap2DMap_6.0.0_AMapSearch_7.3.0_AMapLocation_5.0.0_20200609.jar')
implementation files('libs-mk/rxjava-1.1.0.jar')
implementation files('libs-mk/rxandroid-0.24.0.jar')
implementation "androidx.vectordrawable:vectordrawable-animated:1.1.0"
implementation "androidx.exifinterface:exifinterface:1.2.0"
implementation "androidx.appcompat:appcompat:1.2.0"
implementation "androidx.legacy:legacy-support-v13:1.0.0"
implementation "androidx.recyclerview:recyclerview:1.1.0"
}
allprojects {
repositories {
maven { url 'http://sdk.pt.miui.com/miuisdk/maven2/' }
maven { url 'http://sdk.pt.miui.com/miuisdk/miuix/' }
maven { url 'http://artifactory.d.xiaomi.net/artifactory/artifactory-releases/' }
maven { url 'https://jitpack.io' }
google()
jcenter()
mavenCentral()
}
}
6、打包验证
gradle打包指令
检查依赖并编译打包
./gradlew build
查看build目录下apk生成结果
image.png
更多参考 Gradle .mk .bp三者差异 - 操作差异
