[ソース管理] パネル

[ソース管理] パネルでは、Studio 内で完全な Git ワークフローを利用できます。このパネルは、Git リポジトリに属するプロジェクトが開いているときは常に利用することができ、デザイナーの左側に他のパネル ([エクスプローラー]、[アクティビティ]、[スニペット] など) と一緒にドッキングされています。

[ソース管理] パネルは Git リポジトリでのみ機能します。TFS および SVN で管理されているプロジェクトは、引き続き Backstage の [チーム] タブから管理します。

パネルを初めて開くと、ローカル Git リポジトリを初期化するように求める指示が表示されます。この手順は必須であり、[リポジトリを初期化] ボタンを選択すると自動的に実行されます。

このパネルには、次の 2 つの異なるセクションが含まれます。

1. 変更: ワーク ツリーで変更、追加、削除されたか、名前が変更されたファイルがすべて表示されます。コミット用のコントロールがホストされています。
2. グラフ: リポジトリのコミット履歴がインタラクティブで視覚的なグラフとして表示されます。

各セクション ヘッダーをクリックすると、対応するセクションが折りたたみまたは展開されます。セクションが折りたたまれている場合は、ヘッダーに、そのセクションに含まれる項目の数が表示されるため、アクティビティを一目で監視できます。

[変更] セクション

[変更] セクションには、保留中のファイルのすべての変更が、ステージング済みのグループとステージングが解除されたグループに分けて表示されます。

各ファイル エントリには、ステータスを表す文字 (M – 変更、A – 追加、D – 削除、R – 名前変更、U – 未追跡) が色分けされて表示されます。

ファイルにカーソルを合わせるか、ファイルを右クリックすると、ファイルに固有の以下のオプションにアクセスできます。

• ファイルを開く: ファイルをデザイナー パネルで開きます。
• 変更を破棄: ファイルを最後にコミットされたステートに戻します。
• ステージングまたはステージングを解除。
• .gitignore に追加: ファイルを今後の追跡から除外します。
• ファイル エクスプローラーで表示: マシン上のファイルの場所を開きます。
• エクスプローラー ビューで表示: [エクスプローラー] パネルを開きます。

コミット メッセージを入力するには、[メッセージ] フィールドを使用します。メッセージを入力したら、[コミット] を選択するか、Ctrl + Enter のキーボード ショートカットを使用します。コミットしたときにファイルが明示的にステージングされない場合、変更はすべて自動的にステージングされます。

その他のオプションにアクセスするには、[コミット] ボタンの横にある矢印を選択します。

• コミット: ステージングされた変更をローカルにコミットします。
• コミット (修正): ステージングされた変更を最新のコミットに追加します。
• コミットしてプッシュする: コミットしてからリモート ブランチにプッシュします。
• コミットして同期: ステージングされた変更をコミットしてから、プルおよびプッシュしてリモート ブランチと同期します。

セクションを再読み込みするには、[変更] セクションの上部にある [更新] ボタンを選択します。

[その他のオプション] ボタンを選択して以下の操作を行うこともできます。

• [プル]、[プッシュ]、[すべてのリモートを取得] の操作にアクセスする
• [すべてステージング] を選択して変更をステージングする
• [ブランチを管理] ウィンドウを開く

ツールバーのブランチ名の横にある ahead/behind のバッジは、ローカル ブランチがリモート追跡ブランチより何コミット分 ahead (先行) か、behind (遅延) かを示します。

[グラフ] セクション

[グラフ] セクションには、リポジトリのコミット履歴が視覚的な複数レーンのグラフとして表示されます。最大で 200 件のコミットが表示されます。ブランチ ラベルとタグ ラベル、ブランチを表す色分けされた線、マージ接続を示すベジェ曲線も表示されます。

表示するコミットを切り替えるには、ブランチ フィルター ボタンを選択します。

• Auto: 現在のブランチへのコミットを表示します。
• All: すべてのブランチへのコミットを表示します。
• 特定のブランチへのコミットのみを表示します。

別のボタンを使用すると、以下のような機能にアクセスできます。

• すべてのリモートを取得: 変更をマージせずに、リモートの変更をダウンロードします。
• プル: リモートの変更をダウンロードして現在のブランチにマージします。
• プッシュ: コミット済みのローカルの変更をリモート ブランチにアップロードします。

専用の [更新] ボタンからセクションを更新することもできます。

[グラフ] セクションの各行は 1 つのコミットを表します。コミットにカーソルを合わせると、コミットの作成者、日付、メッセージ、および省略された SHA が表示されます。完全な SHA をクリップボードにコピーすることもできます。

変更されたファイルは、[変更されたファイル] リストに表示されます。このリストからファイルを右クリックして、[以前のコミットと比較] を選択すると、デザイナーで差分ビューが開きます。

コミットを右クリックすると、以下のオプションにアクセスできます。

• コミットのチェックアウト: 選択したコミットでリポジトリをチェックアウトします。
• ブランチをチェックアウト: 選択したコミットに関連付けられているブランチに切り替えます。
• コミットをチェリーピック: コミットの変更を現在のブランチに適用します。
• コミットを元に戻す: 選択したコミットによって導入された変更を元に戻す新しいコミットを作成します。
• ソフトにリセット: ブランチ ポインターを選択したコミットに移動し、後続のすべての変更をステージングします。
• ハードリセット: ブランチポインタを選択したコミットに移動し、以降のすべての変更を破棄します。
• ワーク ツリーと比較: コミットと現在のローカル ファイルの差分を開きます。
• 以前のコミットと比較: コミットとその親コミットの差分を開きます。
• コミットの SHA をコピー: コミットの完全な SHA をクリップボードにコピーします。

[ソース管理] パネルの任意の場所 ([変更] 領域、または [グラフ] 領域の展開されたコミット行) をクリックすると、差分ビューが開きます。