android library打包發(fā)布到jitpack.io遠(yuǎn)程maven倉庫中詳細(xì)教程

本文介紹，如果將自己寫的開源代碼上傳到github.com，然后打包傳到jitpack.iomaven倉庫，這樣別人就可以通過gradle或者maven依賴使用你的開源代碼了。

implementation 'com.github.yirenyishi:common-utils:v1.0' 這是我的jar包依賴，大家可以試試哦

一、準(zhǔn)備環(huán)境

1.新建項(xiàng)目

在androidstudio中新建一個(gè)工程項(xiàng)目，建完之后，新建一個(gè)module,然后選擇library，我們將開源代碼放到這個(gè)library中。庫項(xiàng)目建好后，目錄結(jié)構(gòu)如下圖所示：

1.png

2.編寫或者復(fù)制代碼

將你要開源的代碼復(fù)制到庫項(xiàng)目中，然后用工程項(xiàng)目依賴這個(gè)庫，測(cè)試通過后，進(jìn)行下一步。如圖所示：

2.png

3.打包環(huán)境準(zhǔn)備

jitpack官方文檔，同志們一定要記得看官方文檔，因?yàn)檐浖姹镜牟粩嗟?，可能某一天這篇帖子的內(nèi)容就跟不上時(shí)代了。我這里使用的gradle版本是4.6，所以要在build中增加如下代碼。

3.png

在工程項(xiàng)目的根目錄下build.gradle中加入如下依賴，版本號(hào)請(qǐng)看官方文檔使用最新版。

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

4.png

然后在你的庫項(xiàng)目build.gradle文件中增加如下代碼

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

5.png

二、github發(fā)布版本

1.新建項(xiàng)目

在github新建一個(gè)倉庫，注意項(xiàng)目配置，最好是輸入項(xiàng)目名稱，然后其他的默認(rèn)，如圖所示：

https://github.com/yirenyishi/common-utils 這是我項(xiàng)目的地址

6.png

然后將我們的項(xiàng)目上傳到github上。

7.png

2.發(fā)布release版本

請(qǐng)看上圖，我們?cè)赾ode頁面。點(diǎn)擊release,我們發(fā)布一個(gè)新的release，其實(shí)發(fā)布release就是相當(dāng)于打包的意思。

8.png

三、發(fā)布到j(luò)itpack.io上

1.發(fā)布版本

github release發(fā)布成功后，我們打開網(wǎng)址 https://jitpack.io/ ，登陸，使用github授權(quán)登陸成功后。
我們選擇我們剛才新建的項(xiàng)目，然后點(diǎn)擊lookup，就會(huì)把你的版本號(hào)全部列出來，這時(shí)候一定要看打包日志，確認(rèn)是否打包成功，如果打包失敗，我們會(huì)看到報(bào)錯(cuò)原因。

9.png

2.如何使用

我們點(diǎn)擊get it 就可以看到如何使用了，首先添加maven 倉庫地址，然后加入如下依賴。

// 格式  com.github.github 用戶名: github 倉庫名稱 : 版本號(hào)
implementation 'com.github.yirenyishi:common-utils:v1.0'

三、報(bào)錯(cuò)異常處理

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。

這是因?yàn)閍s的gradle插件不支持你的gradle進(jìn)行自動(dòng)配置導(dǎo)致的，按圖去掉圖中勾選的，就不回報(bào)錯(cuò)了。

10.png

2.Gradle wrapper not found. Please add. Using default gradle to build.
這種就是因?yàn)槟阍诮ogithub上傳的時(shí)候沒有上傳gradle的相關(guān)文件。一下圖中所示的文件都要上傳。

112.png

上傳后重新打包發(fā)布，如果還提示這個(gè)錯(cuò)誤，請(qǐng)檢查你的gradle版本號(hào)。請(qǐng)檢查下圖中的兩個(gè)版本號(hào)是否一致。如果不一致，刪除這個(gè)目錄。然后進(jìn)入到項(xiàng)目根目錄下，在cmd中執(zhí)行如下命令 gradle wrapper --gradle-version 4.6,版本號(hào)，請(qǐng)使用你自己的版本號(hào)，執(zhí)行命令成功后會(huì)重新生成 gradle-wrapper.jar 這個(gè)文件，然后上傳重新打包發(fā)布。

13.png