將自己的android 專案釋出到jCenter上面去提供給別人(待整理)
參考:https://blog.csdn.net/xuchao_blog/article/details/62893851
註冊Bintray
說到註冊,大家第一時間肯定是想到去官網註冊。但是,現在官網首頁的註冊入口(上面第一張圖)已經變成組織的註冊了,並不是個人註冊。所以我們要去個人註冊入口:
傳送門:https://bintray.com/signup/oss
register2
在上面這個頁面註冊就對了。也可以用第三方登入,我是直接用Github登入(好像其它兩個在我國也登入不了),省事。
建立一個Maven倉庫
註冊完登入進去後,點選“Add New Repository”,新建倉庫:
create
接下來,我們會看到這麼一個介面:
create1
Name填maven,Type選Maven,Default Licenses選Apache-2.0,Description是描述,隨便填,點選Create。然後回到主頁就會在剛剛“Add New Repository”下面多了一個叫maven的倉庫。
配置build.gradle
在你Project的build.gradle檔案中加入Maven和Jfrog Bintray的依賴外掛:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.3'
//下面這兩句
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
你不一定要和我用同樣版本的外掛,說不定你用的時候就不是這個版本了。建議去Github上看看最新的版本:
Maven:https://github.com/dcendents/android-maven-gradle-plugin
Jfrog Bintray:https://github.com/bintray/gradle-bintray-plugin
然後在library的build.gradle檔案中進行配置,這裡以我的開源控制元件CircleView為例:
gradle
整個build.gradle檔案如下:
apply plugin: 'com.android.library'
//新增這兩行
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
android {
compileSdkVersion 25
buildToolsVersion "25.0.0"
defaultConfig {
minSdkVersion 14
targetSdkVersion 25
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.1.0'
testCompile 'junit:junit:4.12'
}
//專案主頁
def siteUrl = 'https://github.com/backkomyoung/CircleView'
//專案的git地址
def gitUrl = 'https://github.com/backkomyoung/CircleView.git'
//釋出到JCenter上的專案名字
def libName = "CircleView"
//釋出到組織名稱名字,必須填寫
group = "me.songning.CircleView"
// 版本號,下次更新是隻需要更改版本號即可
version = "1.0.0"
//上面配置後上傳至JCenter後的編譯路徑是這樣的: compile 'me.songning.CircleView:library:1.0.0'
//生成原始檔
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
classifier = 'sources'
}
//生成Javadoc文件
task javadoc(type: Javadoc) {
source = android.sourceSets.main.java.srcDirs
classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
//文件打包成jar
task javadocJar(type: Jar, dependsOn: javadoc) {
classifier = 'javadoc'
from javadoc.destinationDir
}
//拷貝javadoc檔案
task copyDoc(type: Copy) {
from "${buildDir}/docs/"
into "docs"
}
//上傳到JCenter所需要的原始碼檔案
artifacts {
archives javadocJar
archives sourcesJar
}
// 配置maven庫,生成POM.xml檔案
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
//專案描述,隨意填
name 'A colorful circle view with text.'
url siteUrl
licenses {
license {
//開源協議
name 'The Apache Software License, Version 2.0'
url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
}
}
developers {
developer {
//開發者的個人資訊
id 'backkomyoung'
name 'SongNing'
email '
}
}
scm {
connection gitUrl
developerConnection gitUrl
url siteUrl
}
}
}
}
}
//上傳到JCenter
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
user = properties.getProperty("bintray.user") //讀取 local.properties 檔案裡面的 bintray.user
key = properties.getProperty("bintray.apikey") //讀取 local.properties 檔案裡面的 bintray.apikey
configurations = ['archives']
pkg {
//這裡的repo值必須要和你建立Maven倉庫的時候的名字一樣
repo = "maven"
//釋出到JCenter上的專案名字
name = libName
//專案描述
desc = 'A colorful circle view with text.'
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
javadoc {
options{
//如果你的專案裡面有中文註釋的話,必須將格式設定為UTF-8,不然會出現亂碼
encoding "UTF-8"
charSet 'UTF-8'
author true
version true
links "http://docs.oracle.com/javase/7/docs/api"
}
}
除此外,還要將user和key寫到local.properties檔案中:
sdk.dir=E\:\\Android\\Sdk
//uer和key
bintray.user=username
bintray.apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
user即為你的賬號:
user
key的話點選修改資訊:
edit
選擇左邊的“API key”,然後複製key:
key
把user和key填到上面的local.properties檔案中就ok啦。準備工作到這裡算是完成了。
執行命令
開啟Android Studio底部工具欄的Terminal視窗,輸入命令:
gradlew install(mac電腦是./gradlew install )
build
漫長的等待...可能是我的網路問題,吃了個飯回來才弄好。
succeed
顯示“BUILD SUCCESSFUL”即表示成功。
到這裡已經成功一半了,只差上傳到Bintray了。然後我們接著在Terminal視窗輸入命令:
gradlew bintrayUpload (mac電腦是./gradlew bintrayUpload)
bintrayUpload
這個很快就好~
upload
同樣,顯示“BUILD SUCCESSFUL”即表示成功。
釋出到JCenter
這時候開啟我們建立的maven倉庫,就會在裡面發現已經成功將專案上傳到倉庫裡。
maven
點選我們的專案名,進入詳情:
jcenter
點選“Add to JCenter”後:
send
直接點Send就行了。因為時差的關係,接下來就是漫長的等待稽核了。
approved
經過幾個小時,在Bintray的網站上會有提示稽核通過。這時候,就可以在Android Studio上通過compile的方式使用了。
遇到的問題
說說我遇到的問題,就是執行上傳命令的時候,顯示這個錯誤:
fail
提示找不到“maven”,原因是我當時還沒建立Maven倉庫就執行上傳命令,建立後再執行一遍命令就成功了。還有就是建立的Maven倉庫的名字一定要和build.gradle檔案裡面的repo值一致。我就遇到這一個問題。
如果你們遇到其他的問題,建議看看這篇:
Android 釋出專案到 JCenter 遇到的各種坑(http://www.jianshu.com/p/c518a10fdaed)