Android Library 开源库 JCenter & JitPack 安装使用指南-CFANZ编程社区

一、上传开源库到JCenter

1.准备工作

步骤1：注册Bintray账号

注册地址

PS：如果Github账户使用了qq邮箱，163邮箱等可能会无法注册，可以尝试给Github账户增加一个邮箱例如 Gmail

步骤2：在Bintray上建立仓库

1.在个人中心点击 Add New Repository
2.Name 框填写仓库名；Type 框选择 maven
3.点击 Create，完成创建

步骤3：在代码项目中创建Module文件夹

步骤如下
Android Studio中
- File --> New Module -> Android Library(注意主项目的Project名不要和Library相同，可能会冲突)
- 创建成功后，你会发现Module文件夹的结构和原有的项目文件夹（app）非常类似

步骤4：将需要上传的代码存放到Module文件夹中

本文以上传一个自定义View 为例子
该自定义View代码包括：1个类文件

步骤5：将整个项目上传到 Github

//Library  build.gradle
    
apply plugin: 'com.novoda.bintray-release' // 添加bintray插件


publish {
    userOrg = 'dmingou'             // Bintray用户名
    repoName = 'AnimatedFloatingButton'          // Bintray上的新建的仓库名（Repository）
    groupId = 'qg.odm'        // 依赖名 implemention 'x:y:z'中的包名x
    artifactId = 'AnimatedFloatingButton'        // 依赖名implemention 'x:y:z'中的项目名y
    publishVersion = '1.0.0'          // 依赖名implemention 'x:y:z'中的版本号z
    desc = 'XXXXXXXX'               // 对该开源组件的说明
    website = 'https://github.com/DMingOu/AnimatedFloatingButton'  // VCS地址
}

在该项目的Gradle文件中配置

使用插件前应该看下最新版本 Bintray-release 的github地址

//Project  build.gradle
classpath 'com.novoda:bintray-release:0.9.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"
        }
    }
}

步骤2：上传项目到JCenter中

在AndroidStudio的 Terminal输入以下命令

// 每行命令均用空格隔开，此处是为了展示才会分行

<-- Windows版本 -->
gradlew.bat clean build bintrayUpload 
 -PbintrayUser=UserName  // Bintray用户名
 -PbintrayKey=*********  // Bintray上的API key
 -PdryRun=false

<-- Mac版本 -->
./gradlew clean build bintrayUpload 
 -PbintrayUser=carson-ho 
 -PbintrayKey=***************************** 
 -PdryRun=false

//一行命令直接在Terminal执行,例子如下
gradlew clean build bintrayUpload -PbintrayUser=dmingou -PbintrayKey=610e0e8f022cb3f353908e083932167bd0ff -PdryRun=false

注：获取API Key（需回到 Jcenter 网站）

上传成功提示如下：

二、发布开源库到JitPack

准备工作

在Github上传需要开源的项目，与上传JCenter步骤中的准备工作对项目代码的操作类似。

参照上传JCenter开源的准备工作的步骤3，步骤4，步骤5
步骤一、在项目的build.gradle添加插件android-maven-gradle-plugin

PS：jitpack的android-maven-gradle-plugin版本要和gradle版本对应。具体的对应呢？查看官方说明~~

如下图：

2.填写发布内容
1.填写你要发布的release代码库的版本（重要）
2.标题名字，一般填写开源库的名字
3.本次release提交的描述
4.点击 Publish relsease 按钮

发布成功后可查看到记录

步骤4：提交到JitPack

1.将GitHub项目的仓库提交到JitPack
绑定了账户后，可以在左方的 Repositories栏挑选；也可以在输入框中填入发布release的项目地址

Log栏是绿色，代表OK，点击 Get It 按钮，版本提交完成后，JitPack会自动生成引用该library的配置信息：

感谢观看，点个关注是对我最大的支持！