aar 包導(dǎo)入推薦策略

策略一：官方推薦導(dǎo)入

官方 aar 導(dǎo)入

flutter 引擎依賴(lài)項(xiàng)

兵法云

中國(guó)市場(chǎng)

repo目錄信息

<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <!-- This module was also published with a richer model, Gradle metadata,  -->
  <!-- which should be used instead. Do not delete the following line which  -->
  <!-- is to indicate to Gradle or any Gradle module metadata file consumer  -->
  <!-- that they should prefer consuming it instead. -->
  <!-- do_not_remove: published-with-gradle-metadata -->
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example.my_flutter</groupId>
  <artifactId>flutter_debug</artifactId>
  <version>1.1.4</version>
  <packaging>aar</packaging>
  <dependencies>
    <dependency>
      <groupId>io.flutter</groupId>
      <artifactId>flutter_embedding_debug</artifactId>
      <version>1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>io.flutter</groupId>
      <artifactId>armeabi_v7a_debug</artifactId>
      <version>1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>io.flutter</groupId>
      <artifactId>arm64_v8a_debug</artifactId>
      <version>1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>io.flutter</groupId>
      <artifactId>x86_64_debug</artifactId>
      <version>1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>io.flutter</groupId>
      <artifactId>x86_debug</artifactId>
      <version>1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1</version>
      <scope>compile</scope>
    </dependency>
  </dependencies>
</project>

這些都是Gradle發(fā)布的Meta data容劳，最終被發(fā)布到storage.googleapis.com 這個(gè)服務(wù)端喘沿，下面的鏈接試試
https://storage.googleapis.com/download.flutter.io
上面提到flutter庫(kù)在編譯是就已經(jīng)做了架構(gòu)適配和引擎依賴(lài)構(gòu)建，原則上這些元數(shù)據(jù)都應(yīng)該被發(fā)布到服務(wù)端竭贩，這樣才能通過(guò)dependencies配置依賴(lài)獲取相應(yīng)的aar包蚜印，事實(shí)上根本沒(méi)有我們想要下載的依賴(lài)包，搜索唯一標(biāo)記 9064459a8b0dcd32877107f6002cc429a71659d1（以編譯生成POM里的version為準(zhǔn)） 無(wú)法得到想要的依賴(lài)留量。

storage.googleapis.com/download.flutter.io

鏡像配置

storage.flutter-io.cn/download.flutter.io

    implementation 'io.flutter:flutter_embedding_debug:1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1'
    implementation 'io.flutter:armeabi_v7a_debug:1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1'
    implementation 'io.flutter:arm64_v8a_debug:1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1'
    implementation 'io.flutter:x86_64_debug:1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1'
    implementation 'io.flutter:x86_debug:1.0.0-9064459a8b0dcd32877107f6002cc429a71659d1'

我自然是不愿意搞這么多配置的较木，關(guān)于aar包源數(shù)據(jù)發(fā)布上傳這部分红符，我耗了很久反復(fù)閱讀官方文檔青柄，并且在網(wǎng)上查詢相關(guān)資料，得到如下提示：
1）Stack Overflow
給出的策略预侯，是直接更改flutter SDK包里的 aar_init_script.gradle文件致开，很多大廠也是這么干的
https://stackoverflow.com/questions/75577692/any-way-to-upload-flutter-local-aar-maven-repository-to-remote-maven-repository
2）華為開(kāi)發(fā)者聯(lián)盟
分析的很透徹，最后希望你通過(guò)腳本實(shí)現(xiàn)萎馅，一言以蔽之：通過(guò)執(zhí)行 flutter build aar -v 查看flutter build aar 的執(zhí)行秘密双戳。
https://blog.csdn.net/Ever69/article/details/120494115
我還真就這么干了，好奇心害死貓糜芳§酰咳~~~
3）官方指導(dǎo)文檔真坑爹
在我們運(yùn)行flutter build aar時(shí)，其實(shí)他是借助于.android項(xiàng)目配置Gradle或者Gradle Wrapper能力峭竣，其核心工作在
flutter-SDK-Dir/flutter/packages/flutter_tools/gradle/aar_init_script.gradle文件中完成aar發(fā)布工作塘辅，具體邏輯如下：

