How To AdHoc

AdHoc Build and Distribution

Important Note: The following description may be outdated.
Please refer to the latest documentation at the Apple Developer Site

The AdHoc version is a special build which may be distributed to beta testers without going through the Apple store.

Build AdHoc

On the Apple [[http://developer.apple.com/iphone/manage/overview/index.action|iPhone Developer Portal]] prepare the AdHoc provisioning certificate ''karatasi.adhoc'' .

Load it down, it is named ''karatasi_adhoc.mobileprovision'' .

Load it into xCode by shifting onto the XCode icon.

The provisioning profiles are stored at ''~/Library/MobileDevices/Provisioning Profiles'' .

Compile karatasi using * Target: ''karatasi release'' or ''karatasi debug'' * Build configuration: ''DistributionAdHoc'' * SDK: ''Device - iPhone OS 2.2'' * in the project settings build/code signing identity select the AdHoc certificate.

Clean all targets

Build

If you have trouble with the code signing or handling the certificates, check the validity of your personal certificates!

Change into ''src/karatasi.iphone/build/Distribution AdHoc-iphoneos'' .

Copy ''karatasi.app'' and ''karatasi_adhoc.mobileprovision'' to where you find them.

Install AdHoc on the Device

The user should save all of his existing databases through the synchronization mechanism. After verifying that this did work he should backup the device through iTunes. Then he should delete the existing karatasi application from the iPhone. This will also delete the karatasi databases and the karatasi settings.

To install the AdHoc version, the user has to drop both files (''karatasi.app.zip'' and ''karatasi_adhoc.mobileprovision'') onto the iTunes icon. Then sync the device, the application should be available. On iTunes this version of karatasi has got no icon.

Finally setup the karatasi settings for the synchronization mechanism (host, password etc), and restore the karatasi databases through the synchronization mechanism.

For any further updates to a newer AdHoc version the user only needs to drop the application file 'karatasi.app''. It is not necessary to delete the application from the iPhone in this case.

Delete AdHoc

To delete the AdHoc version, the user has to delete the application on the device as usual.

He has to delete the provisioning profile on the device at Settings/General/Profiles''. It seems that the iPhone OS has a bug that sometimes drains the battery rapidly if the profile is kept without the application (http://discussions.apple.com/thread.jspa?threadID=1759320&tstart=30)

Then delete the application on iTunes from the iPhone application folder.

Remove the provisioning profile from the computer. Under OS X it is stored at ''~/Library/MobileDevice/Provisioning\ Profiles/'' , delete the profile ''karatasi_adhoc.mobileprovision'' . For Windows the path can be found under the link above.