MacやXcodeを知らないやつが始めるXamarinアプリ開発 – HockeyApp SDKの使い方

今回は、HockeyApp SDKの使い方についてです。
SDKはHockeyAppサイト(https://hockeyapp.net/releases/)に対象OSごとに分かれてダウンロードできるようになっています。
Xamarinの場合、安定版(Stable)は他のOSと同様で個別ダウンロードですが、PreRelease版はNuGetに対応しています。
PCLプロジェクトと個別プロジェクト（Android／iOS／UWP）プロジェクトのそれぞれに対して、"HockeySDK.Xamarin"をインストールします。

次は個別機能の使い方です。若干使いずらいところですが、対象プラットフォームごとに記述が微妙に異なります。
とりあえずはCrash Report／User Metric／Custom Eventsの３点についてまとめてみます。
※今回、UWPについては省略します。
[iOS]
〇Crash Report
AppDelegate.csに「using HockeyApp.iOS」と、FinishedLaunching()に以下のロジック（青枠部分）を追加します。
（Xamarin Test Cloud関連がありますが、ここでは無視してください(;^ω^)）

これだけで、クラッシュ時のレポートがHockeyAppサイトに上げれるようになります。
（クラッシュ後の再起動時に、こんな画面が表示されます）


HockeyAppサイトでは、こんな感じで取得されます。


クラッシュイベントをクリックすると、以下のような詳細情報が表示されます。

〇User Metrics
Crash Reportのロジックで自動的に取得されます。取得したくない場合は、StartManager()の前に「manager.DisableMetricsManager = true;」を追加します。

〇Custom Events
基本的にPCLプロジェクト側にロジックを実装することになると思います（「何かのボタンをクリックした」とか）。
イベントを発生させたい部分に「using HockeyApp」と「MetricsManager.TrackEvent("[イベント名]")」を追加します。
※イベント名に日本語を使うとうまく動かなかったので、英数字のみで指定したほうがよさそうです。

例えば、ListViewでグループのメンバーリストを表示し、どのメンバーがクリックされたかを取得したい場合、OnSelected()にTrackEvent()を実装します。




ここでは、リスト内の下段にあるローマ字での名前（MemberクラスのUserCounterNameに格納）をカスタムイベント名としています（例：「二村春香」をクリックするとイベント名は"Futamura Haruka"）。

HockeyAppのサイトでは、こんな感じで集計されます（「Event Name」に"Futamura Haruka"があります）。

[Android]
〇Crash Report
MainActivity.csに「using HockeyApp.Android」と、OnCreate()に以下のロジック（青枠部分）を追加します。
※青枠以外はXamarin Test CloudやMetric用なので（略

〇User Metrics
MainActivity.csに「using HockeyApp.Android.Metric」と、OnCreate()に以下のロジック（青枠部分）を追加します。

〇Custom Events
iOSと同じです。

簡単なロジック追加で、HockeyAppの機能（クラッシュレポート／メトリック取得など）が使えるようになるのが実感できるかと思います。
次は、Xamarin Test Cloudとの連携についてです。