Building OpenRemote iPhone 2.0 Console
OpenRemote 2.0 iPhone console is one of the components in the platform checkout. Please see the instructions on the Subversion checkout if you haven't checked out the source release before.
The iPhone Console component contains an Xcode project file which you can use to load the project to Xcode IDE (openremote.xcodeproj file at the root of the iPhone component source checkout).
- Building OpenRemote iPhone console requires an Apple toolchain with Mac OS computer (Snow Leopard recommended) and Xcode IDE. No other toolchains are currently supported.
- OpenRemote iPhone 2.0 is compliant with iPhone SDK 3.0
Running OpenRemote Console in iPhone Emulator
Open the OpenRemote Xcode project into the Xcode IDE.
If you've done previous work in the Xcode, you can ensure you start from a clean slate by executing 'Clean All Targets' first from the Xcode menu, as shown in Image 1 below.
Image 1: Clean All Targets in Xcode IDE
Then make sure you are building the project for emulator use. Switch the 'Active Target' in Xcode to 'Simulator 3.0' and 'Active Configuration' to 'Debug' as shown Image 2 below.
Image 2: Set 'Active Target' and 'Activate Configuration' for iPhone Emulator
Finally, make sure code signing is turned off – unless you've created valid developer signing keys before but code signing is not necessary for iPhone emulator. Go to 'Build' menu in Xcode and 'Edit Project Settings' (see Image 3 below).
Image 3: Edit Project Settings in Xcode
In the 'Project Settings' make sure you are editing 'Debug' configuration and turn off code signing as shown in Image 4.
Image 4: Set Code Signing properties in Xcode project.
Finally, build and run the project which will compile and run the OpenRemote application in the iPhone emulator (shown in Image 5).
Image 5: Build and Run project in Xcode
Deploying on Hardware
Deploying the OpenRemote iPhone application on hardware device requires a provisioning profile and keys from Apple. These are only available through Apple developer accounts for which you need to sign up and pay for.
The project details other than configuring the code signing keys are mostly the same. Please refer to Apple Developer Connection documentation on receiving required certificates and setting up keys in keychain and installing required provisioning profiles.
When building for a hardware device, change the Xcode project settings to 'Device 3.0' SDK and 'Distribution' configuration (shown in Image 6 below).
Image 6: Setting Up Xcode for Hardware Distribution
The provisioning profile needs to be installed via 'Organizer' in Xcode (shown in Images 7 and 8).
Image 7: Choose Organizer from the 'Window' menu
Image 8: Organizer keeps track of all your provisioning profiles
Finally set up your signing identity (as shown in Image 9) and then build the project.
Image 9: Set up code signing keys in project settings