Android Studio 整合 OpenCV 完整配置教程

在 Android Studio 中配置 OpenCV 涉及 SDK 導入、Gradle 同步、原生庫複製等多個步驟，稍有疏漏即報錯。以下是經驗證的標準流程（以 OpenCV 4.x 為例）。

1. 下載與解壓

官網 opencv.org/releases 下載 OpenCV for Android（如 opencv-4.9.0-android-sdk.zip），解壓至本地目錄（如 D:\OpenCV-android-sdk）。

2. 導入 Module

• Android Studio → File → New → Import Module。
• 選擇解壓目錄下的 sdk/java 資料夾（非 sdk/native）。
• Module name 可自定義（如 opencv），完成導入。

3. 修正 build.gradle

打開導入後的 opencv/build.gradle，將以下字段與主專案 app/build.gradle 保持一致：

compileSdkVersion 34
buildToolsVersion "34.0.0"
minSdkVersion 21
targetSdkVersion 34

點擊右上角 Sync Now 同步。

4. 添加 Module 依賴

• 右鍵 app 模組 → Open Module Settings (F4)。
• Dependencies 標籤 → + → Module Dependency → 選擇 opencv → OK。

5. 複製原生庫

將解壓目錄 sdk/native/libs 整個資料夾複製到專案 app/src/main/ 下，並重命名為 jniLibs（AS 會自動識別）。

6. 驗證運行

將 samples/tutorial-1-camerapreview 中的 Java、Layout、Manifest 權限（CAMERA）複製到專案，運行即可預覽攝像頭畫面，確認配置成功。

常見坑點

• 版本不一致：OpenCV Module 的 SDK 版本必須與主專案一致，否則編譯失敗。
• 缺少 jniLibs：未複製 libs 或重命名錯誤會導致 UnsatisfiedLinkError。
• OpenCV Manager 依賴：舊版本需手機安裝 OpenCV Manager App，新版本（4.0+）採用靜態鏈接，無需額外 App。

按此流程操作，可穩定在 Android Studio 中使用 OpenCV 進行圖像處理、模式識別開發。