android library打包发布到jitpack.io远程maven仓库中详细教程

妖狐艹你老母 2022-05-17 00:05 268阅读 0赞

#### android library打包发布到`jitpack.io`远程maven仓库中详细教程 ####

> aiprose 个人随笔上线，网址 [aiprose.com][] [点击访问][Link 1]

本文介绍，如果将自己写的开源代码上传到`github.com`，然后打包传到`jitpack.io`maven仓库，这样别人就可以通过gradle或者maven依赖使用你的开源代码了。

> implementation ‘com.github.yirenyishi:common-utils:v1.0’ 这是我的jar包依赖，大家可以试试哦

### 一、准备环境 ###

###### 1.新建项目 ######

在androidstudio中新建一个工程项目，建完之后，新建一个module,然后选择library，我们将开源代码放到这个library中。库项目建好后，目录结构如下图所示：  
![这里写图片描述][70]

###### 2.编写或者复制代码 ######

将你要开源的代码复制到库项目中，然后用工程项目依赖这个库，测试通过后，进行下一步。如图所示：  
![这里写图片描述][70 1]

###### 3.打包环境准备 ######

[jitpack官方文档][jitpack]，同志们一定要记得看官方文档，因为软件版本的不断迭代更新，可能某一天这篇帖子的内容就跟不上时代了。我这里使用的gradle版本是4.6，所以要在build中增加如下代码。  
![这里写图片描述][70 2]

在工程项目的根目录下build.gradle中加入如下依赖，版本号请看官方文档使用最新版。

classpath 'com.github.dcendents:android-maven-gradle-plugin:2.1'

![这里写图片描述][70 3]

然后在你的库项目build.gradle文件中增加如下代码

apply plugin: 'com.github.dcendents.android-maven'
    group='com.github.yirenyishi'
    // group='com.github.你的github用户名'

![这里写图片描述][70 4]

### 二、github发布版本 ###

###### 1.新建项目 ######

在github新建一个仓库，注意项目配置，最好是输入项目名称，然后其他的默认，如图所示：

> [https://github.com/yirenyishi/common-utils][https_github.com_yirenyishi_common-utils] 这是我项目的地址

![这里写图片描述][70 5]

然后将我们的项目上传到github上。

![这里写图片描述][70 6]

###### 2.发布release版本 ######

请看上图，我们在code页面。点击`release`,我们发布一个新的release，其实发布release就是相当于打包的意思。  
![这里写图片描述][70 7]

### 三、发布到jitpack.io上 ###

###### 1.发布版本 ######

github release发布成功后，我们打开网址 `https://jitpack.io/` ，登陆，使用github授权登陆成功后。  
我们选择我们刚才新建的项目，然后点击lookup，就会把你的版本号全部列出来，这时候一定要看打包日志，确认是否打包成功，如果打包失败，我们会看到报错原因。  
![这里写图片描述][70 8]

###### 2.如何使用 ######

我们点击get it 就可以看到如何使用了，首先添加maven 仓库地址，然后加入如下依赖。

// 格式  com.github.github 用户名: github 仓库名称 : 版本号
    implementation 'com.github.yirenyishi:common-utils:v1.0'

### 三、报错异常处理 ###

1.Configuration on demand is not supported by the current version of the Android Gradle plugin since you are using Gradle version 4.6 or above。

这是因为as的gradle插件不支持你的gradle进行自动配置导致的，按图去掉图中勾选的，就不回报错了。

![这里写图片描述][70 9]

2.Gradle wrapper not found. Please add. Using default gradle to build.  
这种就是因为你在给github上传的时候没有上传gradle的相关文件。一下图中所示的文件都要上传。  
![这里写图片描述][70 10]

上传后重新打包发布，如果还提示这个错误，请检查你的gradle版本号。请检查下图中的两个版本号是否一致。如果不一致，删除这个目录。然后进入到项目根目录下，在cmd中执行如下命令 `gradle wrapper --gradle-version 4.6`,版本号，请使用你自己的版本号，执行命令成功后会重新生成 gradle-wrapper.jar 这个文件，然后上传重新打包发布。  
![这里写图片描述][70 11]

## 关注 ##

> aiprose 个人随笔上线，网址 [aiprose.com][] [点击访问][Link 1]

如果有问题，请在下方评论，或者加群讨论 `200909980`

关注下方微信公众号，可以及时获取到各种技术的干货哦，如果你有想推荐的帖子，也可以联系我们的。

![这里写图片描述][70 12]

[aiprose.com]: http://aiprose.com
[Link 1]: https://www.aiprose.com/
[70]: /images/20220517/8894cb567ef44c9a855c29d9f5e3193f.png
[70 1]: /images/20220517/c04a1910e7c6474aba95056e0d65bfa6.png
[jitpack]: https://jitpack.io/docs/ANDROID/
[70 2]: /images/20220517/c774d06ea6ae425792fc80c3d5f5563a.png
[70 3]: /images/20220517/732a5b93a8df4cf69a51a9b6a59c7180.png
[70 4]: /images/20220517/3ed769e8461346b6bb97a1f675fc5a5f.png
[https_github.com_yirenyishi_common-utils]: https://github.com/yirenyishi/common-utils
[70 5]: /images/20220517/0118e7ba516c4f1faf7a2158cfd4f6df.png
[70 6]: /images/20220517/9e9187ed689d496d9d50a16b782ae88d.png
[70 7]: /images/20220517/0935921ea61f44e5b4e4050c063b2eb2.png
[70 8]: /images/20220517/2fba672770a0411ead3fee75899b95c5.png
[70 9]: /images/20220517/a36c265d4b2941f19345eb13bfb92ef1.png
[70 10]: /images/20220517/d39e618e6b494f5ba6d2a69a482139b5.png
[70 11]: /images/20220517/8ba293d055b74721be6200b52d2e62dc.png
[70 12]: /images/20220517/3ee791fa57da48ebad3741c2b13ff618.png