Gradle 7通过settings插件共享version catalog遇变体不匹配报错

你混淆了Gradle版本目录的两种独立共享实现路径，生产者端的发布类型和消费者端的引用方式不匹配，才会出现变体属性无法匹配的解析错误。你完全不需要手动调整这些发布变体属性，这类属性是Gradle根据工程应用的构建插件自动生成的，不匹配的本质是你选了错误的工程构建模板。

两类共享路径的本质差异 #

• Settings插件共享路径：按照官方说明，这种模式下版本目录的定义逻辑写在Settings插件内部，消费者只需要在settings脚本中应用对应插件，插件apply时就会自动把内置的版本目录注入到项目的依赖解析管理规则中，根本不需要通过远程依赖拉取目录的逻辑。
• 独立版本目录组件共享路径：这种模式下生产者不需要写任何插件代码，只需要定义独立的版本目录发布组件，消费者通过在版本目录块中指定远程组件坐标，拉取并加载对应的版本目录配置。

当前配置的错位点 #

你通过gradle init生成的生产者工程是标准的Kotlin Settings插件工程，默认应用Java插件、Gradle插件开发插件，打出来的发布包是普通Java库类型：对应的发布变体属性为org.gradle.category=library、org.gradle.usage=java-api/java-runtime，完全符合你执行outgoingVariants任务看到的输出结果。
但你在消费者侧却使用了独立版本目录组件的引用方式，这种引用方式要求生产者必须发布带有org.gradle.category=platform、org.gradle.usage=version-catalog属性的特殊组件变体，两边发布类型完全不匹配，自然会触发“无匹配变体”的构建错误。

两种可落地的修复方案 #

方案1：适配Settings插件共享路径 #

• 保持现有生产者端的Settings插件代码不变，按照正常插件发布流程把插件发布到对应仓库
• 删掉消费者端settings.gradle.kts中手动创建版本目录、通过from()拉远程配置的代码，改为在settings脚本最顶部通过插件块直接应用你发布的Settings插件：

  // settings.gradle.kts 最顶部
  plugins {
      id("你发布的插件ID") version "对应插件版本号"
  }
  

  插件被应用后会自动把内置的libs版本目录注入到项目依赖解析流程中，不需要额外手动配置。

方案2：适配独立版本目录组件共享路径 #

• 重构生产者工程为纯版本目录工程：删掉原有的插件代码、移除java-gradle-plugin、kotlin-dsl等插件的应用，改为应用Gradle内置的version-catalog插件
• 把原插件中写的版本别名逻辑，直接迁移到生产者工程的构建脚本中：

  plugins {
      `version-catalog`
      `maven-publish`
  }
  
  catalog {
      versionCatalog {
          alias("groovy-core").to("org.codehaus.groovy:groovy:3.0.5")
      }
  }
  // 按照常规要求配置发布仓库信息即可
  

  这种方式发布的组件会自动生成消费者需要的platform/version-catalog属性变体，你原有消费者侧写的from()引用配置就可以正常解析加载。

注意：你当前使用的是Gradle 7.0里程碑预览版，该版本的版本目录相关API仍处于快速调整阶段，非稳定版本存在较多兼容问题，正式使用时建议升级到Gradle 7.x的正式稳定版。

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