2024年最新组件化开发必备：Gradle 依赖切换源码的实践_gradle换源(1)，2024年最新2024疫情期间八家大厂的HarmonyOS鸿蒙面试经历和真题整理

最新推荐文章于 2024-09-20 13:55:30 发布

2401_84870988

最新推荐文章于 2024-09-20 13:55:30 发布

阅读量865

点赞数 15

分类专栏：程序员文章标签： harmonyos 面试华为

本文链接：https://blog.csdn.net/2401_84870988/article/details/138582364

版权

程序员专栏收录该内容

106 篇文章 0 订阅

订阅专栏

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

def sourceSwitches = new HashMap<String, SourceSwitch>()

// Load sources configurations.
parseSourcesConfiguration(sourceSwitches)

// Checkout remote sources.
checkoutRemoteSources(sourceSwitches)

// Replace dependencies with sources.
replaceDependenciesWithSources(sourceSwitches)

首先，Gradle 在 setting 阶段解析上述配置文件
然后，根据解析的结果，将打开源码的工程通过 project 的形式引用到项目中
最后，根据上述配置文件，将项目中的依赖替换为工程引用

2.2 为项目动态添加子工程

如上所述，这里我们忽略掉 json 配置文件解析的环节，直接看拉取最新分支并将其作为子项目添加到项目中的逻辑。该部分代码实现如下，

/** Checkout remote sources if necessary. */
def checkoutRemoteSources(sourceSwitches) {
def settings = getSettings()
def rootAbsolutePath = settings.rootDir.absolutePath
def sourcesRootPath = new File(rootAbsolutePath).parent
def sourcesDirectory = new File(sourcesRootPath, “open_sources”)
if (!sourcesDirectory.exists()) sourcesDirectory.mkdirs()
sourceSwitches.forEach { name, sourceSwitch ->
if (sourceSwitch.open) {
def sourceDirectory = new File(sourcesDirectory, name)
if (!sourceDirectory.exists()) {
logd(“clone start [ $nam e] b r an c h [$ {sourceSwitch.branch}]”)
“git clone -b ${sourceSwitch.branch} ${sourceSwitch.url} ".execute(null, sourcesDirectory).waitFor() logd("clone completed [$ name] branch [ $KaTeX parse error: Expected 'EOF', got '}' at position 26: \dotstch.branch}]") }̲ else { def sb \dots$ {currentBranch}], checkout branch [${sourceSwitch.branch}]”)
def out = new StringBuffer()
“git pull”.execute(null, sourceDirectory).waitFor()
“git checkout -b ${sourceSwitch.branch} origin/$ {sourceSwitch.branch}”
.execute(null, sourceDirectory).waitForProcessOutput(out, System.err)
logd(“checkout completed: $KaTeX parse error: Expected 'EOF', got '}' at position 27: \dotsng().trim()}") }̲ } // After che\dots$ {child.name}”)
settings.project(“😒{child.name}”).projectDir = new File(sourcesDirectory, child.path)
}
}
}
}

这里，我将子项目的源码克隆到 settings.gradle 文件的父目录下的 open_sources 目录下面。这里当该目录不存在的时候，我会先创建该目录。这里需要注意的是，我在组织项目目录的时候比较喜欢将项目的子工程放到和主工程一样的位置。所以，上述克隆方式可以保证克隆到的 open_sources 仍然在当前项目的工作目录下。

然后，我对 sourceSwitches，也就是解析的 json 文件数据，进行遍历。这里会先判断指定的源码是否已经拉下来，如果存在的话就执行 checkout 操作，否则执行 clone 操作。这里在判断当前分支是否为目标分支的时候使用了 git rev-parse --abbrev-ref HEAD 这个 Git 指令。该指令用来获取当前仓库所处的分支。

最后，将源码拉下来之后通过 Settings 的 include() 方法加载指定的子工程，并使用 Settings 的 project() 方法指定该子工程的目录。这和我们在 settings.gradle 文件中添加子工程的方式是相同的，

include ‘:utils-core’, ‘:utils-ktx’
project(‘:utils-core’).projectDir = new File(‘…/AndroidUtils/utils’)
project(‘:utils-ktx’).projectDir = new File(‘…/AndroidUtils/utils-ktx’)

2.3 使用子工程替换依赖

动态替换工程依赖使用的是 Gradle 的 ResolutionStrategy 这个功能。也许你对诸如

configurations.all {
resolutionStrategy.force ‘io.reactivex.rxjava2:rxjava:2.1.6’
}

这种写法并不陌生。这里的 force 和 dependencySubstitution 一样，都属于 ResolutionStrategy 提供的功能的一部分。只不过这里的区别是，我们需要对所有的子项目进行动态更改，因此需要等项目 loaded 完成之后才能执行。

下面是依赖替换的实现逻辑，

/** Replace dependencies with sources. */
def replaceDependenciesWithSources(sourceSwitches) {
def gradle = settings.gradle
gradle.projectsLoaded {
gradle.rootProject.subprojects {
configurations.all {
resolutionStrategy.dependencySubstitution {
sourceSwitches.forEach { name, sourceSwitch ->
sourceSwitch.children.each { child ->
substitute module(“ ${sourceSwitch.artifact}:$ {child.name}”) with project(“😒{child.name}”)
}
}
}
}
}
}
}

这里使用 Gradle 的 projectsLoaded 这个点进行 hook，将依赖替换为子工程。

此外，也可以将子工程替换为依赖，比如，

dependencySubstitution {
substitute module(‘org.gradle:api’) using project(‘:api’)
substitute project(‘:util’) using module(‘org.gradle:util:3.0’)
}

2.4 注意事项

上述实现方式要求多个子工程的脚本尽可能一致。比如，在 AndroidUtils 的独立工程中，我通过 kotlin_version 这个变量指定 kotlin 的版本，但是在 android-mvvm-and-architecture 这个工程中使用的是 kotlinVersion. 所以，当切换了子工程的源码之后就会发现 kotlin_version 这个变量找不到了。因此，为了实现可以动态切换源码，是需要对 Gradle 脚本做一些调整的。

在我的实现方式中，我并没有将子工程的源码放到主工程的根目录下面，也就是将 open_sources 这个目录放到 appshell 这个目录下面。而是放到和 appshell 同一级别。

这样做的原因是，实际开发过程中，通常我们会克隆很多仓库到 open_sources 这个目录下面（或者之前开发遗留下来的克隆仓库）。有些仓库虽然我们关闭了源码依赖，但是因为在 appshell 目录下面，依然会出现在 Android Studio 的工程目录里。而按照上述方式组织目录，我切换了哪个项目等源码，哪个项目的目录会被 Android Studio 加载。其他的因为不在 appshell 目录下面，所以会被 Android Studio 忽略。这种组织方式可以尽可能减少 Android Studio 加载的文本，提升 Android Studio 响应的速率。

总结

上述是开发过程中替换依赖为源码的“无痕”修改方式。不论在组件化还是非组件化需要开发中都是一种非常实用的开发技巧。按照上述开发开发方式，我们可以既能开发 android-mvvm-and-architecture 的时候随时随地打开 AndroidUtils 进行修改，亦可对 AndroidUtil 这个工程独立编译和开发。

源代码参考 android-mvvm-and-architecture 项目（当前是 feature-3.0 分支）的 AppShell 下面的 sources.gradle 文件。