Skip to content

JoshuaWeber/HockeySDK-Windows

 
 

Repository files navigation

HockeySDK for Windows

The official Windows SDK for the HockeyApp service. Supports .NET Framework >= 4.0 as well as Windows Phone and Windows Store Apps.

Introduction

The HockeySDK for Windows allows users to send crash reports right from within the application. When your app crashes, a file with basic information about the environment (device type, OS version, etc.), the reason and the stacktrace of the exception is created. The next time the user starts the app, he is asked to send the crash data to the developer. If he confirms the dialog, the crash log is sent to HockeyApp and then the file deleted from the device.

Furthermore it wraps the necessary api calls for sending feedback information to the platform.

Features & Installation via Nuget

Windows Phone 8

Nuget PM> Install-Package HockeySDK.WP
  • Automatic crash reporting (store and beta apps)
  • Feedback page (store and beta apps): Let your users send you feedback messages via HockeyApp
  • Automatic updates (only beta apps): Either all beta users must have developer unlocked phones or you need to either use an Enterprise Certificate to sign your beta apps. See http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj206943(v=vs.105).aspx
  • Authorization using HockeyApp logins

Windows Phone 7.5

Deprecated but still available (no Nuget package available -> use the source)

  • Crash reporting and Feedback (works for beta and store apps)

WinRT (Windows 8.1 Store Apps and Windows Phone 8.1 Store Apps)

Nuget PM> Install-Package HockeySDK.WinRT
  • Automatic crash reporting
  • Automatic updates (only for Windows Phone 8.1)
  • Sending feedback to the developers
  • Authorization using HockeyApp logins

WPF

Nuget PM> Install-Package HockeySDK.WPF
  • Automatic crash reporting
  • Sending feedback to the developers

Portable lib (core component)

Nuget PM> Install-Package HockeySDK.Core

A basic API wrapper for the HockeyApp API that supports

  • Handling of crashes
  • Submitting of crashes to the HockeyApp server
  • Checking for newest app version
  • Sending feedback to the developers

Requirements

Before you integrate HockeySDK into your own app, you should add the app to HockeyApp if you haven't already. Read this faq entry on how to do this.

Getting started

Guides to get you started with HockeySDK can be found in the HockeyApp Knowledge Base

There are also Demo Apps on GitHub.

###HockeyApp for Windows Store Apps and Windows Phone Store Apps

###HockeyApp for Windows Phone Silverlight Apps (8.0 and 8.1)

###HockeyApp for Windows WPF Apps

Feedback in WPF

In the WPF SDK there are no UI components for the Feedback-Informations. The SDK offers methods to load Feedbacks from the server by using feedback-tokens. Feedback-tokens must be stored in the client application. Creating a new Feedback:

  1. HockeyClient.Current.CreateFeedbackThread() creates an new IFeedbackThread
  2. feedbackThread.PostFeedbackMessageAsync(MESSAGE, EMAIL, SUBJECT, USERNAME); submits a new feedback message on the selected feedback-thread.
  3. The FeedbackThread is created on the server with submitting the first feedback-message (keep that in mind when storing the feedback-token information)

Using the PCL

You can use the portable library directly - e.g. when implementing your own custom-platform SDK. To get some hints look at the classes implementing IHockeyPlatformHelper and the extension classes e.g. HockeyClientWPFExtensions.

Console app

There is no special SDK for console apps but you can find an example of crashhandling in Hoch.exe (Project HockeyAppForWindowsConsole).

Support

If you have any questions, problems or suggestions, please contact us at [email protected].

Contributor License

You must sign a Contributor License Agreement before submitting your pull request. To complete the Contributor License Agreement (CLA), you will need to submit a request via the form and then electronically sign the CLA when you receive the email containing the link to the document. You need to sign the CLA only once to cover submission to any Microsoft OSS project.

Release notes

All release notes can be found in the project directories

About

SDK to use HockeyApp in Windows and Windows Phone apps.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.8%
  • Other 0.2%