在jitpack上发布依赖库

原创已于 2026-04-30 17:21:22 修改 · 554 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

Android

于 2009-07-29 13:30:00 首次发布

1.指定JDK版本

默认jitpack使用JDK8进行编译发布，使用其它版本JDK需要在项目根目录创建 jitpack.yml 文件指定JDK版本，示例：

jdk:
  - openjdk17

2.添加依赖插件

在项目build.gradle.kts中添加 agp和maven插件

buildscript {
    dependencies {
        classpath(libs.gradle)
        classpath(libs.android.maven.gradle.plugin)
    }
}

配置版本目录

[versions]
agp = "9.1.0"
androidMavenGradlePlugin = "2.1"

[libraries]
gradle= { module = "com.android.tools.build:gradle", version.ref = "agp" }
android-maven-gradle-plugin = { module = "com.github.dcendents:android-maven-gradle-plugin", version.ref = "androidMavenGradlePlugin" }

3.配置模块

在模块build.gradle.kts中配置发布信息

plugins {
    id("com.android.library")
    id("maven-publish")// 核心发布插件id
}

group="com.gitee.brogrammer"

android {
    namespace = "com.example.testcommon"
    compileSdk = 36

    defaultConfig {
        minSdk = 24
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }

    //从 AGP 7.0 开始，Google 不再默认注册与 Maven 发布相关的任务，需要显式启用和配置。
    //必须启用 publish-non-default 以暴露 release 组件
    publishing {
        singleVariant("release") {
            withSourcesJar()
            withJavadocJar()
        }
    }
}

publishing {
    publications {
        register<MavenPublication>("release") {
            afterEvaluate {
                //必须明确指定要发布的组件
                from(components["release"])
                //以下指定发布到远程库可能没有用，但发布到本地库有用
                groupId = project.findProperty("GROUP_ID") as String // 使用 GROUP_ID 属性
                artifactId = "testcommon"
                version = project.findProperty("VERSION_NAME") as String // 使用 VERSION_NAME 属性
            }
        }
    }
}

//指定本地仓库路径
repositories {
    maven {
        url = uri( layout.buildDirectory.dir("repo").get().asFile.path) //项目内目录
        //url = uri("D:/AndroidStudio/test0825") //绝对路径
    }
}

在根目录的gradle.properties文件中定义属性

android.useAndroidX=true
GROUP_ID=com.gitee.brogrammer
VERSION_NAME=1.0

3.本地检查测试

jitpack不是上传aar或者jar文件，而是直接从github等拉取代码在线编译。可以先在根目录下执行本地编译和发布测试：

.\gradlew install

.\gradlew publish

显示BUILD SUCCESSFUL，就可以上传代码了。

4.创建发行版本

将代码提交到版本服务器后，在版本服务器上创建发行版本：指定版本号和标题。

5.在jitpack上查找代码库

不需要登录，在jitpack首页输入 git repository url，点击Look up，查找并自动发布发行版本库。

配置完成之后推送到github，然后进入jitpack中，输入项目URL点击Look Up查看项目，点击Commits标签可以先试发布，能正常发布之后，再回到github进行Release，然后在回来进行正式发布就完成了。

如果发布失败，会显示为红色的Log文件，在其中查找问题即可。

登录jitpack

用github账号登录jitpack.io，会看到左边的列表中列出了账号在github上的所有项目，选择要发布的项目，选择版本，点击发布。等到Log对应的图标变绿就成功啦。如果Log的图标是红的，点进去看log，根据错误修改代码。如果用gradlew install命令检查过还报错，那就是github中的文件不全，比如漏了上传gradlew文件。

标签

#jitpack