Package net.fabricmc.loom.configuration.providers.minecraft.mapped

Class NamedMinecraftProvider.SplitImpl

java.lang.Object

net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider<SplitMinecraftProvider>

net.fabricmc.loom.configuration.providers.minecraft.mapped.NamedMinecraftProvider<SplitMinecraftProvider>

net.fabricmc.loom.configuration.providers.minecraft.mapped.NamedMinecraftProvider.SplitImpl

All Implemented Interfaces:

MappedMinecraftProvider, MappedMinecraftProvider.ProviderImpl, MappedMinecraftProvider.Split

Enclosing class:

NamedMinecraftProvider<M extends MinecraftProvider>

public static final class NamedMinecraftProvider.SplitImpl
extends NamedMinecraftProvider<SplitMinecraftProvider>
implements MappedMinecraftProvider.Split

Nested Class Summary

Nested classes/interfaces inherited from class net.fabricmc.loom.configuration.providers.minecraft.mapped.NamedMinecraftProvider

NamedMinecraftProvider.LegacyMergedImpl, NamedMinecraftProvider.MergedImpl, NamedMinecraftProvider.SingleJarImpl, NamedMinecraftProvider.SplitImpl

Nested classes/interfaces inherited from class net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider

AbstractMappedMinecraftProvider.MavenScope, AbstractMappedMinecraftProvider.OutputJar, AbstractMappedMinecraftProvider.ProvideContext, AbstractMappedMinecraftProvider.RemappedJars, AbstractMappedMinecraftProvider.RemapperHookKind, AbstractMappedMinecraftProvider.SimpleOutputJar

Nested classes/interfaces inherited from interface net.fabricmc.loom.configuration.providers.minecraft.mapped.MappedMinecraftProvider

MappedMinecraftProvider.Merged, MappedMinecraftProvider.ProviderImpl, MappedMinecraftProvider.SingleJar, MappedMinecraftProvider.Split

Field Summary

Fields inherited from class net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider

extension, minecraftProvider

Constructor Summary

Constructors

Constructor	Description
SplitImpl(org.gradle.api.Project project, SplitMinecraftProvider minecraftProvider)

Method Summary

Modifier and Type	Method	Description
protected void	configureRemapper(AbstractMappedMinecraftProvider.RemappedJars remappedJars, net.fabricmc.tinyremapper.TinyRemapper.Builder tinyRemapperBuilder)
List<MinecraftJar.Type>	getDependencyTypes()
List<AbstractMappedMinecraftProvider.RemappedJars>	getRemappedJars()
protected AbstractMappedMinecraftProvider.RemapperHookKind	remapperHookKind()	Returns 本 provider 对 AbstractMappedMinecraftProvider.configureRemapper(net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider.RemappedJars, net.fabricmc.tinyremapper.TinyRemapper.Builder) 的覆写在投影视角下的形态.

Methods inherited from class net.fabricmc.loom.configuration.providers.minecraft.mapped.NamedMinecraftProvider

getMavenScope, getTargetNamespace

Methods inherited from class net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider

cacheKey, configureSplitRemapper, createBackupJars, disableTaskProduction, getBackupJarPath, getDependencyNotation, getJar, getMavenHelper, getMinecraftProvider, getName, getOutputJars, getProject, getRemapTask, getVersion, isUpToDate, provide, registerRemapTask, remapJar, requiresBackupJars, shouldRefreshOutputs

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.fabricmc.loom.configuration.providers.minecraft.mapped.MappedMinecraftProvider

getMinecraftJarPaths

Methods inherited from interface net.fabricmc.loom.configuration.providers.minecraft.mapped.MappedMinecraftProvider.ProviderImpl

getJar

Methods inherited from interface net.fabricmc.loom.configuration.providers.minecraft.mapped.MappedMinecraftProvider.Split

getClientOnlyJar, getCommonJar, getMinecraftJars

Constructor Details

SplitImpl

public SplitImpl(org.gradle.api.Project project,
 SplitMinecraftProvider minecraftProvider)

