tutorial:migratemappings
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
tutorial:migratemappings [2019/11/16 22:35] – fudge | tutorial:migratemappings [2022/12/22 16:23] (current) – Add reference to tutorial:mappings in case people want to know more about how they work basil4088 | ||
---|---|---|---|
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. | ||
- | Say you want to migrate from 1.14.4 | + | 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. |
- | - Go [[https:// | + | **Note:** This automated process currently does not handle Mixins or reflection, instances |
- | - In the root of your gradle project, run '' | + | |
- | - Your migrated source | + | |
- | - Update your gradle.properties file according | + | |
- | - You're done. | + | |
- | === Additional customization | + | ===== Loom 0.2.6 and above ===== |
- | * Specify from where to take your Java files with '' | + | |
- | * Specify where to output the remapped source with '' | + | |
- | * Specify a custom place to retrieve the mappings from with '' | + | |
- | ====== Loom 0.2.5 and below ====== | + | Say you want to migrate from 1.16.5 yarn to 1.17.1 yarn. |
+ | |||
+ | - Go [[https:// | ||
+ | - Run the command in the root of your Gradle project. | ||
+ | - Your migrated sources will appear in '' | ||
+ | - Copy the sources from '' | ||
+ | - Update your gradle.properties file according to the instructions in [[https:// | ||
+ | - Refresh the Gradle project in your IDE. | ||
+ | - Check and update any Mixin targets that may be outdated. | ||
+ | |||
+ | If you want to go from Mojang' | ||
+ | |||
+ | === Additional customization | ||
+ | * Specify from where to take your Java files with '' | ||
+ | * Specify where to output the remapped source with '' | ||
+ | * Specify a custom place to retrieve the mappings from with '' | ||
- | ==== 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 37: | ||
* " | * " | ||
* " | * " | ||
- | - 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.1573943718.txt.gz · Last modified: 2019/11/16 22:35 by fudge