Android Studio 真機調試報錯：Local path doesn't exist 解決

現象

Uploading file
local path: F:\...\app-debug.apk
remote path: /data/local/tmp/com.example...
Local path doesn't exist.

原因

**APK 未生成**或生成路徑不匹配。常見觸發點：

• 代碼編譯錯誤導致 assembleDebug 失敗。
• 修改了 build.gradle 輸出路徑 / 產物名稱。
• Gradle 守護進程異常 / 緩存損壞。
• Instant Run / Apply Changes 衝突 (舊版本 AS)。

解決步驟 (按順序嘗試)

1. Build → Clean Project → Rebuild Project。
2. File → Invalidate Caches / Restart → Invalidate and Restart。
3. 檢查 app/build/outputs/apk/debug/ 下是否有 app-debug.apk。無則查看 Build 窗口錯誤信息 修復編譯錯誤。
4. Gradle 配置檢查：
   android { buildTypes { debug { // 不要自定義 outputFileName 除非必要 } } }
5. 命令行強制構建：
   ./gradlew clean assembleDebug (Linux/Mac)
   gradlew.bat clean assembleDebug (Windows)
6. 刪除 .gradle、build 文件夾後重新導入項目。

預防

• 保持 AS、Gradle Plugin、Gradle 版本兼容 (查看 官方對應表)。
• 避免手動修改 build/outputs 路徑，使用 applicationIdSuffix、versionNameSuffix 區分構建變體。