[ソース管理] パネル

Studio の [ソース管理] パネル。開いているプロジェクトのコミット、プッシュ、プル、ブランチ管理など、完全な Git ワークフローを提供します。

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

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

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

パネル構造とナビゲーション

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

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

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

[変更] セクション

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

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

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

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

Use the Message field to write your commit message. To have Autopilot write it, select Generate commit message. Autopilot uses your staged changes, or all your changes if none are staged. Generate commit message is available when generative AI features are enabled and Studio is connected to Orchestrator.

After writing your message, select Commit or use the CTRL + Enter keyboard shortcut. If no files are explicitly staged when you commit, all changes are staged automatically.

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

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

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

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

• [プル]、[プッシュ]、[すべてのリモートを取得] の操作にアクセスする
• [すべてステージング] を選択して変更をステージングする
• [ブランチを管理] ウィンドウを開く
• [ Stash Changes ] ダイアログまたは [ Manage Stashes ] ウィンドウを開きます。「 Stashing Changes」を参照してください。

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

変更の隠し込み

ブランチを切り替えたり、未完了の作業の上に緊急の修正を行ったりしても、Studio を離れてサードパーティの Git クライアントを使用する必要がなくなりました。[その他のオプション] メニューから [変更を隠す] を選択して作業ツリーを脇に置いておくか、[隠し場所を管理] を選択して作業ツリーを元に戻します。

[Stash Changes] ダイアログには、現在の作業ツリーが保存され、次の 2 つのオプションが表示されます。

• 隠し場所のメッセージ (任意) - 後で隠し場所を特定するためのメモです。
• 追跡されていないファイルを含める - Git がまだ追跡していないファイルも隠します。

[ 隠し] を選択して作業ツリーを保存するか、[ キャンセル ] を選択して保存せずに閉じます。

[ 隠し場所を管理 ] ウィンドウには、取っておいたすべての隠し場所、そのメッセージ、作成日、および次の 3 つのアクションが表示されます。

• 適用 - スタッシュを適用し、リストに保持します。
• ポップ - スタッシュを適用し、リストから削除します。
• ドロップ - スタッシュを適用せずに削除します。これにより、最初に確認を求められます : 「この隠し場所を削除してもよろしいですか?このアクションは元に戻せません。」

ステージングされた変更があったり、触れるファイルにコミットされていない変更があったりして、スタッシュをきれいに適用できない場合は、何も変更されず、スタッシュは保持され、どちらがどちらであったかを示すメッセージが表示されます。たとえば、コミットされていない変更があるファイルに接触するスタッシュを適用すると 、「変更されたファイルの一部にコミットされていない変更があるため、スタッシュを適用できませんでした。何も変更されず、隠し場所は保管されていました。これらの変更をコミットするか破棄して、もう一度やり直してください。」

Studio の外部でスタッシュ リストが変更された場合は、[ スタッシュを管理 ] ウィンドウでリストが更新され、古いリストに基づいて操作するのではなく、リトライするように求められます。

[グラフ] セクション

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

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

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

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

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

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

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

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

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

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

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