发布开源组件到JitPack

Quibbler 2023-5-17 312

发布开源组件到JitPack


        好几个月没有更新博客,业余精力主要放到开源社区,经过近一年的一点点积累,也写了几个小组件。


        推荐将组件发布到JitPack,只需要简单的几步。比发布到Maven要方便简单的多,不需要修改项目引入额外的'maven-publish'等容易出错的gradle配置。



1、发布release

        第一步,在GitHub上发布release版本,这里以WaveLoadingCircleView仓库为例。

        新建或从选择已有的Tag发布release;

        填写版本号,组件的版本号一般为三位 X.X.X 数字;比如1.0.0、2.8.0等。

        填写发布的组件说明,bug修复还是新特性;

        可以选则上传aar,也可以忽略,借助JitPack提供。

        最后选择是否是一个pre-release的预览版本,如果组件够稳定,就发布正式的release。


        点击发布,会在仓库右侧看到所有已经发布的版本。




2、通过JitPack发布

        接着打开JitPack官网:https://jitpack.io/,输入要发布组件的仓库地址(支持GitHub、Gitee.com)(以WaveLoadingCircleView为例),点击Look UpJitPack会自动查找在GitHub仓库中所有已经发布的relase版本。

        选择需要发布的release版本点击Get it,稍等片刻,JitPack会执行编译以获取最终发布的aar。



3、常见错误

        本地能编译成功,但在JitPack平台不一定顺利,可能会遇到各种编译报错问题,导致不能Get 到最终的发布版本,现在记录一下遇到的“坑”:


        仔细看这一行“Incompatible because this component declares an API of a component compatible with Java 11 and the consumer needed a runtime of a component compatible with Java 8”,说明JitPack平台需要用Java 11,而本地默认配置的是Java 8,就需要将所有compileOptions配置改成Java 11即可:

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_11
        targetCompatibility JavaVersion.VERSION_11
    }

        编译过程中会输出编译日志,通过日志分析解决遇到的其它问题,比如:

        编译失败Loghttps://jitpack.io/com/github/quibbler01/WaveLoadingCircleView/1.0.1/build.log

        编译成功Loghttps://jitpack.io/com/github/quibbler01/SwitchButton/1.0.2/build.log



4、使用JitPack发布的组件

        使用通过JitPack发布的组件非常方便,只需要在项目根build.gradle中添加:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

        再添加对应的依赖即可:

	dependencies {
	        implementation 'com.github.quibbler01:WaveLoadingCircleView:1.0.2'
	}

        如果gradle无法下载依赖,可以参考解决maven { url 'https://jitpack.io' } 无法下载的问题一文。



不忘初心的阿甘
最新回复 (0)
    • 安卓笔记本
      2
        登录 注册 QQ
返回
仅供学习交流,切勿用于商业用途。如有错误欢迎指出:fluent0418@gmail.com