Android Studio 2.0 系統 Library 依賴衝突與 Repository 下載失敗解決

問題一：AppCompat v7 版本衝突

新建 Module 選擇「Navigation Drawer Activity」模板後，build.gradle 自動引入 com.android.support:appcompat-v7:23.+，但本地僅有 21.0.3，導致同步失敗。

解決方案

1. 修改 build.gradle 固定版本：

   dependencies {
       implementation 'com.android.support:appcompat-v7:28.0.0' // 明確指定穩定版本
       // 或使用 AndroidX (推薦)
       implementation 'androidx.appcompat:appcompat:1.6.1'
   }

2. 全專案統一版本管理 (根目錄 build.gradle)：

   ext {
       supportLibVersion = '28.0.0'
       // 或 androidxVersion = '1.6.1'
   }

   模組中引用：implementation "com.android.support:appcompat-v7:$rootProject.supportLibVersion"
3. 遷移至 AndroidX (AS 3.2+ 內建)： Refactor → Migrate to AndroidX，自動將 support library 替換為 androidx 對應套件。

問題二：Google Maven Repository 下載失敗 (網路封鎖)

錯誤訊息：Failed to download ... from https://maven.google.com/，導致 design library、constraint-layout 等依賴無法解析。

解決方案：替換為國內鏡像源

方案一：專案級 settings.gradle (Gradle 6.8+ 推薦)

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google() // 保留官方作為備援
        mavenCentral()
    }
}

方案二：根目錄 build.gradle (舊版 Gradle)

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        jcenter() // 已停止更新，建議移除
        mavenCentral()
    }
}

常用國內鏡像源

問題三：Gradle Wrapper 版本過舊

AS 2.0 預設 Gradle 2.10，不支援新版依賴解析機制。建議升級：

# gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-bin.zip

綜合排查步驟

1. File → Invalidate Caches / Restart 清除索引快取
2. Build → Clean Project / Rebuild Project 強制重新同步
3. 檢查 gradle.properties 是否有 android.useAndroidX=true、android.enableJetifier=true
4. 若使用 VPN/代理，確認 gradle.properties 代理設定正確
5. 離線模式檢查：File → Settings → Build, Execution, Deployment → Gradle → Offline work 取消勾選

最佳實踐總結

• 新專案直接使用 AndroidX，勿再用 Support Library
• 依賴版本集中管理，避免模組間版本衝突
• 配置國內鏡像源作為預設，官方源作為備援
• 定期更新 Gradle、AGP、NDK 至穩定版本