返回

JitPack 发布库指南:克服安卓 Gradle 7.0 升级带来的挑战

Android

引言

发布库是安卓开发中的一个基本方面,它使开发人员能够共享他们的代码和与他人协作。然而,随着安卓 Gradle 升级到 7.0,JitPack 库发布过程变得更加复杂。在本文中,我们将揭示这些挑战并提供一个综合指南,帮助您成功发布库。

构建库

1. 构建 Gradle 脚本

确保您的 Gradle 脚本与 Gradle 7.0 兼容。添加以下代码块到您的 build.gradle 文件:

buildscript {
    ext.kotlin_version = '1.6.10'
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.4'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

2. 配置模块

将以下代码块添加到您想要发布的模块的 build.gradle 文件中:

plugins {
    id 'com.android.library'
}
android {
    compileSdk 32
    defaultConfig {
        minSdk 21
        targetSdk 32
    }
    libraryVariants.all { variant ->
        variant.outputs.all { output ->
            output.outputFileName = "${variant.buildType.name}-${variant.name}-jitpack.aar"
        }
    }
}

上传库

1. 注册 JitPack 账户

如果您还没有 JitPack 账户,请访问 https://jitpack.io/ 注册一个。

2. 创建仓库

登录您的 JitPack 账户并创建一个新的仓库。仓库名称必须与您的 GitHub 仓库名称相同。

3. 生成上传令牌

在 JitPack 仪表板中,转到 "上传令牌" 部分并生成一个新的令牌。确保安全地存储此令牌,因为它将用于上传您的库。

4. 上传到 JitPack

在命令行终端中,导航到您的库目录并运行以下命令:

./gradlew jitpack

系统将提示您输入 JitPack 上传令牌。输入令牌并按 Enter 键。

配置库

1. 添加 JitPack 仓库

在您的应用程序的 build.gradle 文件中,添加 JitPack 仓库:

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

2. 添加库依赖项

将以下代码块添加到您的应用程序的 build.gradle 文件中:

dependencies {
    implementation 'com.github.your-username:your-library-name:latest-version'
}

克服 Gradle 7.0 挑战

1. 过时的 dependencies 声明

在 Gradle 7.0 中,dependencies 声明已被弃用。请改用 implementationapi 和其他特定于配置类型的声明。

2. 生命周期版本冲突

Gradle 7.0 与较低版本的生命周期工件不兼容。请确保更新到最新版本的工件,例如 lifecycle-livedatalifecycle-viewmodel-ktx

3. Android Gradle 插件版本不匹配

确保您的 Android Gradle 插件版本与 Gradle 版本相匹配。对于 Gradle 7.0,Android Gradle 插件的版本应该是 7.0.x。

结论

通过遵循本指南,您将能够克服安卓 Gradle 升级到 7.0 后 JitPack 库发布过程中的挑战。通过谨慎地解决这些挑战,您可以顺利发布您的库并使其可供其他开发人员使用。请务必根据需要参考提供的示例和代码片段。