Android minSdkVersion 過低導致 API 調用崩潰：版本適配指南

錯誤現象

應用調用某系統 API 時崩潰，Logcat 提示 java.lang.NoSuchMethodError 或 VerifyError。

根本原因

代碼使用的 API（如 Notification.Builder 某構造方法）最低要求 **API Level 11 (Android 3.0)**，但 AndroidManifest.xml 中 minSdkVersion 設置為 8 (Android 2.2)。編譯通過（編譯目標 targetSdkVersion 較高），運行在低版本設備上找不到符號導致崩潰。

解決方法

1. 提升 minSdkVersion（推薦）：
   <uses-sdk android:minSdkVersion="11" />
   犧牲極舊設備兼容性，換取開發效率與穩定性。
2. 運行時版本判斷（兼容舊版本）：
   

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
       // 使用 API 11+ 功能
   } else {
       // 降級方案或提示不支持
   }

3. 使用 AndroidX / Support Library 回退實現：如 NotificationCompat.Builder 兼容至 API 4。

版本選擇建議（2024 視角）

• minSdkVersion 21 (Android 5.0)：覆蓋 99%+ 活躍設備，可無痛使用絕大多數現代 API。
• targetSdkVersion 始終設置為最新穩定版（如 34）。

驗證步驟

1. 修改 build.gradle 或 Manifest。
2. Clean Project → Rebuild。
3. 在 API 11+ 模擬器/真機運行測試。