最近开发了个App埋点采集框架,准备把框架开源到Github上,本来以为会很顺利,没想到过程会如此曲折。网上的文章,有些是AGT、Gradle版本太老,有些是直接Copy的别人的内容自己压根就没验证过,我这一路踩坑,花费了一天的时间,终于搞定了,特此记录下。
一,上传到Github
具体操作见,之前的文章:Git使用教程
二,发布至JitPack
1、AGT和Gradle的版本
AGT 版本建议使用 3.6.0 及更高版本。我使用的 AGT 版本是 4.2.2,Gradle 版本是 6.7.1。
工程的 build.gradle 文件:
buildscript {
ext.kotlin_version = "1.3.50"
dependencies {
classpath "com.android.tools.build:gradle:4.2.2"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
}
工程目录下 gradle/wrapper/gradle-wrapper.properties 文件:
distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
2、配置Libary的 build.gradle
Libary的 build.gradle 文件:
apply plugin: 'com.android.library'
group = 'com.github.sulei007' // 指定group,com.github.<用户名>,很重要!!!!
android {
}
3、Github 打 release tag
点击右侧的 Release tab
如果已经有 tag,则点击 Draft a new release 按钮。如果没有 tag,则点击 Create a new release 按钮。
按钮点击完成后,会出现信息填写页面。先点击 Choose a tag 按钮,设置一个 tag 号,然后填写标题、描述,最后点击Publish release 按钮。
4、JitPack 发布
发布成功以后,去 JitPack官网 ,把仓库的地址粘贴到输入框,然后点击 Look up 按钮;在 Version列表里找到刚打的tag 号,点击 Get it 按钮;JitPack 开始编译你的代码,如果编译成功,会显示一个绿色的图标,如果编译失败,会显示一个红色的图标;点击图标能看到编译信息。
编译成功后,我们的 Libary 就可以被其他工程引用了。
三,最后
1、如果你想用低版本的 AGT和Gradle,推荐一篇文章:Android如何制作自己的开源项目,我没有亲自验证过这篇文章是否可行性,大家感兴趣可以试试。
2、一般情况下,一个工程对应一个 Libary,JitPack 会自动编译这一个 Libary。如果一个工程对应多个 Libary,那我们需要对发布的 Libary,进行额外的配置。推荐一篇文章:小记多lib module上传JitPack,我也没有亲自验证过这篇文章是否可行性,大家感兴趣可以试试。