tducthang/opencv-android

Easy way to integrate OpenCv into your Android project via Gradle

OpenCV Android

Easy way to integrate OpenCV into your Android project via Gradle.
No NDK dependency needed - just include this library and you are good to go.

🚨 Breaking Changes

• OpenCV Contribution's package naming has been changed to make it as per the naming guideline.
  • Old: opencv:VERSION-contrib
  • New: opencv-contrib:VERSION

🚀 Releases

Each versions is available in only OpenCV as well as OpenCV with contributions.

4.x versions

• 4.5.3.0 ‼️
• 4.5.2
• 4.5.1
• 4.5.0
• 4.4.0

‼️ Please use 4.5.3.0 instead of 4.5.3. They are both the same versions, however, 4.5.3 has some runtime issues on some of the Android versions while 4.5.3.0 works fine.

3.4.x versions

• 3.4.15
• 3.4.14
• 3.4.13
• 3.4.12
• 3.4.5
• 3.4.1

👩‍💻 How to Integrate 🧑‍💻

• Add mavenCentral to your project's build.gradle file's repositories section if not already present.

repositories {
  mavenCentral()
}

• Add either the normal or contributions version in the dependencies of your module.

  // opencv
  implementation `com.quickbirdstudios:opencv:VERSION`

  // opencv with contributions
  implementation `com.quickbirdstudios:opencv-contrib:VERSION`
}

• Initialize OpenCV before using it.

if (!OpenCVLoader.initDebug())
   Log.e("OpenCV", "Unable to load OpenCV!");
else
   Log.d("OpenCV", "OpenCV loaded Successfully!");

‼️ Want to use OpenCV as source Dependency?

• Checkout the Repository. There will be an empty project with placeholder for the opencv source.
• Download the source from your desired release.
• Unzip the folder. The name of the folder will be opencv_VERSION or opencv-contrib_VERSION. Copy this folder to the project and keep it at the same level as the app folder.
• Open settings.gradle and replace the VERSION with the OpenCV version you have downloaded.

// Remove/comment out the one you aren't going to need
include ":opencv_VERSION"
include ":opencv-contrib_VERSION"

• Open app/build.gradle and replace the VERSION with the OpenCV version you have downloaded

// Remove/comment out the one you aren't going to need
implementation(project(":opencv_VERSION"))
implementation(project(":opencv-contrib_VERSION"))

• Sync and run the project. You should see the screen with the text OpenCV Loaded Successfully.

🛠 None of the released versions meet your requirements?

In progress 👷‍