Gradle引入androidx.browser:1.4.0失败，1.0.0版本正常问题排查

问题复现 #

1. 创建空白项目：

   mkdir gradleExp
   cd gradleExp
   gradle init # 选择1.basic、1.groovy，使用随机名称
   

2. 替换build.gradle内容：

   plugins {
       id 'java'
   }
   repositories {
       google()
       mavenCentral()
   }
   
   dependencies {
       implementation "androidx.browser:browser:1.4.0"
   }
   

3. 执行命令：

   gradle dependencies --configuration compileClasspath
   

   执行失败；将依赖替换为androidx.browser:browser:1.0.0后，命令可正常运行。

Gradle版本：7.5.1

调试信息 #

添加--debug参数后，关键日志：

[DEBUG] [org.gradle.internal.component.model.ComponentAttributeMatcher] Selected matches [] from candidates [androidx.browser:browser:1.4.0 variant releaseVariantReleaseApiPublication, androidx.browser:browser:1.4.0 variant releaseVariantReleaseRuntimePublication, androidx.browser:browser:1.4.0 variant sourcesElements] for {org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.jvm.environment=standard-jvm, org.gradle.jvm.version=8, org.gradle.libraryelements=classes, org.gradle.usage=java-api}

gradle-module-metadata内容：

{
  "formatVersion": "1.1",
  "component": {
    "group": "androidx.browser",
    "module": "browser",
    "version": "1.4.0",
    "attributes": {
      "org.gradle.status": "release"
    }
  },
  "createdBy": {
    "gradle": {
      "version": "7.2"
    }
  },
  "variants": [
    {
      "name": "releaseVariantReleaseApiPublication",
      "attributes": {
        "org.gradle.category": "library",
        "org.gradle.dependency.bundling": "external",
        "org.gradle.libraryelements": "aar",
        "org.gradle.usage": "java-api"
      },
      "dependencies": [
        {
          "group": "androidx.core",
          "module": "core",
          "version": {
            "requires": "1.1.0"
          }
        },
        {
          "group": "androidx.annotation",
          "module": "annotation",
          "version": {
            "requires": "1.1.0"
          }
        },
        {
          "group": "com.google.guava",
          "module": "listenablefuture",
          "version": {
            "requires": "1.0"
          }
        }
      ],
      "files": [
        {
          "name": "browser-1.4.0.aar",
          "url": "browser-1.4.0.aar",
          "size": 203214,
          "sha512": "5fabb554ca4dbea2c367df0decf175fee0a90bbdd7cc641c645b80a26e8bd13e85d5031c51bfbab25582a07f66e3eee829fadfe8b2e4e3383c4d877ce37935b2",
          "sha256": "e1906f84512f1ea5e4c926dbb915789ad8f7494fa4ee9ad245163f76185cecda",
          "sha1": "403c3cf31622ec0c70b3c0633be3e903c8062104",
          "md5": "8b6dfac591dd4b320351218bae97040e"
        }
      ]
    },
    {
      "name": "releaseVariantReleaseRuntimePublication",
      "attributes": {
        "org.gradle.category": "library",
        "org.gradle.dependency.bundling": "external",
        "org.gradle.libraryelements": "aar",
        "org.gradle.usage": "java-runtime"
      },
      "dependencies": [
        {
          "group": "androidx.collection",
          "module": "collection",
          "version": {
            "requires": "1.1.0"
          }
        },
        {
          "group": "androidx.concurrent",
          "module": "concurrent-futures",
          "version": {
            "requires": "1.0.0"
          }
        },
        {
          "group": "androidx.interpolator",
          "module": "interpolator",
          "version": {
            "requires": "1.0.0"
          }
        },
        {
          "group": "androidx.core",
          "module": "core",
          "version": {
            "requires": "1.1.0"
          }
        },
        {
          "group": "androidx.annotation",
          "module": "annotation",
          "version": {
            "requires": "1.1.0"
          }
        },
        {
          "group": "com.google.guava",
          "module": "listenablefuture",
          "version": {
            "requires": "1.0"
          }
        }
      ],
      "files": [
        {
          "name": "browser-1.4.0.aar",
          "url": "browser-1.4.0.aar",
          "size": 203214,
          "sha512": "5fabb554ca4dbea2c367df0decf175fee0a90bbdd7cc641c645b80a26e8bd13e85d5031c51bfbab25582a07f66e3eee829fadfe8b2e4e3383c4d877ce37935b2",
          "sha256": "e1906f84512f1ea5e4c926dbb915789ad8f7494fa4ee9ad245163f76185cecda",
          "sha1": "403c3cf31622ec0c70b3c0633be3e903c8062104",
          "md5": "8b6dfac591dd4b320351218bae97040e"
        }
      ]
    },
    {
      "name": "sourcesElements",
      "attributes": {
        "org.gradle.category": "documentation",
        "org.gradle.dependency.bundling": "external",
        "org.gradle.docstype": "sources",
        "org.gradle.usage": "java-runtime"
      },
      "files": [
        {
          "name": "browser-1.4.0-sources.jar",
          "url": "browser-1.4.0-sources.jar",
          "size": 96524,
          "sha512": "cd150044fd65d22c61f9d724a18b6a7386e4aed98644b146ffef0447b4f6f93044cb9fe58590f6111d33723733abc34039896a88a974ab0e465d05534294b101",
          "sha256": "3acbcce900ca5c2d03eb70d93136fc732d3b64dec185eaa86de3e64dff8ee792",
          "sha1": "2a2741f63427dcdb3b6821dd17703bc16ced13a1",
          "md5": "9eed77c8c21aeed4da0477c8bc6b72b9"
        }
      ]
    }
  ]
}

原因分析 #

从调试日志和元数据可以看出：

1. Java插件的compileClasspath配置需求的属性是org.gradle.libraryelements=classes（即需要包含编译类文件的jar包）
2. androidx.browser:1.4.0仅提供了aar格式的变体（org.gradle.libraryelements=aar），这是Android专用的库格式，包含Android资源、清单等内容，Java项目无法识别
3. androidx.browser:1.0.0同时发布了jar和aar变体，因此Java项目可以匹配到jar格式的变体，依赖解析成功

排查方法 #

1. 查看变体匹配日志：执行gradle dependencies --configuration compileClasspath --debug，重点关注ComponentAttributeMatcher相关日志，确认需求属性和依赖提供的属性是否匹配
2. 对比版本元数据：查看不同版本的gradle-module-metadata或maven仓库中的发布内容，确认依赖是否提供了当前项目所需的格式
3. 检查插件兼容性：Android专用库通常需要配合Android Gradle插件使用，Java插件无法处理aar格式的依赖

解决方向 #

1. 切换到Android项目：如果确实需要使用androidx.browser，应创建Android项目，使用com.android.application或com.android.library插件，该插件原生支持aar依赖
2. 避免在Java项目中使用Android专用库：androidx.browser是为Android平台设计的，包含Android特有的API，即使强行引入aar，Java项目也无法正常编译运行

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