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

Class SingleJarMinecraftProvider

java.lang.Object

net.fabricmc.loom.configuration.providers.minecraft.MinecraftProvider

net.fabricmc.loom.configuration.providers.minecraft.SingleJarMinecraftProvider

Direct Known Subclasses:

SingleJarForgeMinecraftProvider, SingleJarMinecraftProvider.Client, SingleJarMinecraftProvider.Server

public abstract class SingleJarMinecraftProvider
extends MinecraftProvider

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	SingleJarMinecraftProvider.Client
static final class	SingleJarMinecraftProvider.Server

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SingleJarMinecraftProvider(MinecraftMetadataProvider metadataProvider, ConfigContext configContext, MappingsNamespace officialNamespace)

Method Summary

Modifier and Type	Method	Description
protected String	cacheKey()
static SingleJarMinecraftProvider.Client	client(MinecraftMetadataProvider metadataProvider, ConfigContext configContext)
protected @Nullable String	earlyProjectionBlocker()	env-only jar 的生产留在配置期，因此 vanilla 链也必须留在配置期.
protected abstract Path	getInputJar(SingleJarMinecraftProvider provider)
Path	getMinecraftEnvOnlyJar()
List<Path>	getMinecraftJars()
MappingsNamespace	getOfficialNamespace()
protected void	initFiles()
protected void	processJar()
protected void	produceOwnJars()	子类在此生产自己的产物（合并/拆分/env-only 透传）.
void	provide()	内存配置段：与产物是否已落位无关的那部分.
static SingleJarMinecraftProvider.Server	server(MinecraftMetadataProvider metadataProvider, ConfigContext configContext)
protected abstract SingleJarEnvType	type()

Methods inherited from class net.fabricmc.loom.configuration.providers.minecraft.MinecraftProvider

addProducerDependency, dependOn, dir, extractBundledServerJar, file, getExtension, getJarPrefix, getMinecraftClientJar, getMinecraftExtractedServerJar, getMinecraftServerJar, getProject, getServerBundleMetadata, getVersionInfo, isFinalProductKnown, isLegacySplitOfficialNamespaceVersion, isLegacyVersion, isTaskProduction, minecraftVersion, minecraftWorkingDirectory, normalize, outputForTasks, path, producerOf, productionTaskPath, projectionBlocker, provideClient, provideMinecraftJars, provideServer, refreshDeps, registerProviderTasks, registerTaskProducedArtifact, setJarPrefix, workingDir

Methods inherited from class java.lang.Object

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

Constructor Details

SingleJarMinecraftProvider

protected SingleJarMinecraftProvider(MinecraftMetadataProvider metadataProvider,
 ConfigContext configContext,
 MappingsNamespace officialNamespace)

Method Details

server

public static SingleJarMinecraftProvider.Server server(MinecraftMetadataProvider metadataProvider,
 ConfigContext configContext)

client

public static SingleJarMinecraftProvider.Client client(MinecraftMetadataProvider metadataProvider,
 ConfigContext configContext)

initFiles

protected void initFiles()

Overrides:

initFiles in class MinecraftProvider

getMinecraftJars

public List<Path> getMinecraftJars()

Specified by:

getMinecraftJars in class MinecraftProvider

earlyProjectionBlocker

protected @Nullable String earlyProjectionBlocker()

env-only jar 的生产留在配置期，因此 vanilla 链也必须留在配置期.

processJar() 在配置期把 vanilla jar 过一遍 TinyRemapper（readInputs 会读它的 全部类），产物才是本 provider 的 jar。若把下载/抽取搬到执行期，配置期就没有可读的输入。 「env-only 生产任务化」不在本次范围内（它是一次独立的重映射型任务，和 mapped 阶段同批更合适）。

legacy merged（MC 1.3 之前）经两个本类实例委托生产，因此同样被这条判据覆盖。

Overrides:

earlyProjectionBlocker in class MinecraftProvider

Returns:

与依赖 provider 无关的那部分判据；子类覆写点

provide

public void provide()
             throws Exception

Description copied from class: MinecraftProvider

内存配置段：与产物是否已落位无关的那部分.

产物生产（下载/抽取，子类再含合并/拆分/env-only 透传）**不在这里**，由 MinecraftProvider.provideMinecraftJars() 承担。拆开的理由是判据的求值时机： MinecraftProvider.projectionBlocker() 里那条 Forge 系判据要读 isLegacyForge()，而它依赖已解析的 userdev 配置——依赖 provider 只能在库处理器把仓库定稿之后建立 （见 CompileConfiguration.setupDependencyProviders 的注释），因此生产整体推迟到那之后。

库注入（MinecraftLibraryProvider）仍留在本段：它必须在依赖 provider 之前完成， 且服务端库列表取自 bundle 元数据。推迟路径下元数据由 MinecraftProvider.earlyProjectionBlocker() 的末条保证命中 L2 规格缓存，读它不会打开 server jar。

Overrides:

provide in class MinecraftProvider

Throws:

Exception

produceOwnJars

protected void produceOwnJars()
                       throws Exception

Description copied from class: MinecraftProvider

子类在此生产自己的产物（合并/拆分/env-only 透传）.

由 MinecraftProvider.provide() 与 MinecraftProvider.provideMinecraftJars() 在基类产物之后调用，因此 「我的输入就是基类产物」这条关系由调用点保证。投影时不会调用本方法：那时产物由 MinecraftProvider.registerProviderTasks(java.util.Map<java.nio.file.Path, net.fabricmc.loom.pipeline.RemapMinecraftTaskRegistry.Producer>) 登记的执行期任务承担（子类在那里决定自己怎么接线）。

Overrides:

produceOwnJars in class MinecraftProvider

Throws:

Exception

processJar

protected void processJar()
                   throws Exception

Throws:

Exception

cacheKey

protected String cacheKey()

Overrides:

cacheKey in class MinecraftProvider

getMinecraftEnvOnlyJar

public Path getMinecraftEnvOnlyJar()

getOfficialNamespace

public MappingsNamespace getOfficialNamespace()

Specified by:

getOfficialNamespace in class MinecraftProvider

type

protected abstract SingleJarEnvType type()

getInputJar

protected abstract Path getInputJar(SingleJarMinecraftProvider provider)
                             throws Exception

Throws:

Exception