Android 專案編譯無錯誤但無法在手機/模擬器運行：Manifest 與 Activity 配置排查

常見原因清單

1. AndroidManifest.xml 缺少啟動 Activity 聲明：

   <activity android:name=".MainActivity"
       android:exported="true"> <!-- Android 12+ 必須顯式聲明 -->
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
   </activity>
   

2. 包名不一致：manifest 根標籤 package 與 Java/Kotlin 類實際包名、build.gradle applicationId 必須一致。
3. minSdkVersion 過高：超過測試設備 API Level。
4. 未簽名/簽名衝突：Release 包未簽名，或 Debug 簽名與裝置上殘留包衝突（先卸載舊版）。
5. Instant Run / 編譯緩存問題：Build → Clean Project → Rebuild，或關閉 Instant Run。

排查步驟

1. 查看 Logcat（過濾標籤 ActivityManager 或包名），定位 No Activity found to handle Intent 或 ClassNotFoundException。
2. 檢查 Build → Analyze APK 確認 classes.dex、resources.arsc、AndroidManifest.xml 內容正確。
3. 嘗試 adb install -r -t app-debug.apk 觀察詳細錯誤碼。

參考資源

完整排查指南：Android 程式無法運行常見原因總結