Android Cloud Image Recognition SDK

We want to make your life easy. If you want to integrate CraftAR into your Android app, we provide a libs/ folder with all you need included, you can copy it in your project root directory.

Download Android SDK

How to get started with the Android Cloud Image Recognition SDK

In order to get started with the SDK, we recommend you to run the examples included in the distribution that you can download upon request (see button above). The examples are located in the Examples directory as an Android Studio Project.

Running the examples

The SDK is already linked in the project, available inside the distribution package. You can open it and just run the project from your device (note that running inside the Simulator is not available with the SDK).

The examples app opens a menu view that allows you to open the different examples. Each example opens the camera and the first step is for you to scan any object. We provide a set of reference images to point at that show different experiences. You can find those images in the folder Examples/Reference images.

We strongly recommend that you print this images out for testing. Pointing at them in your laptop/PC’s screen can heavily alter the experience due to artefacts that are invisible to your naked eye but very disturbing when captured with your smartphone.




Integrate the Android Cloud Image Recognition SDK into your own project

Follow this tutorial for instructions on how to integrate the Android Cloud Image Recognition SDK into your Android projects.


To build the project or use the library, you will need Google’s Android Studio 2.2 or newer and a device with Android 3.0 or newer.

Class Reference Documentation

Follow this link to browse through the classes of the Android Cloud Image Recognition SDK

Download Android SDK


Version 3.1

 December 15th, 2016

  • Added: (Camera) New methods to change the size of the picture when calling takePicture or singleShotSearch (getSupportedPictureSizes() and setPictureSizes()).
  • Fixed: (Camera) Crash when starting the camera in some cases.
  • Fixed: (Camera) Single shot search failed in some devices because the picture size was not properly set up.
  • Fixed: (Cloud Image Recognition) Bounding boxes were incorrect in responses from the Cloud Recognition.
  • Fixed: (Cloud Image Recognition) Fix problem requesting custom data embedded.
Version 3.0.5

 August 31st, 2016

  • New: Support for arm64 and x86 architectures (Note: the SDK is heavier, you can remove native folders or distribute them separately on Google Play).
  • Changed: Update included library that produced lots of warnings
  • Fixed: Crash on some devices caused by the processing of the camera frames.
  • Fixed: Network issues on Android < 4.4 if TLS 1.0 is not supported by the remote servers.
Version 3.0.4

 March 18th, 2016

  • Fixed freeze issue when restarting camera
Version 3.0.3

 January 15th, 2016

  • Request bounding boxes by default in cloud-recognition
  • Return image recognition score as an integer instead of a float
  • Return appropiate network error codes when network request fail (CraftARNetworkError)
  • Fix issue in Cloud recognition, that was calling at the same time searchResults() and searchFailed() if there was an exception in the searchResults() method
Version 3.0.2

 December 17th, 2015

  • Improve re-scaling for large pictures
  • Add support to use the flashlight in the camera class
Version 3.0.1

 November 20th, 2015

  • Fix crash on devices with Android < 4.2
Version 3.0

November 17th, 2015

  • New SDK Architecture
  • Added: Allows to use click and touch events in the CraftARCameraView class
  • Added: Allows to use flashlight
Version 2.0.1
  • Fixed: Issues with atofocus on some devices
  • Fixed: Problem with preview view starting in black in some cases.
Version 2

December 1st, 2014

  • The SDK package is now com.craftar
  • The SDK classes are now called CraftARxxx
  • The CloudRecognitionItem class is now called CraftARItem
  • Added: Support fragments
  • Improved: Faster recognition by using (points to the geographically closest server)
  • Fixed: Several bugs
Version 1

October 2nd, 2013
The first public version of the Android SDK focuses mainly on our Cloud Image Recognition functionalities.
Learn more about the launch of the SDK in our Releases Blog: Extra, Extra, Read All About our New SDK.