1. 程式人生 > >將自己的android 專案釋出到jCenter上面去提供給別人(待整理)

將自己的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 '

[email protected]'
                    }
                }
                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)