發布新手的第一個開源庫－快速發布開源庫到JitPack
前言:
之前在JCenter上發布了個開源庫,各種配置挺麻煩的,但折騰之后還是總算沒出錯成功弄好了,有興趣的看一下順手點個star:多達288種動態效果的側滑菜單開源庫,滿足您項目的各種需求.但是準備弄第二個的時候雖然上傳成功,后臺也能看到文件了,但是添加依賴之后只有資源文件沒有代碼,很是郁悶.問了群里的大神之后大神推薦使用JitPack,研究了下確實挺簡單的,就是配置的時候因為百度到的東西都是過時的,走了一點彎路,現在解決了順便做個記錄,防止再次踩坑.
關于將代碼弄成開源庫我這邊是這樣考慮的,如果做開發做個一段時間的同學都應該會有自己的"快速開發框架",聽起來高大上但我的意思是指自己平時收集的代碼和寫的base等業務無關的代碼,如果你還沒有這樣的東西,那你應該嘗試著來做一下.這樣在開發其他項目的時候以module引入將會減少很多簡單代碼的書寫.另外一點考慮是以開源庫的形式使用module在構建項目的時候是非常快的,而且如果以導module的形式那一旦有更改就得重新導一遍.所以將自己"積攢"的代碼做成一個庫是一個很明智的選擇,當然如果你的代碼特別的好,分享給其他人用也是很好的.好了.廢話就這么多,下面開始正題:
JitPack官網地址:[JitPack](https://jitpack.io/)
下面就新建一個測試開源庫然后一步步演示如何發布并使用一個開源庫
1.首先用Android Studio新建一個工程,添加要發布的module
這里說一點命名的問題,一般來說要分享一個module,會給module起個簡潔的名字,然后管理module會起一個長一點的名字,比如module叫Test,項目名稱叫TestDemo,這樣如果是上傳JCenter完全沒問題,引用的時候還是引用的Test,但是在JitPack上面就會變成要引用TestDemo了,雖然內容是只有Test的內容,但是看著很奇葩啊,所以大家注意把項目名稱起好一點,module隨意.
這一步結果如圖:項目名叫Test,存放開源庫內容的module叫TestModule(AS顯示的時候是忽略大小寫的)
這里寫圖片描述
2.書寫開源庫內容
這一步沒啥說的,要開源什么就寫什么唄.我這邊就寫個BaseActivity一會測試依賴是否成功.
這一步結果如下:
這里寫圖片描述
3.在項目的build.gradle內添加內容
位置如下:
這里寫圖片描述
添加一句
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
注意:這一步是添加maven的構建插件,后面的版本號要是最新的.因為我之前網上搜的都是1.3,然后后面的步驟總是報錯不成功,所以建議寫最新的,查看最新版本去它的Github上看:android-maven-gradle-plugin
原本內容如下:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.0-beta1'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
添加后的內容如下:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.0-beta1'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
添加之后會有提示讓你Sync,按提示同步一下
這里寫圖片描述
4.在要開源的module的build.gradle下添加內容
位置如下:
這里寫圖片描述
內容在頭部添加,原本的內容是這樣的
apply plugin: 'com.android.library'
...
添加后的是這樣的
apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
group='com.github.Brioal' //Brioal替換成你自己的Github用戶名
...
現在又會出現提示Sync,再次同步
如果沒有出錯的話本地的配置基本已經成功了
接下來要將這個項目放到Github上,這大家應該都會,但我還是演示下如何用AS快速發布
這里寫圖片描述
如果AS還沒配置過Github的話點擊這個會讓你設置Github帳號,我這邊已經用過所以直接驗證密碼就行
這里寫圖片描述
注:這些操作的前提是Git已經配置好了,如果Git沒有配置好這一步會出錯,建議百度先把Git搭建好
上傳成功之后會在Github上看到剛剛上傳的項目
這里寫圖片描述
5.給項目添加一個Tag
點擊如圖所示位置:
這里寫圖片描述
顯示沒有Tag,然后點擊新建
這里寫圖片描述
我這就隨便填個
這里寫圖片描述
點擊下方的Publish即可完成創建,成功之后界面如下
這里寫圖片描述
現在我們的開源庫已經可以被使用了,這時候應該獲取使用的方式并添加到readme中
打開JitPack主頁,將你的項目的Gihub地址復制到這并點擊look up
這里寫圖片描述
如果前面沒有問題的話現在可以看到我們之前寫的Tag號,點擊get
這里寫圖片描述
會自動跳轉到使用方式,如下:
這里寫圖片描述
步驟已經很詳細了,現在我就來新建個項目測試一下
直接跳過新建項目
1.第一步在項目的build.gradle下配置
位置如下:
這里寫圖片描述
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
第二部,在app的build.gradle下添加如下
dependencies {
...
compile 'com.github.Brioal:Test:1.0'
...
}
會提示Sync,按提示同步一下
測試依賴是否成功
這里寫圖片描述
