カテゴリー: HockeyApp

今回は、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との連携についてです。

アプリの動作を実機で確認したい場合、個人レベルならVSから実機に接続してのリモートデバッグでも十分ですが、ある程度の規模で開発している場合（例えば、複数種類の実機で確認するなど）、実機展開に手間がかかったり、平行で確認するとなるとその台数分デバッグ環境が必要になります。
また、利用状況（「アプリがどんな環境で実行されているか」「利用者からフィードバックが欲しい」など）とか、アプリがクラッシュしたときのデバッグ情報が欲しいということもあります。
こういった内容をサポートしてくれるサービスとして、HockeyApp(https://www.hockeyapp.net/)というものがあります。
単体で利用することもできますが、VSTSのビルドと連携させることも可能です。
２つのアプリケーションまでは無料で利用できますので、個人でも気軽にお試しできます。

VSTSとの連携を行う前に、HockeyApp側にアプリ登録が必要になります。
初期画面(Dashboard)にある「New App」をクリックすると、アプリの登録画面が表示されます。




ここにアプリのファイルをドロップすることで登録できるようになっていますが、今回はVSTSとの連携なので、一番下の「manually」部分をクリックします。

次の画面でアプリ情報を入力します。


・Platform
　アプリの実行環境を選択します。


・Release Type
　リリースの扱いを選択します。但し選択肢に「store」がありますが、さすがにここからはstoreに展開はできませんw。


・Title
　HockeyApp内での表示名を入力します。
・Bundle Identifier
　ビルド時に指定するIdentifierですが、「証明書発行　その２」(http://blackssi.cocolog-nifty.com/blog/2016/11/macxcodexamar-2.html)でBundle IDに指定した内容を入力します。
　（VSのプロジェクト設定だと、「iOS Application」にある「Identifier」の内容（青枠のところ）になります）


すべて入力したら、「save」ボタンをクリックします。すると、登録アプリの概要を表示する画面に移ります。


この画面に表示されている「App ID」（32桁の16進数：キー情報なので、ここでは消してます）をVSTSでHockeyAppとの連携で使用します。

続いてはVSTSとの連携についてです。