summaryrefslogtreecommitdiffstats
path: root/android/README
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-03-09 00:06:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-03-09 00:06:44 +0000
commit44cf8ec67278bd1ab6c7f83a9993f7a5686a9541 (patch)
tree5eec4b0d1a3f163d279c3c27c03324ba49fa235a /android/README
parentInitial commit. (diff)
downloadzbar-44cf8ec67278bd1ab6c7f83a9993f7a5686a9541.tar.xz
zbar-44cf8ec67278bd1ab6c7f83a9993f7a5686a9541.zip
Adding upstream version 0.23.93.upstream/0.23.93upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'android/README')
-rw-r--r--android/README110
1 files changed, 110 insertions, 0 deletions
diff --git a/android/README b/android/README
new file mode 100644
index 0000000..c253110
--- /dev/null
+++ b/android/README
@@ -0,0 +1,110 @@
+ZBar Android SDK
+================
+
+ZBar Bar Code Reader is an open source software suite for reading bar
+codes from various sources, such as video streams, image files and raw
+intensity sensors. It supports EAN-13/UPC-A, UPC-E, EAN-8, Code 128,
+Code 93, Code 39, Codabar, Interleaved 2 of 5, QR Code and
+DataBar. These are the JNI wrappers for developing the library on
+Android platform.
+
+Check the ZBar home page for the latest release, mailing lists, etc.
+ https://github.com/mchehab/zbar
+
+Copyright and License
+---------------------
+Licensed under the GNU Lesser General Public License, version 2.1.
+http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt
+
+Copyright 2008-2012 © Jeff Brown <spadix@users.sourceforge.net> et al
+
+The Android distribution also includes pre-compiled binaries of
+supporting libraries, for which copyright, license and source code
+locations are as follows:
+ * The GNU libiconv character set conversion library
+ Copyright (C) 1999-2011 Free Software Foundation, Inc.
+ This distribution includes GNU libiconv version 1.14, licensed under
+ the LGPL version 2. The source code is available from
+ http://www.gnu.org/software/libiconv
+
+See included files COPYING and LICENSE.md for details.
+
+
+Installation
+------------
+
+After downloading the ZBar-Android-Lib-<version>.zip file, you need to
+unzip the file and add it to your Android project. Unzip the file
+using your favorite method (ie: command-line, finder, windows
+explorer...)
+
+Follow one of the two options.
+Option 1 - via command line
+ cd <android project>
+ cp -r ZBar-Android-SDK-<version>/libs .
+
+Option 2 - via Eclipse
+ Right click on Android Project
+ Select "Import" -> "File System"
+ Select "Browse" (next to "From directory File" and select the
+ ZBar-Android-SDK-<version>/libs directory and click "Open".
+ Click the check box next to "libs" and the "Options" "Create top-level folder"
+ check box (below).
+ Then click "Finish".
+
+ You should then see a "libs" folder under your project.
+
+Building
+--------
+
+Via Eclipse
+You have to add the zbar.jar file to your build path
+ 1) select zbar.jar under libs
+ 2) right-click, select "Build Path" -> "Add to Build Path"
+
+Via command-line
+You are all set; ant will automatically find jar files under the "libs"
+subdirectory.
+
+Documentation
+-------------
+ TDB
+
+Examples
+--------
+
+You should be able to open and build the examples directly from the
+unzipped directory. You will need to run the android tools to setup
+the local.properties file which sets sdk.dir.
+ 1) cd <unzip dir>/examples/CameraTest
+ 2) android update project --path .
+ 3) ant debug install
+
+If you have problems with this, please create a new Android project
+and copy the necessary files from the examples.
+
+examples/CameraTest is a simple demonstration of how to integrate the
+ZBar image scanner with the camera.
+
+Manually building ZBar JNI library
+----------------------------------
+First download and unzip the iconv library source from
+ http://www.gnu.org/software/libiconv/
+
+Then kick off the build from the ZBar android directory. You will
+need to run the android tools to setup the local.properties file which
+setups sdk.dir.
+
+ 1) cd <zbar project>/android
+ 2) android update project --path .
+ 3) ant -Dndk.dir=<NDK path> -Diconv.src=<iconv library src> zbar-all
+
+This will rebuild all source files, create zbar.jar and
+ZBarAndroidSDK.zip file (which bundles the jar and shared
+libraries). From here, you can follow the steps for "Integrating ZBar
+JNI library in Android project".
+
+To clean run:
+ ant -Dndk.dir=<NDK path> zbar-clean
+
+See build-ndk.xml for additional target options.