Android?使用maven?publish插件發(fā)布產(chǎn)物(aar)流程實踐
背景
平時開發(fā)中會把一些獨(dú)立的功能模塊抽取出來作為sdk,既方便業(yè)務(wù)接入,又能讓其他業(yè)務(wù)線快速復(fù)用。那么我們就需要將sdk打包上傳到maven倉庫,讓業(yè)務(wù)側(cè)依賴即可。
一、編譯后的產(chǎn)物
在上傳產(chǎn)物到maven倉庫之前,我們的知道產(chǎn)物到底是什么。
Android Gradle插件根據(jù)項目gradle中應(yīng)用不同的插件類型在編譯組裝后會生成不同的產(chǎn)物:

1.1 APK 構(gòu)件
Android項目的主工程app的gradle配置文件依賴:
apply plugin: 'com.android.application'
因此,在通過編譯命令./gradlew assembleDebug 或./gradlew assembleRelease后,就會在build/outputs/apk文件下生成產(chǎn)物:

如圖,apk就是產(chǎn)物(構(gòu)件)。
1.2 AAB(Android app bundle)構(gòu)件
如果是海外市場,在Google Play上架的應(yīng)用必須要打aab包,而不是之前的apk格式。具體區(qū)別就暫不討論了~ 編譯命令為:./gradlew bundleDebug 或./gradlew bundleRelease。產(chǎn)物為:

1.3 AAR 構(gòu)件
一般的module在編譯打包后,會生成aar:

二、publish插件
有了產(chǎn)物,我們就需要把產(chǎn)物上傳到maven倉庫(一般是私有倉庫),方便公司項目直接依賴。而上傳就要用到publish插件。APG 3.6.0之前用的maven插件,之后都用maven-publish插件。
2.1 maven-publish插件使用
我們可以新建一個gradle文件,如:maven_publish.gradle。專門用來上傳aar。配置如下:
//maven-publish 新方式
plugins {
//todo 1 上傳插件
id 'maven-publish'
}
afterEvaluate{
publishing {
publications {
// Creates a Maven publication called "myPublication".
myPublication(MavenPublication) {
groupId 'com.sdk.aarpub'
artifactId 'aar-test'
version '1.2.2' // Your package version
// artifact publishArtifact //Example: *./target/myJavaClasses.jar*
artifact "build/outputs/aar/aar-test-release.aar"http://aar包的目錄
//帶上依賴 ,否則會報錯
pom.withXml {
def dependenciesNode = asNode().appendNode('dependencies')
def scopes = [configurations.compile]
if (configurations.hasProperty("api")) {
scopes.add(configurations.api)
}
if (configurations.hasProperty("implementation")) {
scopes.add(configurations.implementation)
}
if (configurations.hasProperty("debugImplementation")) {
scopes.add(configurations.debugImplementation)
}
if (configurations.hasProperty("releaseImplementation")) {
scopes.add(configurations.releaseImplementation)
}
// if (project.ext.targetType != "jar") {
// scopes.add(configurations.provided)
// }
scopes.each { scope ->
scope.allDependencies.each {
if (it instanceof ModuleDependency) {
boolean isTransitive = ((ModuleDependency) it).transitive
if (!isTransitive) {
println "<<<< not transitive dependency: [${it.group}, ${it.name}, ${it.version}]"
return
}
}
if (it.group == "${project.rootProject.name}.libs" || it.version == 'unspecified') {
return
}
if (it.group && it.name && it.version) {
def dependencyNode = dependenciesNode.appendNode('dependency')
dependencyNode.appendNode('groupId', it.group)
dependencyNode.appendNode('artifactId', it.name)
dependencyNode.appendNode('version', it.version)
dependencyNode.appendNode('scope', scope.name)
}
}
}
}
}
}
// Repositories *to* which Gradle can publish artifacts
repositories {
maven {
//上傳到項目本地倉庫
url uri('../local_mavenrepo')
// credentials {
// username "default"
// password "default"
// }
}
}
}
}在assemble命令后,執(zhí)行publish命令:
./gradlew publish
2.2 maven插件使用
舊方式:
plugins {
//todo 1 上傳插件
id 'maven'
}
uploadArchives{
// 方式一
repositories {
mavenDeployer{
repository(url: uri('../local_mavenrepo'))
//todo 2 配置版本信息 方式二
pom.groupId = 'com.sdk.aarpub'
pom.artifactId = 'aar-test'
pom.version = '1.1.0'
}
//mavenLocal 這個是本機(jī)上的maven本地緩存?zhèn)}庫
// mavenLocal()
}
}在assemble命令后,執(zhí)行uploadArchives命令:
./gradlew uploadArchives
2.3 業(yè)務(wù)側(cè)使用
在項目的根gradle文件中,配置倉庫:
maven { url '../local_mavenrepo/'}在對應(yīng)的模塊中引入依賴:
implementation 'com.sdk.aarpub:aar-test:1.2.2'
三、問題總結(jié)
3.1 報錯
項目中依賴本地aar的時候打包報錯Direct local .aar file dependencies are not supported when building an AAR.....
原因:當(dāng)打包aar時候直接依賴本地的aar是不被允許的。 解決方案:通過把依賴的aar放到單獨(dú)的模塊中,讓直接依賴本地aar變成依賴模塊。
- 新建一個文件夾aar-lib
- 新建一個libs文件夾,把
oaid_sdk_1.0.30.aar放入到libs目錄中

