Three20 Library Deployment and Usage Guide

Prerequisites

• macOS with Xcode installed
• iOS SDK (included with Xcode)
• Objective-C development environment
• Git for cloning the repository

Installation

1. Clone the repository:

   git clone https://github.com/facebookarchive/three20.git
   cd three20
   

2. Open the project in Xcode:

   open Three20.xcodeproj
   

3. Build the library:

   • Select the appropriate target (Three20, Three20Core, Three20Network, etc.)
   • Choose a simulator or device from the scheme menu
   • Press Cmd+B to build the project

Configuration

Three20 does not require additional configuration files or environment variables. However, you may need to:

• Add the Three20 headers to your project's search paths
• Link against the Three20 libraries in your application target
• Import the necessary Three20 headers in your source files

Build & Run

Development

1. Add Three20 to your Xcode project:

   • Drag the Three20 project file into your application's project navigator
   • Add the Three20 libraries as dependencies in your target's Build Phases
   • Add the Three20 headers to your target's Header Search Paths

2. Import and use Three20 classes:

   #import <Three20/Three20.h>
   // Use Three20 classes in your code
   

Production

• Ensure all Three20 dependencies are properly linked in your application target
• Test on actual devices, not just simulators
• Consider using a release configuration for optimized builds

Deployment

Three20 is a library for iOS development, so deployment involves:

1. Building your application that uses Three20
2. Submitting to the App Store through Xcode's Organizer
3. Distributing via enterprise methods if applicable (Ad Hoc, Enterprise distribution)

Troubleshooting

Common Issues

1. "Three20.h file not found" error:

   • Ensure the Three20 headers are in your project's Header Search Paths
   • Check that the path is relative to your project directory

2. Linker errors when using Three20 classes:

   • Verify that the Three20 libraries are added as dependencies
   • Ensure the libraries are linked in your target's Build Phases

3. Build fails on device but works in simulator:

   • Check that the architectures match between your app and Three20
   • Ensure you're using a device-compatible version of Three20

Additional Resources

• Check the original Three20 documentation and examples
• Review the source code in the src directory for implementation details
• Consult the Xcode build logs for specific error messages and resolutions