publishing aar

綜上所述扣墩，官方文檔給出的關(guān)于aar的配置哲银，是指導(dǎo)開(kāi)發(fā)人員使用發(fā)布到本地的aar文件的方法，而且還缺少引擎依賴(lài)的相關(guān)指導(dǎo)
為了能夠簡(jiǎn)化使用flutter模塊 aar包的引入流程呻惕，我們需要有自己的Maven私服荆责，并且將flutter項(xiàng)目的aar包及相關(guān)源文件，發(fā)布到云端進(jìn)行更新和迭代亚脆。這里選擇阿里云效做院，完成這個(gè)任務(wù)

發(fā)布AAR包到Maven私服

云端選擇阿里云效 ，打開(kāi)阿里云的云效Packages官網(wǎng)：
https://packages.aliyun.com/maven
你會(huì)發(fā)現(xiàn)阿里云提供的免費(fèi)私有Maven庫(kù)服務(wù)型酥，并且介紹了Gradle 7.0前后如何發(fā)布項(xiàng)目文檔至私有倉(cāng)庫(kù)山憨。
1）更改aar_init_script.gradle文件

image.png

Starting process 'command '/Users/edwin/Library/flutter/bin/flutter''. 
Working directory: /Users/edwin/edwin/MeiTuanEdwin/my_flutter 
Command: /Users/edwin/Library/flutter/bin/flutter  #Flutter 工具的路徑
 --verbose #啟用詳細(xì)輸出瘸彤，以便查看更多構(gòu)建信息
 assemble #執(zhí)行組裝操作，即構(gòu)建過(guò)程
 --no-version-check #禁用版本檢查笛钝，F(xiàn)lutter 不會(huì)檢查是否有新版本
 --depfile /Users/edwin/edwin/MeiTuanEdwin/my_flutter/.android/Flutter/build/intermediates/flutter/debug/flutter_build.d #指定依賴(lài)文件的路徑
 --output /Users/edwin/edwin/MeiTuanEdwin/my_flutter/.android/Flutter/build/intermediates/flutter/debug #指定輸出目錄的路徑
 -dTargetFile=lib/main.dart #指定入口文件的路徑
 -dTargetPlatform=android #指定目標(biāo)平臺(tái)為 Android
 -dBuildMode=debug #指定構(gòu)建模式為調(diào)試模式
 -dTrackWidgetCreation=true #啟用 Flutter 的控件創(chuàng)建跟蹤
 debug_android_application

看明白了吧质况，該命令的目標(biāo)是構(gòu)建一個(gè)用于調(diào)試的 Android 版本的 Flutter 應(yīng)用程序，output命令指定了輸出目錄玻靡。
我們看看output文件夾所在的環(huán)境：

aar包中間產(chǎn)物

這說(shuō)明我們的 Flutter 模塊就是用來(lái)生成 aar 包的對(duì)應(yīng)資源而建立的结榄，那我們完全可以在 Flutter 項(xiàng)目的 build.gradle 文件中添加一個(gè) task 用于發(fā)布 aar 包，發(fā)布任務(wù)通過(guò)publish.gradle文件完成囤捻。實(shí)現(xiàn)如下：

// publish flutter-debug.aar
//plugins {
//    id 'java'
//    // Gradle 7.0+ 版本
//    id 'maven-publish'
//}

group 'com.example.my_flutter'
version '1.1.4'
def artifactIdStr = 'flutter_debug'

