Skip to content

Document not relocating Kotlin stdlib and reflect #1760

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Goooler merged 1 commit into from
Sep 18, 2025
Merged

Document not relocating Kotlin stdlib and reflect #1760

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/configuration/relocation/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,13 @@ To configure automatic dependency relocation, set `enableAutoRelocation = true`
> Be mindful that some Gradle plugins will automatically add dependencies to your class path. You may need to remove these
> dependencies if you do not intend to shadow them into your library.


## Relocating Kotlin Standard Library

It is not recommended to relocate Kotlin Standard Library if you are using [Kotlin Metadata][kotlin-metadata] or
[Kotlin Reflection][kotlin-reflection] in the project, because they are tightly coupled with Kotlin compiler and
runtime. See more details and discussion in [#1622][#1622].

## Relocating Project Resources Only

If you want to relocate the resources of the project only and exclude all dependencies (related to a normal JAR but with
Expand Down Expand Up @@ -237,3 +244,9 @@ relocating), you can try out the trick like:

This is useful in some cases like [#759](https://github.com/GradleUp/shadow/issues/759) mentioned. See
[Configuring Shadowed Dependencies](../dependencies/README.md) for more information about `configurations`.



[#1622]: https://github.com/GradleUp/shadow/issues/1622
[kotlin-metadata]: https://kotlinlang.org/docs/metadata-jvm.html
[kotlin-reflection]: https://kotlinlang.org/docs/reflection.html