Repository files navigation

This is an XCode project skeleton structure that can be used to build a staticlibcrypto.a library for use in Mac and iPhone projects.

It is specifically intended for use in building secure iPhoneapplications alongsideSQLCipher,but it can easily be used for other applications.

This project is no longer being actively maintained by Zetetic, LLC.

It was originally created to help build SQLCipher for Apple platforms using OpenSSL as the crypto provider. It was no longer needed once Common Crypto became the crypto provider for SQLCipher on these platforms. For help building SQLCipher and including it in an Xcode project,please see this tutorial.

In a normal case you would use it thusly:

1. Download the OpenSSL source code directly fromhttp://www.openssl.org/source/
2. Clone the openssl-xcode git repo to make a local copy
3. Either:a. Put the downloaded OpenSSL source tar.gz into the same folderas openssl.xcodeproj.
   b. Place an extracted OpenSSL distribution in a folder called 'openssl'within the same folder as openssl.xcodeprojc. Extracted the OpenSSL distribution directly into the same folderas openssl.xcodeproj.d. Setup a source tree definition in XCode for OPENSSL_SRC pointing thefolder containing openssl source code

Then, either open openssl.xcodeproj in XCode and initiate a build, or integrateit within another project:

1. Drag the openssl.xcodeproj file into your main project

2. Right-click on your project target, and add openssl.xcodeproj under "DirectDependencies" on the General tab.

3. On the Build tab for your project's target, find the "Header Search Paths"option, and add the path:

   $(SRCROOT)/Library/openssl/build/openssl.build/openssl/include

   (Assuming you've put openssl.xcodeproj at the path Library/openssl, and arebuilding from a source tarball)

4. Expand your target's "Link Binary With Libraries" build stage, and draglibcrypto.a from the openssl.xcodeproj group.

This project actually relies on the OpenSSL configure and makesystem to build the libraries. However, it does attempt to automaticallydetect and use the appropriate build settings for arch (i386/ppc/armv6),build tools, and SDK directories. This makes it appropriate for inclusionas a project reference into an iPhone application project. This project willalso check to see if the resulting crypto library is newer than the projectMakefile to avoid time consuming rebuild cycles.

Copyright (c) 2009, ZETETIC LLCAll rights reserved.

Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyrightnotice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyrightnotice, this list of conditions and the following disclaimer in thedocumentation and/or other materials provided with the distribution.
• Neither the name of the ZETETIC LLC nor thenames of its contributors may be used to endorse or promote productsderived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY ZETETIC LLC ''AS IS'' AND ANYEXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL ZETETIC LLC BE LIABLE FOR ANYDIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED ANDON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

• openssl-xcode was developed by Stephen Lombardo at Zetetic LLC (sjlombardo at zetetic.net /http://www.zetetic.net)
• adapted for use with source archives by Michael Tyson of A Tasty Pixel (michael at atastypixel.com)