Android Jitpack发布Debug/Release构建及依赖自动切换问题咨询

一、修改Android库的Gradle配置，发布多变体 #

默认Android库仅发布Release变体，需修改库模块的构建脚本，明确发布Debug和Release两种变体：

Kotlin DSL 示例： #

plugins {
    id("com.android.library")
    id("maven-publish")
}

android {
    // 基础配置（compileSdk、defaultConfig等）省略
    publishing {
        // 移除默认仅发布release的配置，改为发布多变体
        multipleVariants {
            includeBuildType("debug", "release")
        }
    }
}

publishing {
    publications {
        // 配置Release变体发布
        create<MavenPublication>("release") {
            from(components["release"])
        }
        // 新增Debug变体发布
        create<MavenPublication>("debug") {
            from(components["debug"])
        }
    }
}

Groovy DSL 示例： #

plugins {
    id 'com.android.library'
    id 'maven-publish'
}

android {
    // 基础配置省略
    publishing {
        multipleVariants {
            includeBuildType 'debug', 'release'
        }
    }
}

publishing {
    publications {
        release(MavenPublication) {
            from components.release
        }
        debug(MavenPublication) {
            from components.debug
        }
    }
}

二、配置Jitpack构建脚本（jitpack.yml） #

在项目根目录创建jitpack.yml，确保Jitpack构建并发布两种变体：

jdk: openjdk17
install:
  - ./gradlew :你的库模块名称:publishReleasePublicationToMavenLocal :你的库模块名称:publishDebugPublicationToMavenLocal

替换你的库模块名称为实际的库模块文件夹名

三、集成端自动切换依赖 #

在集成项目的构建脚本中，根据构建类型匹配对应变体的依赖，实现切换构建时自动同步：

方法1：直接按构建类型声明依赖 #

dependencies {
    releaseImplementation("com.github.你的用户名:你的仓库名:版本号")
    debugImplementation("com.github.你的用户名:你的仓库名:版本号:debug")
}

方法2：变体感知的依赖匹配（Gradle 7.0+） #

android {
    buildTypes {
        debug {
            matchingFallbacks = listOf("debug")
        }
        release {
            matchingFallbacks = listOf("release")
        }
    }
}

dependencies {
    implementation("com.github.你的用户名:你的仓库名:版本号")
}

四、替代方案：无需Debug变体的日志支持 #

如果多变体发布遇到阻碍，可在库中添加日志开关，让集成者无需依赖Debug变体就能查看日志：

1. 库中添加配置类：

object LibraryConfig {
    var enableDebugLogs = false
}

2. 库的日志输出逻辑增加判断：

fun printLog(message: String) {
    if (LibraryConfig.enableDebugLogs) {
        Log.d("LibraryTag", message)
    }
}

3. 集成者初始化时开启日志：

LibraryConfig.enableDebugLogs = BuildConfig.DEBUG

验证步骤 #

1. 推送修改后的库代码到GitHub，打新的版本标签
2. 等待Jitpack构建完成，确认页面存在release和debug后缀的制品
3. 在集成项目中配置依赖，切换Debug/Release构建，检查BuildConfig.DEBUG值是否与当前构建类型匹配

内容的提问来源于stack exchange，提问作者kalevan