新手簡(jiǎn)易版教程

一、簡(jiǎn)單理解Gradle

配置gradle的過(guò)程與配置mk、bp一樣. 可以簡(jiǎn)單理解為: 為打包apk項(xiàng)目配置編譯環(huán)境與編譯資源.

1登渣、編譯資源

• Source Code (java代碼)
• Resource Files (xml資源)
• AIDL Files (IPC)
• Dependencies (jar 摊求、aar 、jni等 )
• AndroidManifest (清單文件)
• Assets (不壓縮資源)

2索守、編譯環(huán)境

• JAVA環(huán)境
• Android環(huán)境
• Gradle環(huán)境
• NDK環(huán)境

下面壓縮包中帶了默認(rèn)環(huán)境, 可以不做修改. 想了解更多,參考 Gradle 編譯環(huán)境

二晕窑、遷移指南

為了更直觀的理解配置gradle的過(guò)程. 以NetworkOptimization為例.

從原本的Android.mk編譯, 更換為Gradle編譯, 需要進(jìn)行如下操作:

1、補(bǔ)充必要成員

針對(duì)當(dāng)前的mk項(xiàng)目,需要補(bǔ)充必要的gradle成員.

以下為使用gradle編譯所需的成員

gradle目錄卵佛、gradlew杨赤、gradlew.bat、gradle.properties截汪、.gitignore

local.properties文件 疾牲、setting.gradle文件、build.gradle文件

想了解成員定義, 參考 Gradle 成員介紹

可以直接下載壓縮包,根據(jù)"添加后"的項(xiàng)目結(jié)構(gòu)放置成員

image.png

補(bǔ)充完成之后對(duì)比"添加后"項(xiàng)目結(jié)構(gòu).保持一致即可.

image.png

2衙解、修改成員

local.properties用于配置本地Android SDK目錄, 即Android環(huán)境

sdk.dir="你本地的sdk目錄"

如果本地沒(méi)有Android SDK , 參考下面文檔進(jìn)行下載

下載Android IDE IDE指南 更新 IDE 和 SDK 工具 命令行更新sdk

gradle默認(rèn)rootProject指定為根目錄, 如果項(xiàng)目結(jié)構(gòu)滿(mǎn)足則不修改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

靜態(tài)資源

image.png

動(dòng)態(tài)資源

image.png

Gradle更多依賴(lài)方式參考Gradle 依賴(lài)方式與差異

更多舉例參考 Gradle .mk .bp三者差異

4、配置build.gradle中的其他項(xiàng)

4-1角虫、混淆

build.gradle 配置混淆

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

更多混淆說(shuō)明 參考 混淆

4-2沾谓、簽名

簽名說(shuō)明 參考 Gradle 應(yīng)用簽名

4-3、變體

存在依據(jù)不同條件,有不同配置的情況參考(if else) Gradle Flavor

5戳鹅、最終配置對(duì)比

5-1均驶、Android.mk

LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)

LOCAL_PACKAGE_NAME := xxx
#　證書(shū)
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

// 編譯需要的倉(cāng)庫(kù)和依賴(lài)
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'
    }
}

// 應(yīng)用'com.android.application'插件, 項(xiàng)目編譯為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環(huán)境
    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檢查設(shè)置
    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枫虏、打包驗(yàn)證

gradle打包指令

檢查依賴(lài)并編譯打包
./gradlew build

查看build目錄下apk生成結(jié)果

image.png

更多參考 Gradle .mk .bp三者差異 - 操作差異