前言
在开发中,我们写的某些sdk要当作aar供自己或者别人使用,总会遇到一些坑。
下文则是提到一些本人在aar打包遇到的一些坑,以及上传到github后,引用时遇到的一些坑,有些问题我可能给不了你答案(本人菜鸡开发),请见谅!
第一步:
将app目录下的gradle文件的第一行代码,例如:applyplugin:'com.android.application'改为apply plugin: 'com.android.library',如图:
第二步:
将applicationId删除或者注释,如图:
第三步:
如果在AndroidManifest.xml文件中,设置有启动页入口,记得注释掉.
第四步:
rebuild重新编译,会在app->build->outputs->aar目录下生成aar包,如图:
简单的4步,一个project就打包成一个aar了,但是,如果我们在项目引用有远程依赖,例如:compile'com.squareup.okhttp3:logging-interceptor:3.6.0',aar是无法加载到这些远程依赖的,这时候就需要用到远程或者本地maven库了。
生成远程或本地maven:
第一步:
在app目录下的build-gradle文件中添加以下代码:
本地maven:
applyplugin:'maven'
uploadArchives {
repositories {
mavenDeployer {
repository(url:"file://localhost/" + System.getenv("ANDROID_HOME") + "/extras/android/m2repository/")
// repository(url: "file://localhost/" + "G://android maven")
pom.version =android.defaultConfig.versionName //设置s dk的版本号跟project版本号一致,亦可自定义
pom.groupId ='com.xxx' //公司或个人
pom.artifactId ='xx_sdk' //某功能的sdk
}
}
//aar包内包含注释
task androidSourcesJar(type: Jar) {
classifier = 'sources' from android.sourceSets.main.java.sourceFiles
}
artifacts {
archives androidSourcesJar
}
其中,file://localhost/" + System.getenv("ANDROID_HOME") + "/extras/android/m2repository/路径为你定义的android sdk的目录下的m2repository文件夹,例如我的就是"D:\AndroidSDK\extras\m2repository\com\android"。当然你也可以自定义本地maven的路径。
远程maven:
暂时省略。。。
第二步:
使用android studio自带的Terminal进入到module的文件夹,然后执行gradle uploadArchives。如图:
uploadArchives完成之后,会显示BUILD SUCCESSFUL。
打开第一步定义的生成路径就能看到你的本地maven生成的aar相关文件了。
第三步:
在github上面创建一个远程repository,如图所示:
记住要选择最下面的选项,为什么呢?因为选择New repository的时候,远程依赖compile的时候可能会报Failed to resolved错误,如图:
(因为这个错误浪费我很多时间去解决,具体原因未知。For input string:"
创建仓库完毕后,复制地址,然后git clone https://github.com/xxx/xxx.git到本地maven文件夹(其实步骤应该是先克隆远程仓库到本地,再uploadArchives生成aar相关文件到maven)。
然后就是提交到远程仓库。
git add.
git commit -m "提交日志"
git push
完毕后,github上面的respository就能看到上传的aar相关文件了。
第四步:
远程调用自己上传的aar文件
1.在project目录下的build-gradle文件中添加如下代码:
allprojects {
repositories {
google()
jcenter()
mavenCentral()
maven {
url 'https://github.com/xxxsdk/xxx_sdk/raw/master'
}
}
}
xxxsdk是你新建仓库的目录名称
xxx_sdk则是他的子项,也就是项目名
raw这个关键字,怎么说呢,因为github默认的使用tree目录,但是我使用tree的话,在编译的过程中会报第三步的错误。所以,我觉得能用raw就用raw吧,我也不知道为什么。
2.在app的build-gradle中添加引用:
compile ('com.your_company:your_sdk:1.0@aar') {transitive =true }
其中,transtive=true是可能在代码调用不到aar远程依赖的情况下添加的。
然后,编译通过就可以正常使用了。
最后说两句:
由于本人技术有限,各位看管大佬见笑了。
本文是由于开发公司项目中遇到的问题一点点总结的,希望能帮助到需要帮助的人(至于远程maven那块没写,是因为暂时没用到,没去研究)
本文参考以下文章:
发布aar(包含源码)到Github上供别人依赖引用 -
将aar发布到github并在项目中引用 - CSDN博客
android - Can an AAR include transitive dependencies? - Stack Overflow