Operating Requirements

• Barcode Xpress for Android runs on devices with Android version 2.3.3 or higher.
• Building software with Barcode Xpress for Android requires Java 1.5 or higher, and the Android SDK Version 4.0.3 (API level 15) or higher.
• Applications using this library can be compiled to target the following architectures:
  • arm
  • armv7
  • arm64
  • x86
  • x86_64

Please note: If you do not have a paid license for the SDK, the last character of the barcode will be replaced with an asterisk ("*").

Deployment of Barcode Xpress Mobile is licensed on a per situation basis, and requires a licensing agreement with Accusoft. The Barcode Xpress Mobile toolkit remains in evaluation mode until the completion of an agreement with an Accusoft Sales Representative. Please contact sales@accusoft.com for more information.

Running the pre-built sample apps on your Android device

Two pre-built samples are provided in the APKs directory: BXFileSample.apk and BXCameraSample.apk.

• BXFileSample is a demonstration program that shows how the Barcode Xpress SDK can read a disk resident image, find a barcode in the image and decode it. It shows how the Barcode Xpress API can be used without the complexity of camera management removed. (Note that for further simplicity, the image is bundled into the .apk itself; in a real file reading application, you would need to use Java File I/O to interact with the SD card.)
  
  
• BXCameraSample is a demonstration program that shows how the Barcode Xpress SDK can be used to interact with the camera on an Android device to do real-time barcode scanning.
  

Either of these APKs may be downloaded directly onto your phone, using "adb install" or by mounting your device's disk on your computer and copying the file.

How to build the sample app and run it on your Android device

1. Go to the BXCameraSample directory, and update the file local.properties, setting the SDK directory path to point to your Android SDK directory.
   If you are building on Windows, be sure to use a Windows style path name in your local.properties file, e.g.
   sdk.dir=C:\\Program Files (x86)\\Android\\android-sdk
   
2. Then, after plugging in your Android device to your build machine, build the sample app as follows:

• Open Eclipse, press File->New->Android Project. Select the "Create project from existing source" radio button, and set the location to the directory where you unzipped this file, then select BXAPI. Do the same for BXCameraSample.
• Left-click on the arrow under the green Run button to create a run configuration for your Android Application. Specify the Run Configuration Name and Project Location.
• Press the Run button.

Alternately, you may open a terminal window in the directory where you unzipped this file, and:

1. Type "ant build"
2. cd to the bin directory
3. Use "adb install BXCameraSample.apk" to install the .apk on your Android device.

Required Permission Setting

This SDK requires the following permission setting:

      android.permission.CAMERA

as seen in the AndroidManifest.xml

For more details on customizing your app, please see the How To section of this document.