HockeyApp Plugin

Integrate with HockeyApp for beta distribution & crash reports.

Beta Distribution

When developing an app or game you often want to allow beta testers to install your apps to get feedback early in your development process. With HockeyApp you can upload new versions of your iOS & Android builds and automatically notify your testers about the new version when they open your app the next time.

Crash Reports

HockeyApp collects and uploads crash reports from you apps or games for you. The plugin currently supports crash reporting for native iOS crashes and Android SDK crashes.

Overview

HockeyApp is a great way to distribute your beta versions and collect crash reports during development of your apps & games.

Use Cases

Beta Distribution

When developing an app or game you often want to allow beta testers to install your apps to get feedback early in your development process. With HockeyApp you can upload new versions of your iOS & Android builds and automatically notify your testers or customers about new the new version when they open your app the next time.

Crash Reports

HockeyApp collects and uploads crash reports from you apps or games for you. The plugin currently supports crash reporting for native iOS crashes and Android SDK crashes.

Note: Errors in your QML code are currently not supported.

Example Usage

To see an integration example of the HockeyApp plugin have a look at the V-Play Plugin Demo app.

To integrate HockeyApp into your Qt 5 app or game add the following item to your QML code:

 import QtQuick 2.1
 import VPlayPlugins 1.0

 HockeyApp {
   appId: "<HOCKEYAPP-APP-ID>"
 }

From now on the plugin notifies the user with a message box whenever an update is available.

Note: You can also use our example project on GitHub https://github.com/V-Play/PluginDemo as a starting point, which already comes pre-configured for HockeyApp.

Releasing Updates

HockeyApp identifies new updates by comparing the CFBundleVersion on iOS and the android:versionCode on Android. If the latest uploaded version identifier is higher than the version identifier given in the currently installed app bundle the user gets notified about the new update.

To distribute a new update to your users open up your app's Info.plist file and AndroidManifest.xml file and increment the CFBundleVersion (iOS) and android:versionCode (Android) values.

Note: You should also alter the human-readable CFBundleShortVersionString and android:versionName flags which are shown to your users.

As a last step build your apps in release mode, sign them with your appropriate certificates and upload them to HockeyApp.

Disabling HockeyApp for Store Builds

For builds intended for app store distribution you should disable the update service of HockeyApp. You can do this by setting the HockeyApp::disableUpdateManager property to false.

Available QML Items

HockeyApp

Plugin provides beta distribution and crash reports for iOS & Android apps

Integration

To use the HockeyApp plugin you need to add the platform-specific native libraries to your project, described here:

iOS Integration Steps

  1. Download our PluginDemo from https://github.com/v-play/PluginDemo/archive/master.zip and unzip it.
  2. Copy HockeySDK.framework from the ios subfolder to a sub-folder called ios within your project directory.
  3. Add the following lines of code to your .pro file:
     ios {
       VPLAY_PLUGINS += hockeyapp
     }

Android Integration Steps

  1. Open your build.gradle file and add the following lines to the dependencies block:
     dependencies {
       compile 'net.vplay.plugins:plugin-hockeyapp:2.+'
     }

    Note: If you did not create your project from any of our latest wizards, make sure that your project uses the Gradle Build System like described here.

HockeyApp Account

You finally need to set up a HockeyApp user account at https://www.hockeyapp.net.

Used HockeyApp SDK Versions

iOS 4.1.1
Android 4.1.1

Note: Other HockeyApp SDK versions higher than the stated ones might also be working but are not actively tested as of now.

Videos

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support