Android開發(fā)之AAR文件的生成與使用步驟
前言
現(xiàn)在App開發(fā)組件化技術(shù)已是常態(tài),有很多的功能模塊都被抽出來成為一個個組件供給開發(fā)者使用。為了開發(fā)者使用,這些組件都會被打包,就和java中的庫一樣。在java中,一個模塊可以被打包為Jar包,而在Android中,不僅僅有java文件,還有一些其他的資源文件,所以就出現(xiàn)了AAR文件(一種打包格式),本文通過一個demo來介紹如何打包一個Library文件,生成AAR。
一、AAR是什么?
aar一種壓縮格式(打包的Library),相當(dāng)于Android里面的Jar包,不過里面可以包含Android相關(guān)的一些資源,比如說:layout, drawable等res資源。
二、使用步驟
包括生成和使用兩大部分,話不多說,讓我們開始吧。
1.生成AAR
首先我們創(chuàng)建一個Android Project,然后在里面new一個Library,這里我們就使用它默認(rèn)的名字吧。
然后就會生成這樣的一個Library,我們今天的目標(biāo)就是在這個Library實(shí)現(xiàn)一些功能,然后打包成AAR文件,可以提供給其他工程調(diào)用。
在這個Library中,我們就寫一個叫DoSomething的類,然后里面有一個printSomething的方法,這里我使用的語言是Kotlin。
package com.example.mylibrary class DoSomething { public fun printSomething(){ println("你好,你想要輸出一些東西!") } }
做完這一切準(zhǔn)備工作,就要開始打包了!我是直接在當(dāng)前Library目錄下的build.gradle文件中,添加的如下代碼。當(dāng)然了,也可以自己重新創(chuàng)建一個***.gradle文件,然后在build.gradle里面去調(diào)用(apply {‘***.gradle’}),添加如下代碼:
apply plugin: 'maven-publish' afterEvaluate { publishing { publications { debug(MavenPublication) { // Applies the component for the debug build variant. from components.debug groupId = 'com.gloomy' artifactId = 'myLibrary' version = '1.0.0' } } publishing { repositories { maven { // change to point to your repo, e.g. http://my.org/repo url = "file:///Users\\******\\Desktop\\AndroidStudy\\AAR" } } } } }
在以上代碼中,使用了maven-publish插件,之前我看網(wǎng)上也有很多使用maven插件的,但是現(xiàn)在新版本的AS里已經(jīng)使用不了了,大家要注意!maven-publish的更多使用,可以去官網(wǎng)了解一下(https://developer.android.com/studio/build/maven-publish-plugin?hl=zh-cn#kts)。其中debug表示是一個發(fā)布渠道,你可以取任何名字,而在這個閉包中的groupId,artifactId,version分別表示公司的域名,項(xiàng)目名稱以及項(xiàng)目版本號。分別對應(yīng)生成的aar名稱中的這些。
然后再往下,repositories閉包里面寫的是我們想要輸出AAR文件的位置,這里我們先生成到本地。Synchronize以下,點(diǎn)開右側(cè)的Gradle文件夾,雙擊publish就開始生成我們的AAR文件了。
如果沒有Tasks文件,需要到Preference里面去,把Gradle設(shè)置一下,去掉這個勾勾就好了。
最后在我們指定的路徑里可以看到我們已經(jīng)打包好的AAR文件了,如果我們需要打包到遠(yuǎn)程代碼倉庫上,可以將本地的生成好的AAR使用git,push上去,或者在設(shè)置文件輸出位置的時(shí)候,直接設(shè)置為遠(yuǎn)程代碼倉庫的位置。
2.AAR使用
接下來,介紹一下如何在其他工程中使用AAR文件,使用AAR有好幾種方式,這里介紹一種靈活性比較高的方式。首先在根目錄下的build.gradle里面添加如下代碼,其中那個url就是我們存放AAR文件的位置,不管是本地的還是遠(yuǎn)程代碼倉庫的都可以。
buildscript { repositories { google() mavenCentral() maven {url "file:///Users\\*****\\Desktop\\AndroidStudy\\AAR"} } } allprojects { repositories { google() mavenCentral() maven {url "file://Users\\*****\\Desktop\\AndroidStudy\\AAR"} } }
如果這個時(shí)候Synchronize失敗了,要注意去settings.gradle文件里面看一下,要保證兩邊的代碼倉庫設(shè)置一致,另外,需要把repositoriesMode設(shè)置為RepositoriesMode.PREFER_SETTINGS(好像只有新版本的AS里面有這些問題,老版本沒有)。
這時(shí)候就可以去我們app模塊的build.gradle里面去聲明依賴了, 這里可以看到我們的依賴名稱就是由之前設(shè)置的groupId,artifactId,version組成的,如果我們在之前的庫上進(jìn)行了修改,只需要將其打包的版本號進(jìn)行修改,然后在這里也隨之修改就可以了,非常的方便!
implementation 'com.gloomy:myLibrary:1.0.0'
聲明好依賴后,我們就可以來玩一把了,看看之前打包好的庫到底能不能用,來到MainActivity里添加如下代碼,然后運(yùn)行。
class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val d = DoSomething() d.printSomething() } }
最后在Logcat里面可以看到,我們的函數(shù)調(diào)用成功了!
附:注意事項(xiàng)
1.build–>Make Moudle app 不同as版本會生成app-debug.aar,用作調(diào)試使用看看log日志啥的。
2.Gradle界面-點(diǎn)擊當(dāng)前項(xiàng)目-點(diǎn)擊tasks-點(diǎn)擊build-雙擊assembleRelease生成一個app-release.aar提供開發(fā)者使用。
3. 主項(xiàng)目需要依賴AAR中所依賴的遠(yuǎn)程庫,否則會出現(xiàn)ClassNotFound異常
這里也許某個依賴庫你們的版本會發(fā)生沖突,這就需要你們協(xié)調(diào)了
4.資源命名最好統(tǒng)統(tǒng)加上你的項(xiàng)目名字前綴,比如圖片資源、string、color、dimens、layout等等,反正res目錄下所有文件最好都使用統(tǒng)一的加前綴命名,防止跟宿主app下的資源重復(fù),因?yàn)閍ar引用跟源碼引用起到的效果一樣一樣的,所有很容易出現(xiàn)資源重復(fù)引用的問題,所以加上前綴非常有必要。
5.如果該aar包里面有微信支付,分享等第三方庫,你要在主工程中使用,要記得在gradle里面替換applicationId,或者用你主工程的包名和key去獲取第三方操作的key和id
以分享為例,如果你清單文件中的分享KEY與主項(xiàng)目中的build gradle文件中的分享KEY不同的話,就會包清單文件異常的。
6.butterknife需要統(tǒng)一用8.4.0以上的版本,不然報(bào)錯 ;依我的建議,最好不用,否則有你好受的哈!
7. 如果在aar的MyAppliction里面使用了類的管理器,那么在打包成aar的時(shí)候需要將代碼抽出來做個獨(dú)立的類管理器,記住一點(diǎn),打包成aar之后所有和application有關(guān)的東西都要檢查替換,避免出現(xiàn)空指針異常。
8. AAR模塊用butterknife需要把資源R改為R2(批量替換)
9. 布局文件不要重名,否則會報(bào)找不到Id的異常
總結(jié)
到此這篇關(guān)于Android開發(fā)之AAR文件的生成與使用步驟的文章就介紹到這了,更多相關(guān)AAR文件生成使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
jenkins 遠(yuǎn)程構(gòu)建Android的過程詳解
這篇文章主要介紹了jenkins 遠(yuǎn)程構(gòu)建Android的過程詳解的相關(guān)資料,需要的朋友可以參考下2016-09-09Android Studio做超好玩的拼圖游戲 附送詳細(xì)注釋源碼
這篇文章主要介紹了用Android Studio做的一個超好玩的拼圖游戲,你是0基礎(chǔ)Android小白也能包你學(xué)會,另外附送超詳細(xì)注釋的源碼,建議收藏!2021-08-08Android 軟件自動更新功能實(shí)現(xiàn)的方法
本篇文章小編為大家介紹,Android 軟件自動更新功能實(shí)現(xiàn)的方法。需要的朋友參考下2013-04-04Android實(shí)現(xiàn)定時(shí)任務(wù)功能
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)定時(shí)任務(wù)功能,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-01-01ViewPager 與 Fragment相結(jié)合實(shí)現(xiàn)微信界面實(shí)例代碼
這篇文章主要介紹了ViewPager 與 Fragment相結(jié)合實(shí)現(xiàn)微信界面實(shí)例代碼的相關(guān)資料,需要的朋友可以參考下2016-07-07Android 校驗(yàn)email是否合法實(shí)現(xiàn)代碼
這篇文章主要介紹了Android 校驗(yàn)email是否合法實(shí)現(xiàn)代碼的相關(guān)資料,需要的朋友可以參考下2017-01-01詳解Android ContentProvider的基本原理和使用
ContentProvider(內(nèi)容提供者)是 Android 的四大組件之一,管理 Android 以結(jié)構(gòu)化方式存放的數(shù)據(jù),以相對安全的方式封裝數(shù)據(jù)(表)并且提供簡易的處理機(jī)制和統(tǒng)一的訪問接口供其他程序調(diào)用2021-06-06Android實(shí)現(xiàn)動態(tài)添加標(biāo)簽及其點(diǎn)擊事件
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)動態(tài)添加標(biāo)簽及其點(diǎn)擊事件,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-12-12