mirror of
https://github.com/zxing/zxing.git
synced 2024-11-10 13:04:05 -08:00
cfd495a61a
git-svn-id: https://zxing.googlecode.com/svn/trunk@1412 59b500cc-1b3d-0410-9834-0bbf25fbcc57
50 lines
3.5 KiB
Plaintext
50 lines
3.5 KiB
Plaintext
Zxing for iphone is a sub-project of zxing project partially maintened by
|
|
independent developers. As of 2nd of June 2010, it contains 3 iPhone projects:
|
|
- BarCodes: Original zxing iPhone app. Available on app store. However, the code is cirrently maintained
|
|
- ZXingWidget: a Library that can be included in any iPhone app
|
|
- ScanTest: a simple test app for ZXingWidget
|
|
|
|
|
|
How to include ZXingWidget in a easy and clean way:
|
|
====================================================
|
|
|
|
1. Locate the "ZXingWidget.xcodeproj" file under "`zxing/iphone/ZXingWidget/`". Drag ZXingWidget.xcodeproj and
|
|
drop it onto the root of your Xcode project's "Groups and Files" sidebar. A dialog will
|
|
appear -- make sure "Copy items" is unchecked and "Reference Type" is "Relative to Project"
|
|
before clicking "Add".
|
|
|
|
2. Now you need to link the ZXingWidget static library to your project. Click the "ZXingWidget.xcodeproj"
|
|
item that has just been added to the sidebar. Under the "Details" table, you will see a single
|
|
item: ZXingWidget.a. Check the checkbox on the far right of ZXingWidget.a.
|
|
|
|
3. Now you need to add ZXingWidget as a dependency of your project, so Xcode compiles it whenever
|
|
you compile your project. Expand the "Targets" section of the sidebar and double-click your
|
|
application's target. Under the "General" tab you will see a "Direct Dependencies" section.
|
|
Click the "+" button, select "ZXingWidget", and click "Add Target"
|
|
|
|
4. Finally, we need to tell your project where to find the ZXingWidget headers. Open your
|
|
"Project Settings" and go to the "Build" tab. Look for "Header Search Paths" and double-click
|
|
it. Add the relative path from your project's directory to the
|
|
"zxing/iphone/ZXingWidget/Classes" directory. Make sure you click the checkbox "recursive path" !
|
|
|
|
5. Ultimately you need to make a tweak so that ZXing actually decodes barcode. In target section, double
|
|
click on your project target, and go to the build tab. Look for the "Exported Symbols Files" and
|
|
double-click on it. Att the relative path to the exportList files in "/zxing/iphone/ZXingWidget/exportList".
|
|
This will tell the linket to actually link with some key classes so that this code registers the necessary
|
|
decoders.
|
|
|
|
6. You're ready to go. Just #import <ZXingWidgetController.h> from anywhere and it should work !
|
|
|
|
Know issues for above steps to include:
|
|
======================================
|
|
- It can happen that when trying to build your own project with ZXoingWidgetController you get linker errors like
|
|
"undefined reference to". If this error looks like a c++ undefined reference, then renaming main.m into main.mm (Objectice-C++ source suffix)
|
|
may fix the problem
|
|
|
|
- If you have building error like " ... : No such file or directory", then it is a classical error, it means that the path to includes is not well
|
|
specified. The best way to fix this is to look at the Build Command that failed. To do that, click on the lower right corner of your XCode project,
|
|
you should see the build command that failed. Click on it and expand it by cliking on the "more" symbols that just appeared. This will make appear
|
|
the exact command line instruction that is ran and fails. You can then make sure that the Header search path you specified is there, and you can also
|
|
copy/paste this line into your terminal and try to see if you can reproduce/fix the error by adding the right path to the compiler. Once is is fixed,
|
|
you should have an idea of what's the problem and accordingly modify your Header Search Path.
|
|
|