Support relocating Kotlin module files

[Goooler]

• Closes Automatically relocate package in Kotlin module files when moving packages #843.
• Closes Relocation does not work properly for some method parameters #1427.
• Closes Integrate this plugin into Shadow's codebase xpdustry/kotlin-shadow-relocator#30.
• Closes Integrate this plugin into Shadow's codebase Spliterash/shadow-kotlin-relocate#1.

---

• CHANGELOG's "Unreleased" section has been updated, if applicable.

[shanshin]

The current implementation of KotlinModuleMetadata.read method checks the version of the metadata in loaded kotlin_module. And if its minor version is greater by 1 than the kotlin-metadata-jvm version, an error will be thrown.
E.g. for your current implementation kotlin_modules with metadata 2.4.0 will not be able to be processed.

Is such a restriction acceptable?

[Goooler]

Is such a restriction acceptable?

It's fair. The current relocation copies the original version, and the relocated module file will behave like the original one.

shadow/src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/tasks/ShadowCopyAction.kt

Line 266 in 909b066

val newKmMetadata = KotlinModuleMetadata(newKmModule, kmMetadata.version)

[Goooler]

Please take a look as soon as possible.

If the changes all look good to you, I'll merge this PR and release a new version.

[Goooler]

I'm planning the deprecation of #1875 and split the built-in . kotlin_module file relocation into a new transformer in #2073. Users can apply it if they want.