Tích hợp thư viện OpenCV Android Library vào Android Studio

Bài đăng này đã không được cập nhật trong 5 năm

1. Giới thiệu

Gần đây khi mình bắt đầu làm việc với OpenCV trên Android. Trong quá trình tìm kiếm việc tích hợp OpenCV vào Android Studio mình gặp rất nhiều khó khăn do các bài hướng dẫn đã lỗi thời không còn phù hợp với hiện tại. Vì vậy mình quyết định viết một hướng dẫn đơn giản về việc này.

2. Tích hợp OpenCV

2.1 Download OpenCV Library Android

Các bạn truy cập vào link: OpenCV Library Android vào trang để tải cho mình phiên bản mới nhất. Tại thời điểm này phiên bản mới nhất đang là 4.0.0.
Sau quá trình tải xuống và giải nén file .zip. Mình sẽ được một folder như dưới đây:

2.2 Thiếp lập dự án trong Android Studio

Tạo một dự án trong Android Studio:

2.3 Import OpenCV Module

Sau khi tạo thành công dự án các bạn sẽ tiến hành import OpenCV:
Tiến click: File -> New -> Import Module

Cửa số xuất hiện như hình bên trên bạn có thể chọn đường dẫn tới module mà bạn import:
Bạn trỏ tới thư mục mà bạn đã giải nén file .zip khi download OpenCV về. Bạn chọn folder SDK tiếp đến là folder Java

Sau khi chọn đúng đường dẫn và nhấp vào OK , bạn sẽ nhận được một màn hình như hình ảnh bên dưới.

Nhấn vào Next để đến màn hình tiếp theo. Trên màn hình tiếp theo (hình ảnh bên dưới), bạn nên để các tùy chọn mặc định được chọn và nhấp vào Finish để hoàn tất quá trình nhập mô-đun.

2.4 Fixing Gradle Sync Errors

Bạn sẽ gặp lỗi build Gradle sau khi nhập xong thư viện OpenCV. Điều này xảy ra vì thư viện đang sử dụng SDK Android cũ mà bạn có thể chưa cài đặt.

Để nhanh chóng khắc phục lỗi này, hãy chuyển từ ngăn Android sang khung Project ở phía bên trái của Android Studio.

Đến mô-đun thư viện OpenCV và mở build.gradletệp của nó .

Để khắc phục lỗi, bạn chỉ cần thay đổi compileSdkVersionvà targetSdkVersionsang phiên bản SDK Android mới nhất hoặc phiên bản bạn đã cài đặt trên PC. Sau khi thay đổi phiên bản, bạn nên nhấp vào nút Syns để Gradle có thể đồng bộ hóa dự án.

2.5 Add the OpenCV Dependency

Để làm việc với thư viện Android OpenCV, bạn phải thêm nó vào appmô-đun của mình dưới dạng dependency.

2.6 Add Native Libraries

Bạn tiếp tục mở folder sdk và sau đó là folder native (Sử dụng hình ảnh bên dưới làm hướng dẫn).

ao chép folder libs trong thư mục gốc sang folder app chính của mô-đun dự án của bạn (Thông thường ProjectName/app/src/main).
Đổi tên folder libs bạn vừa sao chép vào dự án của bạn jniLibs.

2.7 Add Permission

Để sử dụng thành công OpenCV, ứng dụng của bạn phải có quyền của máy ảnh được thêm vào tệp AndroidManifest.xml.
Note: Đừng quên yêu cầu cấp phép camera trong thời gian chạy trên Android 6 trở lên.

< used-  allow android : name = " ERIC.CAMERA " />

    < used-  Feature android : name = " android.hardware.camera "  android : required = " false " />
    < used-  Feature android : name = " android.hardware.camera.autof Focus "  android : required = " false " />
    < used-  Feature android : name = " android.hardware.camera.front "  android : required = " false " />
    < used-  Feature android : name = " android.hardware.camera.front.autof Focus "  android : required = " false " />

3. Demo

Để xác nhận rằng bạn đã tích hợp thành công thư viện OpenCV Android, bạn có thể thử một trong các mẫu có trong tệp zip thư viện.
Hãy thử color-blob-detection sample. Bạn có thể xem sample trong hành động dưới đây: Samples

4. Một số lưu ý

Vì bạn đang gói các thư viện gốc trong APK ứng dụng của mình, nên bạn sẽ có kích thước APK ứng dụng rất lớn.
Một cách để giải quyết vấn đề này là sử dụng các phần tách ABI , do đó bạn chỉ có các thư viện cần thiết cho mỗi thiết bị trong APK.
Một cách khác xung quanh vấn đề kích thước là sử dụng Library OpenCV . Trong thư mục nơi bạn trích xuất nội dung thư viện vào, có một thư mục được gọi apk có chứa trình quản lý OpenCV cho các kiến trúc khác nhau.