apply plugin: 'maven-publish'
task comps { // 讓我們看看它有哪些組件：
    afterEvaluate {
        println("Components: " + components*.name)  // 代碼 1
    }
}
def directoryToPublish = "$rootDir.parentFile/build/host/outputs/repo/com/example/my_flutter/flutter_debug/$project.version"
afterEvaluate { // 代碼 2
    publishing {
        publications {
            flutter(MavenPublication) { // 代碼 3
                from components.debug
                println("groupId = " + groupId + ",artifactId = " + artifactIdStr + ",version = " + version + ",buildDir = " + buildDir)
                groupId = "$project.group" // 代碼 4
                artifactId = artifactIdStr
                version = "$project.version"

//                artifact "$buildDir/outputs/aar/flutter-debug.aar" //aar artifact you want to publish
                // artifact "$directoryToPublish/${artifactIdStr}-${project.version}.aar"
                // artifact "$directoryToPublish/${artifactIdStr}-${project.version}.module"
                // artifact "$directoryToPublish/${artifactIdStr}-${project.version}.pom"

//                artifact("$directoryToPublish/${artifactIdStr}-${project.version}.aar") /*{
//                    classifier 'aar' // 使用 'aar' 作為分類(lèi)器
//                }*/
//                artifact("$directoryToPublish/${artifactIdStr}-${project.version}.module") /*{
//                    classifier 'module' // 使用 'module' 作為分類(lèi)器
//                }*/
//                artifact("$directoryToPublish/${artifactIdStr}-${project.version}.pom")/* {
//                    classifier 'pom' // 使用 'pom' 作為分類(lèi)器
//                    extension 'pom' // 設(shè)置為 'pom' 類(lèi)型
//                }*/
            }
        }
        repositories { // 代碼 5
//            maven {
//                url = 'https://packages.aliyun.com/maven/repository/2443959-release-V0Shv7/'
//                credentials {
//                    username = '##############'
//                    password = '*****************'
//                }
//            }
            maven {
                url = 'https://packages.aliyun.com/maven/repository/2443959-snapshot-5T0GnA/'
                credentials {
                    username = '###############'
                    password = '******************'
                }
            }
        }
    }
}

其中臼朗， 代碼 1 處的 components*.name 用于確認(rèn)當(dāng)前Gradle 會(huì)構(gòu)建那些組件用于發(fā)布，輸出結(jié)果如下：

Components

GVA

def currentTask = gradle.startParameter.taskNames.join(" ")
println("currentTask =" + currentTask)
if (!currentTask.contains("Aar")) {
    apply from: "../../publish.gradle"
}

這段代碼的意思就是說(shuō)唐含，在 Flutter 項(xiàng)目編譯過(guò)程中，準(zhǔn)確的說(shuō)是評(píng)估的時(shí)候沫浆，把發(fā)布任務(wù)引入捷枯，等compile完成后執(zhí)行發(fā)布任務(wù)。
最后专执，
咱們?cè)賵?zhí)行一遍 flutter build aar 指令淮捆，發(fā)現(xiàn).android/Flutter/build/目錄下沒(méi)有生成 flutter 發(fā)布文件夾，
逗我呢本股？攀痊！
老鐵，這里還得執(zhí)行一遍 ./gradlew publish 命令痊末，執(zhí)行發(fā)布任務(wù)蚕苇，現(xiàn)在可以愉快的看到如下效果了：

阿里云效snapshot 庫(kù)

那么哩掺，現(xiàn)在趕快在另一個(gè)項(xiàng)目里試一下配置依賴(lài)吧凿叠。
首先在需要使用 aar包的項(xiàng)目根目錄下 root.gradle 中配置 Maven 庫(kù)，參考如下：

Maven 庫(kù)地址

dependencies

Flutter 引擎依賴(lài)包

Shell腳本一鍵打包發(fā)布

等等老哥～
道理我都聽(tīng)明白了舱禽，上面的代碼還是要手動(dòng)更改 Flutter 項(xiàng)目中的 build.gradle 文件啊炒刁。更要命的是，如果執(zhí)行 flutter clean 清理一遍編譯工程誊稚，剛剛的文檔不都白瞎了了么翔始。你這是讓我哭嗎罗心？我說(shuō)老兄你等等，這不是上腳本呢嘛～

1. 首先城瞎，我們把發(fā)布文件 publish.gradle 移動(dòng)到 my_flutter 項(xiàng)目根目錄下渤闷，并在根目錄下創(chuàng)建一個(gè)shell 腳本文件 apply_patch.sh，如下：

   
   
   root 目錄
2. 然后脖镀，將 publish.gradle 導(dǎo)入到 Flutter 項(xiàng)目中的訴求未變飒箭，通過(guò) shell 腳本實(shí)現(xiàn)如下：

# 獲取當(dāng)前腳本所在目錄的絕對(duì)路徑
SCRIPT_DIR=$(dirname "$(readlink -f "$0")")

