求助：Android Studio无法解析GitHub Packages的Gradle依赖

针对你遇到的Failed to resolve: com.example:package:version错误，结合Kotlin多平台模块发布到GitHub Packages的场景，可按以下步骤排查：

• 核对包元数据完全匹配
  登录GitHub进入目标仓库的Packages页面，逐一核对：

  • groupId（com.example）、artifactId（package）、version版本号是否和依赖声明完全一致（大小写、拼写、连字符都不能错）
  • 确认KMP模块发布的构件包含Android平台可用的产物（比如.aar或.jar），部分KMP配置可能只发布了元数据或其他平台构件

• 验证GitHub Packages仓库URL
  确保配置的仓库URLhttps://maven.pkg.github.com/[account-name]/[repository-name]中：

  • account-name是包所属的GitHub用户名/组织名
  • repository-name是发布该包的仓库名称，完全匹配原仓库的名称（含大小写）

• 确认Credentials权限与配置
  虽然错误令牌会触发认证报错，但仍需检查：

  • 所用的GitHub访问令牌必须拥有read:packages权限，且账号有权限访问该私有包（如果包是私有的）
  • 确保gradle.properties中配置的账号信息正确关联到仓库配置：
    在gradle.properties中添加：

    githubUsername=你的GitHub账号名
    githubPassword=带read:packages权限的访问令牌
    

    然后在仓库配置中明确读取这些属性：

    maven {
      name = "GitHubPackages"
      url = uri("https://maven.pkg.github.com/[account-name]/[repository-name]")
      credentials {
        username = project.findProperty("githubUsername") ?: System.getenv("GITHUB_USERNAME")
        password = project.findProperty("githubPassword") ?: System.getenv("GITHUB_TOKEN")
      }
    }
    

• 检查KMP模块的发布配置
  回到你的Kotlin多平台模块，确认发布配置正确生成了可被Android引用的构件：
  确保已应用maven-publish插件，且publication配置正确关联Android变体：

  // KMP模块的build.gradle.kts示例
  plugins {
    kotlin("multiplatform")
    `maven-publish`
    id("com.android.library")
  }
  
  publishing {
    publications {
      create<MavenPublication>("release") {
        from(components["release"]) // 关联Android Release变体
        groupId = "com.example"
        artifactId = "package"
        version = "version"
      }
    }
    repositories {
      maven {
        url = uri("https://maven.pkg.github.com/[account-name]/[repository-name]")
        credentials {
          username = System.getenv("GITHUB_USERNAME")
          password = System.getenv("GITHUB_TOKEN")
        }
      }
    }
  }
  

• 启用Gradle调试日志定位细节
  在Android Studio终端执行以下命令，查看依赖解析的完整过程：

  ./gradlew dependencies --configuration debugImplementation --info
  

  搜索com.example:package:version，查看日志中是否有从GitHub Packages仓库查找该包的记录，以及是否存在404、构件缺失等具体错误信息。

• 确认仓库配置层级
  确保GitHub Packages仓库配置添加在模块级build.gradle中（或项目级build.gradle的allprojects块内），避免因仓库配置范围不足导致无法找到依赖。

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