萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 開發常見問題解決大全:R 文件消失、內存不足、ADB 超時、Manifest 配置錯誤

1. R 文件消失 / 紅叉報錯

原因:資源文件錯誤 (XML 語法、命名、引用) 導致 AAPT 編譯失敗,R 類無法生成。

排查步驟:

  1. 檢查 res/ 目錄下所有 XML:佈局、values、menu、xml 等 — 紅標報錯優先修復
  2. 檢查 文件命名:僅允許 [a-z0-9_.],嚴禁大寫字母、中文、特殊符號
  3. Clean Project → Rebuild Project
  4. 仍失效:File → Invalidate Caches / Restart

2. 編譯警告:No API Level Specified

現象:WARNING: Application does not specify an API level requirement!

修復:在 AndroidManifest.xml <manifest> 內添加:

<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />

3. 安裝失敗:INSTALL_FAILED_INSUFFICIENT_STORAGE

原因:模擬器/設備存儲空間不足,或 APK 體積超過可用空間。

方案一:協載重裝 (適用於已安裝舊版)

Settings → Apps → 選中 App → Uninstall → 重新 Run

方案二:擴大模擬器分區 (通用)

  • 舊版 AVD:啟動參數 -partition-size 512 (單位 MB)
  • 新版 AVD Manager:編輯虛擬機 → Show Advanced Settings → Storage → 增加 Internal Storage (建議 2GB+)
  • Gradle 配置:android { defaultConfig { javaCompileOptions { annotationProcessorOptions { arguments = ["room.schemaLocation": "$projectDir/schemas".toString()] } } } } (無關,僅示例)

4. ADB 安裝超時:timeout

現象:Failed to install on device 'emulator-5554': timeout

修復:

Eclipse/AS: Window → Preferences → Android → DDMS → ADB connection time out (ms)
默認 5000 → 改為 20000 或更大

或命令行:adb kill-server && adb start-server 重置連接。

5. ActivityManager: Activity class {…} does not exist

原因:Manifest 中啟動 Activity 名稱寫錯,或缺少 . 前綴。

正確寫法:

<activity android:name=".MainActivity"> <!-- 以點開頭,自動補全包名 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

6. No Launcher Activity Found

原因:Manifest 中缺少 LAUNCHER category。

修復:確保主 Activity 包含:

<category android:name="android.intent.category.LAUNCHER" />

7. SD 卡寫入權限被拒:FileNotFoundException (Permission denied)

修復:在 AndroidManifest.xml <manifest> 下添加:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 10+ 另需 requestLegacyExternalStorage 或 MediaStore -->

8. 其他高頻坑位速查

現象可能原因解決
資源引用 @drawable/xxx 找不到文件名大寫/中文/資源未編譯重命名小寫、Clean Rebuild
java.lang.OutOfMemoryError圖片過大/內存洩漏/模擬器 heap 小inSampleSize 壓縮、LeakCanary 排查、增大模擬器 RAM
NetworkOnMainThreadException主線程執行網絡請求子線程/協程/Retrofit+RxJava
ClassNotFoundException: Didn't find classMultiDex 未啟用/構建緩存/Instant Run 殘留啟用 multiDexEnabled true、Clean、關閉 Instant Run
Duplicate class / 依賴衝突多庫引用同一依賴不同版本Gradle dependencyInsight 排查、強制統一版本 (resolutionStrategy)
簽名驗證失敗 / INSTALL_PARSE_FAILED_NO_CERTIFICATES未簽名/簽名文件損壞/密鑰庫路徑錯Build → Generate Signed Bundle/APK 重新簽名

調試利器

  • Logcat 過濾:package:mine 只看當前應用、level:error 只看錯誤
  • Layout Inspector:實時查看 View 層級、屬性
  • Database Inspector:Room/SQLite 可視化調試
  • Network Inspector:HTTP/WS 請求詳情
  • Profiler:CPU/內存/網絡/能耗分析

總結

Android 開發常見問題 90% 集中在資源編譯 (R 文件)、存儲權限演進、Manifest 配置、模擬器環境、依賴衝突。建立「報錯 → 定位模塊 → 查官方文檔/遷移指南 → 最小化復現 → 修復驗證」的排查閉環,比死記硬背方案更高效。保持工具鏈 (AGP, Gradle, SDK, Emulator) 更新,閱讀 Release Notes,能預防大量已知坑位。

copyright © 萬盛學電腦網 all rights reserved