Gradle 7升级至8：如何适配LazyPublishArtifact？

问题背景 #

在Gradle 7.3.3中，这段代码可以正常运行：

PublishArtifact jarArtifact = new LazyPublishArtifact(taskProvider)

升级到Gradle 8.13后，LazyPublishArtifact的单参数构造方法被移除，必须传入FileResolver和TaskDependencyFactory两个必填参数。已知这是内部API，需要适配新构造参数，同时寻找公开替代方案。

适配新构造参数的示例 #

FileResolver和TaskDependencyFactory都是Gradle的核心服务，可以通过Project对象直接获取：

// 从Project中获取FileResolver
FileResolver fileResolver = project.getLayout().getFileResolver();
// 从Project的任务容器中获取TaskDependencyFactory
TaskDependencyFactory taskDependencyFactory = project.getTasks().taskDependencyFactory();

// 实例化LazyPublishArtifact
PublishArtifact jarArtifact = new LazyPublishArtifact(taskProvider, fileResolver, taskDependencyFactory);

• FileResolver负责解析文件路径，处理Gradle的路径规范化逻辑
• TaskDependencyFactory用于创建任务依赖关系，让Gradle能正确追踪产物的构建依赖

推荐的公开API替代方案 #

由于LazyPublishArtifact是内部API，长期依赖可能会在后续Gradle版本中再次出现兼容问题，建议使用公开API替代：

方案1：使用内置发布插件配置产物 #

如果是发布Jar这类标准产物，直接用Gradle官方的maven-publish或ivy-publish插件，通过publications配置即可：

plugins {
    id 'java'
    id 'maven-publish'
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            // 直接关联Java组件的默认产物
            from components.java
            // 也可以添加自定义Jar产物
            artifact(tasks.myCustomJar) {
                classifier 'custom'
            }
        }
    }
}

方案2：自定义PublishArtifact实现 #

如果需要自定义产物逻辑，可以实现公开的PublishArtifact接口，自己处理文件和依赖逻辑：

import org.gradle.api.Task;
import org.gradle.api.artifacts.PublishArtifact;
import org.gradle.api.file.FileResolver;
import org.gradle.api.tasks.TaskDependency;
import org.gradle.api.tasks.bundling.Jar;
import org.gradle.api.provider.TaskProvider;

import java.util.Collections;
import java.util.Date;

public class CustomJarArtifact implements PublishArtifact {
    private final TaskProvider<Jar> jarTaskProvider;
    private final FileResolver fileResolver;

    public CustomJarArtifact(TaskProvider<Jar> jarTaskProvider, FileResolver fileResolver) {
        this.jarTaskProvider = jarTaskProvider;
        this.fileResolver = fileResolver;
    }

    @Override
    public String getName() {
        return jarTaskProvider.get().getArchiveBaseName().get();
    }

    @Override
    public String getExtension() {
        return jarTaskProvider.get().getArchiveExtension().get();
    }

    @Override
    public String getType() {
        return "jar";
    }

    @Override
    public String getClassifier() {
        return null; // 根据需求设置分类器
    }

    @Override
    public File getFile() {
        return fileResolver.resolve(jarTaskProvider.get().getArchiveFile().get().getAsFile());
    }

    @Override
    public Date getDate() {
        return new Date();
    }

    @Override
    public TaskDependency getBuildDependencies() {
        return task -> Collections.singleton(jarTaskProvider.get());
    }
}

使用时直接实例化自定义类：

FileResolver fileResolver = project.getLayout().getFileResolver();
PublishArtifact customArtifact = new CustomJarArtifact(jarTaskProvider, fileResolver);

内容的提问来源于stack exchange，提问作者Shankha057