Android
开发中,我们经常会通过远程引用别人的代码(**Android Library
**)来实现一些功能,如引用 网络请求库 Okhttp
// 通过在Android Studio的build.gradle文件中添加依赖
dependencies {
compile 'com.squareup.okhttp:okhttp:2.4.0'
}
Android Library
)被别人优雅的引用呢?JCenter
->> 别人再通过 JCenter
引用Android Library
到 JCenter
有许多方法;其中,采用 Android Studio
的**bintray-release
插件**上传代码到 JCenter
的步骤 & 配置简单,可以使你快速、简单的发布开源项目Android Studio
**的**bintray-release
**插件方法发布开源项目(**Android Library
**) 到** JCenter
,包学包会包快!Android
开发者 远程使用你的代码Android Library
Android Studio
的build.gradle
文件中添加一句依赖即可。如下图dependencies {
compile 'com.squareup.okhttp:okhttp:2.4.0'
}
对 jar
包 / aar
包的引用
jar
包 / aar
包aar
文件对于 Android
代码引用方式主要有2种方式:
eclipse
: 下载包 --> 放入到 lib
文件目录Android Studio
:在build.gradle
文件中添加依赖。如下图dependencies {
compile 'com.squareup.okhttp:okhttp:2.4.0'
}
// 当然,Android Studio 也可以通过 下载包 --> 放入到 lib 文件目录 的方式进行包的引用
Android library
文件服务器
Maven
仓库 = 中央远程仓库
Bintray
公司维护,Bintray
负责将开发者上传的Library
传到JCenter
中Maven Central
则由sonatype.org
维护Android Library
到JCenter
的原理图帮助理解:
JCenter
= 仓库,Bintray
= 送货卡车,代码库 = 货物
本文主要讲解如何通过bintray-release
插件快速上传代码(Library
)到 Jcenter
注:
Github
账号进行注册 & 登录具体如下图
Module
文件夹Module
文件夹的结构和 原有的项目文件夹(app
)非常类似View
为例子View
代码包括:1个类文件 & 属性文件关于如何上传到Github
,此处不作过多描述。
bintray-release
插件包括在Module
& 项目 的Gradle
文件配置:
Module
的Gradle
文件中配置<-- 配置代码 -->
// 配置1
apply plugin: 'com.novoda.bintray-release' // 添加bintray插件
// 配置2
publish {
userOrg = 'carson-ho' // Binary用户名
repoName = 'CircileView' // Binary上的刚才新建的仓库名(Repository)
groupId = 'scut.carson_ho' // 依赖名compile 'x:y:z'中的包名x
artifactId = 'CircileView' // 依赖名compile 'x:y:z'中的项目名y
publishVersion = '1.0.0' // 依赖名compile 'x:y:z'中的版本号z
desc = 'a CircileView' // 对该开源组件的说明
website = 'https://github.com/Carson-Ho/DIY_View' // VCS地址,即填写项目上传的Github地址
}
// 特别注意:保持你的library module的名字同artifactId一样
// 1. 背景
// 在Bintray上你的项目的maven-metadata.xml文件的路径=gruopId+"/"+module名称
// 如你的groupId=scut.carson_ho,artifactId是CircileView,但module名称是circlelibrary
// 此时,项目文件在scut.carson_ho.CircileView目录下的,但maven-metadata.xml文件却是在scut.carson_ho.circlelibrary目录下的。
// 2. 冲突:若你有多个项目groupId一样 & artifactId不一样,但module名称都是library的话,maven-metadata.xml文件的地址可能会一样,即都是:gruopId+"/"+module名称,那么就可能产生冲突
// 3. 解决方案:保持module名称和artifactId一致
Gradle
文件中配置<-- 配置代码 -->
// 配置1
classpath 'com.novoda:bintray-release:0.3.4'
// 配置2
allprojects {
tasks.withType(Javadoc) {
options.addStringOption('Xdoclint:none', '-quiet')
options.addStringOption('encoding', 'UTF-8')
}
}
allprojects {
tasks.withType(Javadoc) {
options{
encoding "UTF-8"
charSet 'UTF-8'
links "http://docs.oracle.com/javase/7/docs/api"
}
}
}
AndroidStudio
的 Terminal
输入以下命令// 每行命令均用空格隔开,此处是为了展示才会分行
<-- Windows版本 -->
gradlew.bat clean build bintrayUpload
-PbintrayUser=carson-ho // Binary用户名
-PbintrayKey=************* // Binary上的API key,具体获取见下说明
-PdryRun=false
<-- Mac版本 -->
./gradlew clean build bintrayUpload
-PbintrayUser=carson-ho
-PbintrayKey=*****************************
-PdryRun=false
Jcenter
网站)// 错误日志:说明权限有问题
bash: ./gradlew: Permission denied
// 解决方案:获得权限,直接在终端输入以下命令
chmod +x gradlew
JCenter
了,可进入查看相关信息但此时还不能够被外部直接被引用,请继续往下看。
JCenter
Android Library
了!Jcenter
**讲解完毕当需要进行Android Library
版本更新时,只需要以下2个步骤:
Module
的Gradle
文件中的配置2中 重新配置版本号其他什么都不要修改!!!
AndroidStudio
的 Terminal
输入以下命令// 每行命令均用空格隔开,此处是为了展示才会分行
<-- Windows版本 -->
gradlew.bat clean build bintrayUpload
-PbintrayUser=carson-ho // Binary用户名
-PbintrayKey=************* // Binary上的API key,具体获取见下说明
-PdryRun=false
<-- Mac版本 -->
./gradlew clean build bintrayUpload
-PbintrayUser=carson-ho
-PbintrayKey=*****************************
-PdryRun=false
Binary
网站上更新了Android Library
的新版本。至此,关于 将自己代码上传到 JCenter
的步骤 已经讲解完毕。
JCenter
后,需要测试上传的代码库是否能正确被其他开发者正常引用JCenter
的代码开源库以手把手教你写一个完整的自定义View为例进行讲解
// Maven
<dependency>
<groupId>scut.carson_ho</groupId>
<artifactId>CircileView</artifactId>
<version>1.0.0</version>
<type>pom</type>
</dependency>
// Gradle
compile 'scut.carson_ho:CircileView:1.0.0'
此处仅展示通过Gradle 添加依赖。
build.Gradle
dependencies {
compile 'scut.carson_ho:CircileView:1.0.0'
}
<scut.carson_ho.circlelibrary.libraryCircle
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:background="#000000"
android:padding="30dp"
app:circle_color="#FF4081"
/>
bintray-release
**插件方法发布开源项目(**Android Library
**) 到** JCenter
**了**