[Kotlin]创建一个私有包并使用

1.创建Kotlin测试项目

• 在Android Studio或其他IDE中选择“Create New Project”。
• 选择Kotlin和Gradle作为项目类型和构建系统。
• 指定项目名称和位置，完成设置。

2.创建Android Library模块

官方文档：创建 Android 库  |  Android Studio  |  Android Developers

 

注意：创建的Library依赖libs.plugins.androidLibrary，所以后续导入时需确保项目级别的build.gradle 有添加androidLibrary这个依赖。

若已有的Library库的话，可以选择Import导入模块。

添加依赖: 如果你的库需要额外的依赖，可以在 build.gradle (Module: app) 文件中添加依赖。例如：

dependencies {implementation(kotlin("stdlib"))
}

配置 Gradle:

• 版本控制: 确保 build.gradle 文件中设置了正确的版本号和版本配置，这对发布库非常重要。

android {namespace = "com.randomdt.myprivatepackage"compileSdk = 34defaultConfig {applicationId = "com.randomdt.myprivatepackage"minSdk = 24targetSdk = 34versionCode = 1versionName = "1.0.0"testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"vectorDrawables {useSupportLibrary = true}}
}

Manifest 设置: 检查 AndroidManifest.xml 文件，确保所有必要的权限和应用配置都已正确设置。

3.Library开发

创建必要的Kotlin类和功能模块，在 src/main/kotlin 目录下编写代码。

例如，我们创建一个计算类GACalculate

GACalculate：

class GACalculate {// 实例方法：执行加法fun addInstance(a: Int, b: Int): Int {return a + b}companion object {// 类方法：执行加法fun addStatic(a: Int, b: Int): Int {return a + b}}
}

4.测试

具体介绍参考另一文: [Android]单元测试和模块测试-CSDN博客

可以直接在Library写测试用例，也可以去测试项目（模块间可以相互调用）的 src/test/kotlin 目录下编写JUnit测试用例：

import com.randomyyds.mylibrary.GACalculate
import org.junit.Testimport org.junit.Assert.*/*** Example local unit test, which will execute on the development machine (host).** See [testing documentation](http://d.android.com/tools/testing).*/
class ExampleUnitTest {@Testfun addition_isCorrect() {assertEquals(30,  GACalculate().addInstance(10, 20))}
}

4.发布

(1).发布到私有Git仓库

添加所有文件到Git：

$ git init
$ git add .
$ git commit -m "Initial commit"

将项目推送到远程私有Git仓库（例如GitHub, GitLab等）：

$ git remote add origin <your-private-git-repo-url>
$ git push -u origin master

(2).发布成为公开的包

配置maven-publish插件：

plugins {`maven-publish`
}publishing {publications {create<MavenPublication>("mavenJava") {from(components["java"])}}repositories {maven {url = uri("https://your-public-maven-repo.com/repository/maven-releases/")credentials {username = provider { "user" }password = provider { "password" }}}}
}

发布到公开Maven仓库：

./gradlew publish

5.在项目中使用该包

(1).Git依赖

如果项目托管在Git上，可以在“settings.gradle.kts”文件中添加"https://jitpack.io"，启用 JitPack。

JitPack具体使用参见另一文：[Android]常见的包管理方式-CSDN博客

dependencyResolutionManagement {repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories {google()mavenCentral()maven {url = uri("https://jitpack.io")}}
}

在app/build.gradle中添加库作为依赖

假设你想添加一个名为 SomeLibrary 的库，该库由用户 SomeUser 在 GitHub 上维护，并且你想使用标签 1.0.0 的版本，你可以这样添加依赖：

dependencies {implementation ("com.github.SomeUser:SomeLibrary:1.0.0")
}

进入仓库网站:https://jitpack.io/ 搜索GitHub仓库地址

(2).本地依赖

在 Kotlin 项目中直接引用本地库，您可以通过几种方式将本地库集成到您的项目中。下面的说明基于您使用 Gradle 作为构建工具，因为 Kotlin 项目通常使用 Gradle。

方法 1: 使用本地 Jar 文件

如果您的库以 Jar 文件的形式存在，您可以直接在项目的 build.gradle 文件中添加对这个 Jar 文件的依赖。

• 将 Jar 文件放置到您的项目中，例如在 libs 目录下。

• 在 build.gradle 中添加对这个 Jar 文件的引用：

dependencies {implementation(fileTree("libs") {include("*.jar")})// 或者指定单个文件// implementation(files("libs/your-library.jar"))
}

方法 2: 引用本地项目

如果您的库是一个本地的 Gradle 项目，您可以通过以下方式将其作为依赖项添加：

• 确保本地库是一个可以独立构建的 Gradle 项目。

• 在您的主项目的 settings.gradle 文件中包含这个库：

include(":myLocalLibrary")
project(":myLocalLibrary").projectDir = file("../my-private-package/mylibrary")

这里 path_to_your_library 是相对于当前项目的路径。

• 在主项目的 build.gradle 文件中添加对本地项目的依赖：

dependencies {implementation(project(":myLocalLibrary"))
}

注意：添加上述配置，直接同步会报错，提示缺少androidLibrary

添加androidLibrary

 plugins {alias(libs.plugins.androidApplication) apply falsealias(libs.plugins.jetbrainsKotlinAndroid) apply falsealias(libs.plugins.androidLibrary) apply false
}   

...[plugins]
androidApplication = { id = "com.android.application", version.ref = "agp" }
jetbrainsKotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
androidLibrary = { id = "com.android.library", version.ref = "agp" }

然后同步，就会在目录上看到本地库。

方法 3: 使用 Maven 本地仓库

如果您的库已经被安装到本地 Maven 仓库（通常在您运行 mvn install 后），您可以如下引用：

• 确保本地 Maven 仓库（通常是 .m2 目录）在您的构建配置中被包括。

• 在 build.gradle 中添加对本地 Maven 仓库中的库的依赖：

dependencies {implementation 'group:artifact:version'
}

替换 group、artifact 和 version 为您的库的实际 Maven 坐标。