| 未開啟「未知來源」安裝權限 | 點擊 APK 無反應/提示「為了安全,您的手機不允許安裝未知來源應用」 | 設置 → 安全/應用 → 未知來源 → 開啟 (Android 8+:設置 → 應用 → 特殊訪問權限 → 安裝未知應用 → 選擇瀏覽器/文件管理器 → 允許) |
| 版本不兼容 (minSdkVersion/targetSdkVersion) | 提示「應用未安裝」/「解析包時出現問題」 | 確認手機 Android 版本 ≥ APP `minSdkVersion`;開發者需適配目標版本行為變更 (權限、存儲、網絡) |
| 簽名衝突 (覆蓋安裝) | 已安裝同包名不同簽名應用 (如正式包覆蓋測試包) | 先卸載舊版 → 重新安裝;或統一簽名配置 |
| 存儲空間不足 | 提示「存儲空間不足」/安裝進度卡住 | 清理緩存、卸載無用應用、遷移數據到 SD 卡 |
| APK 文件損壞/不完整 | 下載中斷、傳輸錯誤 | 重新下載、校驗 MD5/SHA256 |
| 架構不匹配 (極少見) | APK 僅含 arm64-v8a so,手機為 x86 (模擬器/舊設備) | 開發者打包需包含 `abiFilters` 或通用 so |
| 系統解析包錯誤 (Android 14+) | 目標 SDK 過低、未聲明權限、清單文件錯誤 | 升級 `targetSdkVersion` 至 33+,完善清單聲明 |