• This repository has been archived on 20/Feb/2020
  • Stars
    star
    2,175
  • Rank 21,206 (Top 0.5 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created over 14 years ago
  • Updated almost 8 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.

About:

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 !!!). 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 http://jeffreysambells.com/posts/2010/06/22/ios-wireless-app-distribution/ where Jeffrey Sambells wrote about the mechanisms required and being available for us to use.

A complete documentation can be found in the wiki at https://github.com/TheRealKerni/HockeyKit/wiki

Requirements:

  • A PHP5 server needs to be available and is required for distribution of the apps
  • iOS 7.1 and later require apps to be distributed via https using a valid signed server certificate trusted by the iOS device
  • No database required!

Features:

  • 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 and )
  • 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 3 build script to upload all files to your server after a build (Beta Automatisation.sh)

Notes:

  • 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
  • Please check the iOS README.mkdown for addition iOS client related notes
  • 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.
  • Don't make separate names per IPA file you make, because only the first file found per directory be served

BRANCHES:

The branching structure follows the git flow concept, defined by Vincent Driessen: http://nvie.com/posts/a-successful-git-branching-model/

  • Master branch:

    The main branch where the source code of HEAD always reflects a production-ready state.

  • Develop branch:

    Consider this to be the main branch where the source code of HEAD always reflects a state with the latest delivered development changes for the next release. Some would call this the “integration branch”.

  • Feature branches:

    These are used to develop new features for the upcoming or a distant future release. The essence of a feature branch is that it exists as long as the feature is in development, but will eventually be merged back into develop (to definitely add the new feature to the upcoming release) or discarded (in case of a disappointing experiment).

  • Release branches:

    These branches support preparation of a new production release. By using this, the develop branch is cleared to receive features for the next big release.

  • Hotfix branches:

    Hotfix branches are very much like release branches in that they are also meant to prepare for a new production release, albeit unplanned.

Acknowledgments:

The following 3rd party open source libraries have been used:

More Repositories

1

QuincyKit

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
1,621
star
2

HockeySDK-iOS

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
597
star
3

HockeySDK-Android

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Java
279
star
4

CrashProbe

CrashProbe is a test suite for crash reporting services on iOS and OS X.
Objective-C
140
star
5

HockeySDK-Mac

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
121
star
6

HockeySDK-Windows

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
90
star
7

HockeyApp-for-Mac

Easily upload your iOS, OS X and Android apps to HockeyApp.
Objective-C
88
star
8

HockeySDK-Cordova

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
82
star
9

HockeySDK-Xamarin

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
56
star
10

HockeySDK-Unity-iOS

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
45
star
11

HockeySDK-Unity-Android

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
26
star
12

PLCrashReporter

Previous PLCrashReporter mirror with HockeyApp extensions
20
star
13

HockeyApp-for-Windows

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
17
star
14

BakeBread

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Java
16
star
15

HockeySDK-WindowsDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
14
star
16

HockeySDK-tvOS

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
7
star
17

infinite-loop

HockeyApp was retired. Please use App Center instead.
Ruby
7
star
18

HockeySDK-iOSDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
7
star
19

HockeySDK-MacDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Objective-C
7
star
20

CrashProbe-Data

This repository contains all the test results from the CrashProbe tests.
5
star
21

HockeySDK-AndroidDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Java
5
star
22

HockeySDK-Unity-Windows

C#
4
star
23

HockeySDK-JS

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
JavaScript
4
star
24

HockeySDK-tvOSDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
Swift
1
star
25

HockeySDK-XamarinDemo

HockeyApp was retired and the SDKs are deprecated. Please use App Center instead.
C#
1
star
26

crashprobe.github.com

HTML
1
star
27

.github

1
star