新建build.gradle文件,寫入如下內(nèi)容:
configurations.maybeCreate("default")
def publishArtifact = artifacts.add("default", file('libs/oaid_sdk_1.0.30.aar'))在項目的settings文件中引入該模塊:
include ':aar-lib'
刪除報錯模塊中的aar文件,替換原來依賴方式:
// implementation files('libs/oaid_sdk_1.0.30.aar') 舊的方式
implementation project(path:":aar-lib")3.2 module打包aar時依賴aar導(dǎo)致的類引用不到的問題
3.1 只是解決了在項目打包過程中依賴本地aar的問題。 當(dāng)module作為sdk同時又依賴aar時,此時接入sdk會報錯,提示引用不到aar中的類。當(dāng)然我們可以直接把a(bǔ)ar給到業(yè)務(wù)測,直接引入即可,但這樣增加了接入成本。因此,我們的解決方案跟原理跟3.1一樣,但是會把a(bǔ)ar上傳到遠(yuǎn)程庫,作為遠(yuǎn)程來依賴。
比如 A模塊依賴了oaid_sdk_1.0.30.aar,同時A模塊作為sdk是要提供給業(yè)務(wù)側(cè)app使用的。
按照3.1的方式創(chuàng)建一個aar-lib,build.gradle內(nèi)容有所不同:
plugins {
id 'maven-publish'
}
//生成文檔注釋
task androidJavadocs(type: Javadoc) {
failOnError = false
source = android.sourceSets.main.java.srcDirs
ext.androidJar = "${android.sdkDirectory}/platforms/${android.compileSdkVersion}/android.jar"
classpath += files(ext.androidJar)
}
//將文檔打包成jar
task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
archiveClassifier.set('javadoc')
from androidJavadocs.destinationDir
}
//將源碼打包,這一點對kotlin來說很重要,否則業(yè)務(wù)側(cè)無法看到源碼
task androidSourcesJar(type: Jar) {
archiveClassifier.set('sources')
from android.sourceSets.main.java.srcDirs
}
configurations.maybeCreate("default")
def publishArtifact = artifacts.add("default", file('libs/oaid_sdk_1.0.30.aar'))
afterEvaluate{
publishing {
publications {
myPublication(MavenPublication) {
groupId 'com.sdk.aarpub'
artifactId 'aar-lib'
version '1.0.0' // Your package version
artifact(androidSourcesJar)//將源碼打包進(jìn)aar,如果不需要可以去掉
artifact(androidJavadocsJar)//將注釋打包進(jìn)aar,如果不需要可以去掉
// 將aar推送到遠(yuǎn)程倉庫
artifact publishArtifact //Example: *./target/myJavaClasses.jar*
}
}
// Repositories *to* which Gradle can publish artifacts
repositories {
maven {
url uri('../local_maverepo')
// credentials {
// username "default"
// password "default"
// }
}
}
}
}執(zhí)行發(fā)布命令:
./gradlew :aar-lib:publish
讓A模塊依賴第二步中推送到遠(yuǎn)程的aar庫:
implementation 'com.sdk.aarpub:aar-lib:1.0.0'
- 重新打包A模塊,當(dāng)app依賴A模塊時候,A模塊中的aar就會被引用到了 當(dāng)然在A模塊發(fā)布的時候記得要帶上依賴:
//帶上依賴 ,否則會報錯
pom.withXml {
def dependenciesNode = asNode().appendNode('dependencies')
def scopes = [configurations.compile]
if (configurations.hasProperty("api")) {
scopes.add(configurations.api)
}
if (configurations.hasProperty("implementation")) {
scopes.add(configurations.implementation)
}
if (configurations.hasProperty("debugImplementation")) {
scopes.add(configurations.debugImplementation)
}
if (configurations.hasProperty("releaseImplementation")) {
scopes.add(configurations.releaseImplementation)
}
// if (project.ext.targetType != "jar") {
// scopes.add(configurations.provided)
// }
scopes.each { scope ->
scope.allDependencies.each {
if (it instanceof ModuleDependency) {
boolean isTransitive = ((ModuleDependency) it).transitive
if (!isTransitive) {
println "<<<< not transitive dependency: [${it.group}, ${it.name}, ${it.version}]"
return
}
}
if (it.group == "${project.rootProject.name}.libs" || it.version == 'unspecified') {
return
}
if (it.group && it.name && it.version) {
def dependencyNode = dependenciesNode.appendNode('dependency')
dependencyNode.appendNode('groupId', it.group)
dependencyNode.appendNode('artifactId', it.name)
dependencyNode.appendNode('version', it.version)
dependencyNode.appendNode('scope', scope.name)
}
}
}
}到此這篇關(guān)于Android 使用maven publish插件發(fā)布產(chǎn)物(aar)流程實踐的文章就介紹到這了,更多相關(guān)Android 發(fā)布產(chǎn)物內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- Android將項目導(dǎo)出為Library并在項目中使用教程
- Android Studio多工程引用同一個library項目配置的解決方法
- android studio library 模塊中正確引用aar的實例講解
- Android Data Binding 在 library module 中遇到錯誤及解決辦法
- Android Support Library 標(biāo)題欄(Toolbar)滾動效果實現(xiàn)方法
- Android 詳解Studio引用Library與導(dǎo)入jar
- android底部彈出iOS7風(fēng)格對話選項框(QQ對話框)--第三方開源之IOS_Dialog_Library
- 解析ADT-20問題 android support library
- Android打包上傳AAR文件到Maven倉庫的示例
- 發(fā)布?Android?library?到?Maven?解析
相關(guān)文章
Android編程實現(xiàn)ActionBar的home圖標(biāo)動畫切換效果
這篇文章主要介紹了Android編程實現(xiàn)ActionBar的home圖標(biāo)動畫切換效果,涉及Android布局、樣式、Activity及菜單相關(guān)操作技巧,需要的朋友可以參考下2017-01-01
Android獲取手機(jī)配置信息具體實現(xiàn)代碼
下面為大家介紹下使用android獲取手機(jī)配置信息的具體過程,感興趣的朋友可以參考下哈,希望對你有所幫助2013-06-06
Android 如何實現(xiàn)亮度自動調(diào)節(jié)
這篇文章主要介紹了Android 如何實現(xiàn)亮度自動調(diào)節(jié),幫助大家更好的理解和學(xué)習(xí)使用Android開發(fā),感興趣的朋友可以了解下2021-04-04
android 6.0下webview的定位權(quán)限設(shè)置方法
今天小編就為大家分享一篇android 6.0下webview的定位權(quán)限設(shè)置方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-07-07

