Skip to content
Find file
New pull request
Pull request Compare This branch is 586 commits behind bitstadium:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Hockey is a iOS Ad-Hoc updater framework. It can be used for all apps that target the Apple AppStore and improves the beta testing process dramatically. All beta testers. It consists of two components, a server and a client framework.
The server component is required for all scenarios. But it also can work standalone without the client library. It provides a web interface which beta testers can use to install the latest AdHoc provisioning profile and also the latest beta version via Safari right from the device. One server installation is able to  handle multiple applications via different bundle identifiers (I highly suggest using different bundle identifiers for Debug, AdHoc Beta and AppStore release builds !!!).
The client framework should only be included in AdHoc builds and should NOT (!!) be used in AppStore distribution builds! By default the client library will check for updates on your server whenever the app is started or will wake up. The user can adjust this in the settings dialog to alternatively only check once a day or manually.

This framework was created after reading the blog post at where Jeffrey Sambells wrote about the mechanisms required and being available for us to use.

- A PHP5 server needs to be available and is required for distribution of the apps
- No database required!

- iOS AdHoc build OTA distribution
- Automatically generated website, in specific versions for all device types and desktop browser
- Web interface only requires subdirectory to be created and and .ipa and .plist file (any name) being added/updated
- Website can be used for first time installation and updates, iOS3 users can use the website from a desktop browser to download the app, iTunes installation instructions for those are also included
- Can handle multiple apps on one server, one subdirectory per app
- Optionally shows release notes by displaying the content of a file with the extension .html (use HTML format without wrapping it in <html> and <body>)
- Provisioning profile link shown optionally (useful if new users are added without building a new version just for them)
- Support for app icon on website and during installation on the device. place any .png file into the subdirectory (114x114 pixel works on all devices!)
- Optional client side framework
- Framework notifies users on startup of new updates, iOS4 users can install directly from within the client (In-App-Updates), iOS3 users will be hinted to the website
- Framework optionally sends UDID, app version, iOS version, device type to the server, overview will appear automatically in /stats/ website (write access for PHP scripts required)
- Stats website supports replacing UDIDs with names by entering them into a userlist.txt file within the stats subdirectory
- Bookmarklet to extract all UDIDs and names from iOS program portal device page available in the stats page
- Template for an Xcode build script to upload all files to your server after a build (Beta

- The server can run stand alone, the client is optional
- Beta testers need to run at least iOS 4 to benefit from the auto update functionality
- Beta testers using iOS 3 will also be notified of updates within the app
- The client framework optionally watches for Reachability notifications to detect if the device is online or not
- To automatically exclude the library from the AppStore version make sure to add access to the build configuration variable by adding "CONFIGURATION_$(CONFIGURATION)" to the preprocessor macros of all configurations in the project settings of your app.
- Do not enter a link to the app icon in the organizer screen. Hockey will add that part into the PList automatically on the server, if there is a PNG file found (114pixel icons work on all devices!)
- Make sure the IPA filename has no space in it. iOS is not able to call that URL correctly.


The following 3rd party open source libraries have been used:
- SBJson by Stig Brautaset (
- NSString+URLEncoding by Kaboomerang LLC.
- bluescreen css framework (
- PHP plist reader code from
Something went wrong with that request. Please try again.