使用Jitpack发布开源Java库的详细流程
目录
- gradle
- 发布流程
- 1.创建module
- 2.Gradle插件设置
- 3.项目上传github
- 4.github创建relase版本
- 5.发布开源库
- 6.使用
- 关于多模块moudle
- maven
- 关于多模块module
- 官方实例项目
很久之前也写过一篇使用Jitpack发布Android开源库的文章,详见Android发布项目到jitpack的完整步骤
近来因为工作原因,又重新整理总结一些使用Jitpack的相关使用技巧,由于现在Java常用的构建工具为Gradle和Maven,所以准备分为两大部分讲解下这两个构建工具如何发布Jitpack的开源库
gradle
gradle主要讲解以Android项目为主,如果是普通的Java项目使用了gradle进行了依赖管理,那么流程是一样的,按照步骤来即可
发布流程
1.创建module
先是创建一个module,在里面实现你自己的相关代码
输入你自己想要的module名和包名,module名保留那两个省略号(改后面的名字即可)
我这里则是创建了一个update的module作为示例,如下图所示:
然后就可以在里面写自己的代码了(当然,我这里是Android的项目,可以在里面写Android的页面等代码),和平常开发一样
2.Gradle插件设置
默认各位做完了自己的开发工作,为了演示,我这里简单地写了个测试类,用来弹窗
首先,在项目的根gradle设置中增加以下代码(其实就是个打包插件):
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
在module中的gradle文件增加下面代码:
id 'com.github.dcendents.android-maven' //这里是我自己的github账户,需要改成你自己的 group = 'com.github.stars-one'
3.项目上传github
这里不多说了,默认各位都懂用github了
4.github创建relase版本
5.发布开源库
访问jitpack的官网https://jitpack.io/,输入我们开源库的名字,找到我们的开源库,选择get it
即可发布版本
发布的版本,需要等待一段时间(最长要15分钟),由Jitpack服务器进行编译的操作,之后看到状态
6.使用
之后再gradle文件添加仓库源和依赖即可使用,可以贴心一点把此引用技巧补充到项目的readme.md
文件中,这样便大功告成!
关于多模块moudle
上面演示只是试了一个项目中存在单个module的情况,但是有时候我们一个项目可能分了几个module,这几个module之间有一个是必须的,而其他则是可选的,你们这个时候应该如何操作呢?
答案很简单,和上述的操作是一样的
但是之后,在Jitpack发布成功后,你得手动去看下log日志,来确定版本号
查看log直接翻到末尾处,可以查看到module
之后引用就不用多说了吧
implementation 'com.github.stars-one.android-component-libray:update:0.2' implementation 'com.github.stars-one.android-component-libray:webviewBase:0.2'
PS:这里需要注意,有多个module后,不要自以为之前那种方式是一次性引入全部依赖的,如下所示
//这样依赖,项目中不会报错,但是无法使用具体的类的(即引用无效) implementation 'com.github.stars-one.android-component-libray:0.2'
maven
上面主要是讲解的了Gradle项目,再来补充下Maven项目
Maven相对于Gradle来说,就比较简单了,只要你新建的是一个maven项目,上传到github之后,按照上述的操作进行发布即可
但是,为了方便使用,我们需要配置下只pom.xml,设置主要为了可以看注释文档和源码,
pom.xml配置如下:主要是配置了下插件即可
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.2</version> <configuration> <!-- Compile java 7 compatible bytecode --> <source>1.7</source> <target>1.7</target> </configuration> </plugin> <plugin> <!-- Create sources.jar --> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-source-plugin</artifactId> <executions> <execution> <id>attach-sources</id> <goals> <goal>jar</goal> </goals> </execution> </executions> <artifactId>maven-javadoc-plugin</artifactId> <executions> <execution> <id>attach-javadocs</id> <goals> <goal>jar</goal> </goals> </execution> </executions> </plugins> </build>
需要注意的是:最后使用Jitpack发布的时候,包名是com.github.stars-one,不会使用在pom.xml中定义的包名和版本号,如下面两个截图可以说明:
关于多模块module
多模块的话,其实和单module有些类似,这里就不过多展开
不过,官方给的示例中,明确了可以直接导入所有所有依赖
官方实例项目
单modulejitpack/maven-simple: Example Maven project demonstrating the use of
多module jitpack/maven-modular: Example multi-module Maven project
参考
Building :: Documentation for JitPack.io
小记多lib module上传JitPack_chidh的博客-CSDN博客
到此这篇关于使用Jitpack发布开源Java库的文章就介绍到这了,更多相关Jitpack发布开源Java库内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!