Android 百度地圖 SDK：MapView XML 載入失敗的排查與解決

錯誤現象

在布局 XML 中宣告 <com.baidu.mapapi.map.MapView ... />，建構專案報錯：Error in an XML file: aborting build。

常見原因

• 專案匯入了完整 SDK 所有 JAR/AAR，導致類別衝突、資源合併錯誤或方法數超標。
• 缺少必要的 meta-data（API Key）在 AndroidManifest.xml。
• 模組 build.gradle 未正確配置 implementation 依賴。

最佳實踐

1. 按需引入：僅引入專案實際用到的模組（如 base、map、search），不要把整個 BaiduLBS_Android.jar 或所有 aar 全丟進 libs。
2. 使用 Maven/Gradle 依賴管理（官方提供 Maven 倉庫），避免手動複製 JAR。
3. 檢查 AndroidManifest.xml 權限與 meta-data android:name="com.baidu.lbsapi.API_KEY" 是否正確。
4. 清理專案：Build > Clean Project，再 Rebuild。

「血的教訓」：精簡依賴是避免百度地圖 SDK 接入坑的關鍵。