レポートナビゲータからの bot の管理および監視
開発用 Mac 上で、Xcode のレポートナビゲータは、あなたのボットと、サーバ上で実行した統合に関する詳細情報へのアクセスを提供します。レポートナビゲータで、ボットや統合を選択すると、Xcode ワークスペースのエディタ領域での情報を表示することができます。また、編集、削除、およびレポートナビゲータからボットを作成し、開始またはそれらの統合をキャンセルすることができます。
レポートナビゲータでボットを管理
開発用の Mac の Xcode で、[View(表示)] > [Navigator(ナビゲーター)] > [Show Repoort Navigator(レポートナビゲータの表示)] を選択するか、ボットのリストを表示するには、ナビゲーションバーで [Report Navigator(レポートナビゲータ)] ボタンをクリックして下さい。[By Group(グループで)] をクリックするとおのおののボットに集まったステータス情報を表示することができます。
ボットをコントロール-クリックして、ショートカットメニューを表示させます。
- 新しいボットを作成します
- ボットを編集-そのスキーム、名前、スケジュール、アクション、電子メールの受信者、およびテスト用のデバイスを変更することができます。
- ボットを削除-ボットを削除すると、将来の統合アクションを停止し、既存のビルドとアーカイブを削除します。
- すぐにボットの新しい統合を開始-Xcode は、ボットでコンパイルされているまさにそのソースファイルに至るまで、ボットが統合した、生の進捗情報を表示します。
- 現在進行中の統合をキャンセル
ボットビューアでボットの監視と管理
Xcode のレポートナビゲータでボットを選択することで、ボットの統合の概要を表示できます。
ボットの統合結果の要約を表示するには
- レポートナビゲータの上部で、[By Group(グループで)] をクリックします。
- その統合を表示したいボットを選択します。
ステータス情報は、それぞれのボットについて収集されます。
ワークスペースウィンドウのエディタ領域で、ボットビューアは全てのコミットと共に、ビルドエラーと警告、静的解析の問題、およびテストの失敗について、ボットが実行した統合の概要を表示します。
ワークスペースウィンドウのエディタ領域内の一部のボット管理操作を開始できます。
- 統合を開始するには、[Integrate Now(今統合する)] をクリックして下さい。
- ボットを更新するには、[Edit Bot(ボットを編集する)] をクリックして下さい。
エディタエリアで、ボットビューアの[Summary(概要)] 部分では、以下の要素が表示されます。
- ボットの詳細：スキーム、現在の統合状況、平均期間、コミット、テスト、平均の問題、成功回数。今日、今週、または今月の統計情報を表示するボット詳細エリアを構成することができます。
- ビルドの履歴：ビルド時にボットが遭遇したエラー、警告、および静的解析の問題を示す棒グラフ。問題の集計を表示するには、バーをクリックして下さい。
- テストの履歴：ボットが行った成功および失敗したテストケースの数。成功した、失敗したテストの集計を表示するには、バーをクリックします。
統合ビューアでの統合の詳細レビュー
レポートナビゲータで選択することで、統合の詳細を表示することができます。
統合の詳細を表示するには
- レポートナビゲータの上部にある[By Group(グループで)] をクリックします。
- 統合を表示したいボットを選択します。
- ボットの統合がまだ表示されていない場合は、統合を表示するには、ボットの左にある三角形をクリックして下さい。
- 特定の統合を選択します。
- 統合の結果の概要
- エラー、警告、静的解析の問題、およびテストケースで遭遇した失敗の回数
- 該当する場合は、新たな問題のリスト、解決した問題、ビルドサービスの問題
- 該当する場合、ビルド結果エリア、製品のアーカイブをダウンロードするのを許可
- デバイスのテストの概要、すべてのデバイスがテストされ、それらに合格したか失敗したかの一覧表示
- ワークスペースウィンドウのエディタ領域で、テストとそのパスの一覧を表示したり、統合の失敗状態の一覧を表示するには、[Test(テスト)] をクリックして下さい。
- ワークスペースウィンドウのエディタ領域では、[Commit(コミット)] をクリックすると、統合に含まれる新しいコミットの詳細を表示します。コミットは、すべてのコミッターが見ることができるか、個々のコミッターを選択することができます。
- ワークスペースウィンドウのエディタ領域で、統合時に発生したアクションのログを表示するために[Logs(ログ)] をクリックします。ログメッセージ、問題、またはエラーを表示し、特定のメッセージを見つけるために検索フィールドを使用してすべてのログを表示するには、フィルタを使用して下さい。
統合のリストは、既に表示されていない場合は、ボットのそれぞれの下に折りたたまれています。
レポートナビゲータにリスト表示されている各統合の右側には、Xcode はエラー、警告、静的解析の問題、または統合の失敗があったかどうかを示すアイコンを表示します。一目で、これはすぐにボットの統合の状態にアクセスすることができます。
ワークスペースウィンドウのエディタエリアで、統合ビューアは、次の様な情報を表示します。
複数のテストデバイスを使用している場合は、パスを表示したり、各デバイスの失敗状態を表示するにはテストの左にある三角形をクリックします。
あなたのプロジェクトが、パフォーマンステストを実施するように設定されている場合は、パフォーマンステスト結果を表示し、ベースラインを指定することができます。パーフォーマンステストのベースラインを指定すると、テストに価値を追加し、テストがベースライン以下の一定の閾値の外にある場合に統合が失敗するようにします。
"Show modified files(変更したファイルを表示)" ボタンをクリックすると、変更が行われた特定のコードを識別することを可能にする、Xcode の比較ビューでコミットの一部のファイルを表示できます。
ボットが積極的に選択された統合を実行している場合は、エディタは、統合の結果ではなく、そのライブの進行状況を表示します。統合が完了した後に結果が表示されます。
以下のビデオは、WWDC 2014:Xcode 6 での継続的統合 から抜粋した物です。この最初のビデオは、ボットのコミットを分析するため Xcode を使用するプロセスを説明します。
この次のビデオでは、統合での問題を診断するため Xcode を使用するプロセスを説明します。
この最後のビデオは、ベースラインのパフォーマンスレベルを設定する方法など、アプリのパフォーマンステストを実施する方法を示しています。
前：継続的統合を実行するためにボットを設定
次：Web ブラウザからのボットの監視