Method Details

getRemappedJars

public List<AbstractMappedMinecraftProvider.RemappedJars> getRemappedJars()

Specified by:

getRemappedJars in class AbstractMappedMinecraftProvider<SplitMinecraftProvider>

Returns:

A list of jars that should be remapped

configureRemapper

protected void configureRemapper(AbstractMappedMinecraftProvider.RemappedJars remappedJars,
 net.fabricmc.tinyremapper.TinyRemapper.Builder tinyRemapperBuilder)

Overrides:

configureRemapper in class AbstractMappedMinecraftProvider<SplitMinecraftProvider>

getDependencyTypes

public List<MinecraftJar.Type> getDependencyTypes()

Overrides:

getDependencyTypes in class AbstractMappedMinecraftProvider<SplitMinecraftProvider>

remapperHookKind

protected AbstractMappedMinecraftProvider.RemapperHookKind remapperHookKind()

Description copied from class: AbstractMappedMinecraftProvider

Returns 本 provider 对 AbstractMappedMinecraftProvider.configureRemapper(net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider.RemappedJars, net.fabricmc.tinyremapper.TinyRemapper.Builder) 的覆写在投影视角下的形态..

这是一个显式声明，不是探测：钩子是实例方法，它的效果（往 TinyRemapper.Builder 上挂什么） 无法被序列化成任务输入，而反射只能确认「覆写了」、不能确认「覆写成什么」。因此默认值刻意保守： AbstractMappedMinecraftProvider.RemapperHookKind.UNKNOWN，即「不可假定」。不认识的覆写一律拒绝投影，而不是把它当作空实现—— 后者会得到「任务成功、产物却比配置期少了钩子改动」的静默损坏。

三种形态各自意味着什么

• AbstractMappedMinecraftProvider.RemapperHookKind.NO_OP：钩子什么也不挂，任务侧 injectClientSidedVisitor = false 就是精确复现。适用两种情形：「压根没有覆写」（基类的空实现，由 overridesRemapperHook() 判定，不需要声明），以及「覆写已被证明是空操作」。后者是对覆写体的一处断言，反射校验不了它， 只能靠证据支撑——把「为什么恒不挂」的证据写在声明处的注释里。
• AbstractMappedMinecraftProvider.RemapperHookKind.SPLIT_CLIENT_VISITOR_ONLY：钩子的效果恰好是 AbstractMappedMinecraftProvider.configureSplitRemapper(net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider.RemappedJars, net.fabricmc.tinyremapper.TinyRemapper.Builder)——非 merged 且含客户端的 jar 挂 SidedClassVisitor.CLIENT， 其余 jar 什么也不挂。任务侧已经按 jar 承载了这个效果（RemapMinecraftTask.getInjectClientSidedVisitor()）， 所以声明之后本 provider 的每个 jar 都能被投影：需要 visitor 的那个 jar 由任务挂上， 不需要的那个两边都不挂。声明是对「覆写体干了什么」的断言，代码本身无法校验它，因此只有 「覆写体就是一行 configureSplitRemapper(remappedJars, tinyRemapperBuilder)」这类 可以逐字核对的情形才该如此声明；覆写体的判据与 configureSplitRemapper 不同时 （例如按别的条件决定是否挂 visitor），即使「看起来是同一件事」也必须保持 UNKNOWN：任务侧的注入条件复刻的是 configureSplitRemapper 的判据， 判据不同就会在某个 jar 上分叉。
• AbstractMappedMinecraftProvider.RemapperHookKind.UNKNOWN：无法判定，拒绝投影。第三方覆写只要不声明就落在这里。

Overrides:

remapperHookKind in class AbstractMappedMinecraftProvider<SplitMinecraftProvider>

Returns:

本 provider 对 AbstractMappedMinecraftProvider.configureRemapper(net.fabricmc.loom.configuration.providers.minecraft.mapped.AbstractMappedMinecraftProvider.RemappedJars, net.fabricmc.tinyremapper.TinyRemapper.Builder) 的覆写在投影视角下的形态