离线环境下Android Gradle构建报错：缺失Maven Pom元数据如何修复？

核心解决思路 #

离线环境中，Gradle默认优先查找Maven POM元数据，但本地仓库的构件可能只提供Ivy描述文件（ivy.xml）或无标准元数据。通过调整仓库的metadataSources配置，让Gradle尝试其他元数据来源或直接从构件文件本身解析信息。

具体修复步骤 #

1. 定位仓库配置 #

打开项目根目录的build.gradle（或settings.gradle，取决于你的仓库声明位置），找到repositories代码块。

2. 调整metadataSources配置 #

根据你使用的本地仓库类型，添加对应的元数据来源声明：

情况1：使用flatDir本地仓库

如果是通过flatDir引用本地jar/aar文件：

repositories {
    flatDir {
        dirs 'libs' // 你的本地构件目录
        metadataSources {
            ignoreGradleMetadata() // 忽略Gradle专属元数据
            artifact() // 直接从构件文件解析信息（无元数据时用这个）
            ivyDescriptor() // 如果有ivy.xml元数据，加上这个
        }
    }
}

情况2：使用mavenLocal本地仓库

如果是本地Maven仓库（mavenLocal()）：

repositories {
    mavenLocal {
        metadataSources {
            mavenPom() // 优先尝试POM（如果存在）
            ivyDescriptor() // 其次尝试Ivy描述文件
            artifact() // 最后直接从构件解析
        }
    }
}

3. 验证本地构件 #

• 如果构件有ivy.xml文件，确保它和构件文件放在对应目录（比如Maven仓库结构中，和jar/aar同层级）。
• 如果没有任何元数据文件，确保metadataSources中包含artifact()，Gradle会自动从文件名推断groupId、artifactId和版本信息（需遵循groupId-artifactId-version.ext的命名规则）。

4. 清理缓存并重新构建 #

执行以下Gradle命令清理离线缓存，避免旧缓存干扰：

./gradlew clean build --offline

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