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
- Old:
🚀 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
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'sbuild.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
oropencv-contrib_VERSION
. Copy this folder to the project and keep it at the same level as theapp
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 👷