tutorial:migratemappings
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
tutorial:migratemappings [2019/11/27 18:23] – fudge | tutorial:migratemappings [2020/02/22 15:31] – Some structural cleanup, mention that Mixins are not remapped jamieswhiteshirt | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Updating Yarn mappings in a Java codebase ====== | ====== Updating Yarn mappings in a Java codebase ====== | ||
- | ====== Loom 0.2.6 and above ====== | + | |
- | Currently, this process will only affect Java files. | + | Loom allows semi-automatic updating of the mappings used in a Java codebase. Due to frequent changes in Yarn, this can be a useful tool for keeping a codebase up-to-date with the newest changes. |
+ | |||
+ | **Note:** This automated process currently only applies to most Java code. It will not automatically migrate mappings for Mixin targets or for code written in other language such as Kotlin or Scala. | ||
+ | |||
+ | ===== Loom 0.2.6 and above ===== | ||
Say you want to migrate from 1.14.4 to 19w46b. | Say you want to migrate from 1.14.4 to 19w46b. | ||
Line 7: | Line 11: | ||
- Go [[https:// | - Go [[https:// | ||
- In the root of your gradle project, run '' | - In the root of your gradle project, run '' | ||
- | - Your migrated | + | - Your migrated |
+ | - Copy the sources from '' | ||
- Update your gradle.properties file according to the instructions in [[https:// | - Update your gradle.properties file according to the instructions in [[https:// | ||
- | - You're done. | + | - Refresh the Gradle project in your IDE. |
+ | - Check and update any Mixin targets that may be outdated. | ||
=== Additional customization === | === Additional customization === | ||
* Specify from where to take your Java files with '' | * Specify from where to take your Java files with '' | ||
* Specify where to output the remapped source with '' | * Specify where to output the remapped source with '' | ||
- | * Specify a custom place to retrieve the mappings from with '' | + | * Specify a custom place to retrieve the mappings from with '' |
- | + | ||
- | ====== Loom 0.2.5 and below ====== | + | |
- | ==== Requirements ==== | + | === Reporting issues |
+ | Loom uses [[https:// | ||
- | * Fabric-Loom 0.2.2 or above | + | ===== Loom 0.2.2-0.2.5 ===== |
- | * A Java codebase | + | |
- | * Some assembly required | + | |
- | ==== Instructions ==== | + | Some assembly required. |
- Figure out your target mappings version. For example, " | - Figure out your target mappings version. For example, " | ||
Line 32: | Line 35: | ||
* " | * " | ||
* " | * " | ||
- | - Copy the remapped source code to the input directory, if everything' | + | - Copy the remapped source code to the input directory, if everything' |
- Hope for the best. | - Hope for the best. | ||
tutorial/migratemappings.txt · Last modified: 2022/12/22 16:23 by basil4088