Flutter项目集成uni_links包时配置失败求助

问题分析 #

错误核心是jcenter仓库已停止服务（返回403 Forbidden），导致无法拉取旧版本的Android Gradle插件3.5.3，连带引发后续的项目配置异常。

解决步骤 #

1. 更新uni_links到最新版本 #

旧版本uni_links依赖已废弃的仓库，优先升级包版本：

• 打开项目根目录的pubspec.yaml，将uni_links的版本替换为最新稳定版（例如^0.5.1，可根据实际最新版本调整）
• 执行命令：flutter pub get

2. 替换Android项目的仓库配置 #

若升级包后仍有问题，修改Android模块的仓库设置：

• 打开android/build.gradle文件，找到repositories和buildscript.repositories块
• 删除jcenter()，添加mavenCentral()和谷歌仓库：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      // 保留原有的dependencies配置
  }
  
  allprojects {
      repositories {
          google()
          mavenCentral()
      }
  }
  

3. 同步升级Android Gradle插件与Gradle版本 #

如果项目本身Gradle版本过低，同步更新以适配新仓库：

• 在android/build.gradle中，将com.android.tools.build:gradle版本修改为兼容的稳定版（例如7.4.2）
• 打开android/gradle/wrapper/gradle-wrapper.properties，将distributionUrl对应的Gradle版本调整为匹配值（例如gradle-7.5-all.zip对应插件7.4.2）

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

执行以下命令清理旧缓存，避免依赖残留干扰：

flutter clean
flutter pub get
cd android && ./gradlew clean build --refresh-dependencies
cd .. && flutter run

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