# 切換到Flutter項(xiàng)目的根目錄
cd "$SCRIPT_DIR/.android/Flutter" || exit
# 在Flutter/build.gradle文件中執(zhí)行命令:
# 1）在android配置項(xiàng)前插入 apply 發(fā)布應(yīng)用
# 2）-i '.bak'，備份原始文件
sed -i '.bak' '/^android {/i\
def currentTask = gradle.startParameter.taskNames.join(" ") \
println("currentTask =" + currentTask)\
if (!currentTask.contains("Aar")) {\
    apply from: "../../publish.gradle"\
}' "$SCRIPT_DIR/.android/Flutter/build.gradle"

通過(guò)腳本的形式蜒灰，將發(fā)布任務(wù)添加到 .android/Flutter 項(xiàng)目中弦蹂，腳本的含義都寫(xiě)在了注釋里。

3. 插入完成后强窖，還要進(jìn)行發(fā)布工作凸椿，仍然通過(guò)腳本完成，如下：

# 切換到 ./android 目錄下執(zhí)行發(fā)布任務(wù)
cd "$SCRIPT_DIR/.android" || exit
./gradlew publish --info > publish.log 2>&1
if [ $? -ne 0 ]; then
    echo "發(fā)布任務(wù)失敵崮纭削饵！查看 publish.log 獲取更多信息。"
    exit 1
fi

這里把發(fā)布日志都打印在了 publish.log 文檔里未巫，如果發(fā)布失敗./gradlew publish --info 會(huì)提供詳細(xì)的失敗信息窿撬。

4. 版本控制，aar 包是有自己的版本號(hào)的叙凡，比如 1.1.4劈伴。為了統(tǒng)一控制 version號(hào)，不要手動(dòng)更改gradle 文件握爷，我們引入如下腳本：

# 替換 publish.gradle 中的版本號(hào)
OLD_VERSION=$(grep -o "version '[0-9]\+\.[0-9]\+\.[0-9]\+'" "$SCRIPT_DIR/publish.gradle" | head -n 1)
if [ -z "$OLD_VERSION" ]; then
  echo "無(wú)法獲取舊版本號(hào)跛璧！"
  exit 1
fi

sed -i'.bak' "s/$OLD_VERSION/version '$BUILD_NUMBER'/" "$SCRIPT_DIR/publish.gradle" || { echo "版本號(hào)替換失敗新啼！"; exit 1; }

5. 合并所有腳本追城，得到完整的發(fā)布腳本apply_patch.sh，腳本如下

作為一個(gè)廣告引流專(zhuān)業(yè)戶燥撞，還是詳見(jiàn) github 代碼庫(kù)吧～

6. 執(zhí)行 ./apply_patch.sh 腳本

到這里整個(gè)一鍵打包發(fā)布工作就完成了

FAQ

1.local.properties 類(lèi)似文件屬性配置時(shí)座柱，不要加引號(hào)，不然在 gradle 文件中獲取到的值要處理

image.png

2. gradle 的版本要配置成 7.5物舒，太高版本不見(jiàn)得穩(wěn)定色洞，而且低版本調(diào)用他的時(shí)候存在融合問(wèn)題：

   
   
   image.png
3. gradle 和 ./gradlew 是兩碼事，前者是你在全局變量配置的 gradle 版本冠胯，后者是gradle wrapper 中配置的 gradle 版本7.5

4. 腳本可能會(huì)有一些warning 提示火诸，沒(méi)有跑通不要隨意更改腳本，不然永遠(yuǎn)跑不起來(lái)了

   
   
   image.png

參考文獻(xiàn)

1. my_flutter庫(kù)地址 https://github.com/hongyi0609/my_flutter
2. GitHub庫(kù)地址 https://github.com/hongyi0609/MeiTuanEdwin
3. flutter 國(guó)內(nèi)鏡像 https://flutter.cn/community/china?tab=macos
4. aar 服務(wù)端 https://storage.googleapis.com/download.flutter.io
5. 華為開(kāi)發(fā)者聯(lián)盟分析 https://blog.csdn.net/Ever69/article/details/120494115
6. 私服配置 https://stackoverflow.com/questions/75577692/any-way-to-upload-flutter-local-aar-maven-repository-to-remote-maven-repository
7. 阿里云效：https://packages.aliyun.com/maven