プロダクトの概要
Bazel のコード検索とソース ブラウジング インターフェースは、Bazel ソースコード リポジトリを参照するためのウェブベースのツールです。これらの機能を使用して、さまざまなリポジトリ、ブランチ、ファイルを移動できます。履歴、差分、非難情報を表示することもできます。
使用を開始する
ソースコード検索とソース ブラウジング インターフェースにアクセスするには、ウェブブラウザで https://source.bazel.build を開きます。
メイン画面が表示されます。この画面には次のコンポーネントが含まれています。
パンくずリスト ツールバー。このツールバーにはリポジトリ内の現在の場所が表示され、すばやく別の場所(別のリポジトリなど)や、リポジトリ内の別の場所(ファイル、ブランチ、または commit など)へ移動できます。
ブラウジングできるリポジトリのリスト。
画面上部に検索ボックスがあります。このボックスを使用して、特定のファイルやコードを検索できます。
リポジトリの操作
リポジトリを開く
リポジトリを開くには、メイン画面で名前をクリックします。
または、パンくずリスト ツールバーを使用して、特定のリポジトリを参照することもできます。このツールバーにはリポジトリ内の現在の場所が表示され、すばやく別の場所(別のリポジトリなど)や、リポジトリ内の別の場所(ファイル、ブランチ、または commit など)へ移動できます。
リポジトリを切り替える
別のリポジトリに切り替えるには、[パンくずリスト] ツールバーからリポジトリを選択します。
特定の commit のリポジトリを表示する
特定の commit のリポジトリを表示するには:
- リポジトリのビューで、ファイルを選択します。
- パンくずリスト ツールバーで [ブランチ] メニューを開きます。
- 表示されたサブメニューで [コミット] をクリックします。
- 表示する commit を選択します。
インターフェースには、その commit に存在していたリポジトリが表示されます。
ブランチ、commit、またはタグを開く
デフォルトでは、コード検索とソース閲覧のインターフェースは、デフォルトのブランチへのリポジトリを開きます。別のブランチを開くには、パンくずリスト ツールバーで [ブランチ/commit/タグ] メニューをクリックします。サブメニューが開き、ブランチ名、タグ名、または検索ボックスを使用してブランチを選択できます。
- ブランチ名を使用してブランチを選択するには、[ブランチ] を選択してからブランチの名前をクリックします。
- タグ名を使用してブランチを選択するには、[タグ] を選択して、タグ名をクリックします。
- commit ID を使用してブランチを選択するには、[commit] を選択してから commit ID をクリックします。
- ブランチ、commit、またはタグを検索するには、対応するアイテムを選択し、検索ボックスに検索キーワードを入力します。
ファイルを操作する
メイン画面からリポジトリを選択すると、画面が変わり、そのリポジトリのビューが表示されます。README ファイルがある場合は、画面右側のファイルペインに表示されます。それ以外の場合は、リポジトリのファイルとフォルダのリストが表示されます。画面の左側には、リポジトリのファイルとフォルダのツリービューが表示されます。このツリーを使用すると、特定のファイルを参照して開くことができます。
リポジトリを表示しているときに、パンくずリスト ツールバーに次の 3 つのコンポーネントがあることに注意してください。
- [リポジトリ] メニュー。さまざまなリポジトリを選択できます。
- [ブランチ / commit / タグ] メニュー。特定のブランチ、タグ、commit を選択できます。
- [File path] ボックス。現在のファイルまたはフォルダの名前と、対応するパスが表示されます。
ファイルを開く
ファイルを開くには、ディレクトリを参照して選択します。リポジトリのビューが更新され、ファイルペインにファイルの内容と、ツリーペインにリポジトリ内の場所が表示されます。
ファイルの変更を表示
ファイルの変更を表示するには:
- リポジトリのビューで、ファイルを選択します。
- 右上にある [BLAME] をクリックします。
ファイルペインが更新され、誰がいつファイルを変更したかが表示されます。
変更履歴の表示
ファイルの変更履歴を表示するには:
- リポジトリのビューで、ファイルを選択します。
- 右上にある [HISTORY] をクリックします。[変更履歴] ペインが開き、このファイルの commit が表示されます。
コードレビューを見る
Gerrit のコードレビューでは、[変更履歴] ペインからツールを直接開くことができます。
ファイルのコードレビューを表示するには:
- リポジトリのビューで、ファイルを選択します。
- 右上にある [HISTORY] をクリックします。[変更履歴] ペインが開き、このファイルの commit が表示されます。
- commit にカーソルを合わせます。その他ボタン(縦に 3 つ並んだ点)が表示されます。
- [展開] ボタンをクリックします。
- [コードレビューを表示] を選択します。
Gerrit コードレビュー ツールが新しいブラウザ ウィンドウで開きます。
特定の commit 時にファイルを開く
特定の commit でファイルを開くには:
- リポジトリのビューで、ファイルを選択します。
- 右上にある [HISTORY] をクリックします。[変更履歴] ペインが開き、このファイルの commit が表示されます。
- commit にカーソルを合わせます。[表示] ボタンが表示されます。
- [表示] ボタンをクリックします。
ファイルを別の commit と比較する
別の commit でファイルを比較するには:
- リポジトリのビューで、ファイルを選択します。2 つの異なる commit を比較するには、最初にその commit のファイルを開きます。
- commit にカーソルを合わせます。[DIFF] ボタンが表示されます。
- [DIFF] ボタンをクリックします。
ファイルペインが更新され、2 つのファイルを並べて比較できます。2 つの commit のうち古いものは常に左側にあります。
[変更履歴] ペインで両方の commit がハイライト表示され、commit が左側と右側のどちらに表示されているかを示すラベルが表示される。
いずれかのファイルを変更するには、[変更履歴] ペインで commit にカーソルを合わせます。次に、[左] ボタンまたは [右] ボタンをクリックして、差分の左側または右側に commit を開きます。
相互参照を参照する
ソース リポジトリを参照する別の方法として、相互参照を使用できます。これらの参照は、特定のソースファイル内にハイパーリンクとして自動的に表示されます。
相互参照を簡単に区別するには、右上にある [相互参照] をクリックします。このオプションを使用すると、ファイル内のすべての相互参照の下に下線が表示されます。
注: [相互参照] がグレー表示されている場合は、そのファイルでは相互参照が利用できないことを示します。
[Cross Reference] をクリックして [Cross Reference] ペインを開きます。このペインには次の 2 つのセクションがあります。
- 参照を定義するファイルを一覧表示する [Definition] セクション
- [参照] セクション(この参照が含まれるファイルの一覧)
どちらのセクションにも、ファイルの名前と、参照を含む行が表示されます。[相互参照] ペインからファイルを開くには、行番号のエントリをクリックします。ペインの新しいセクションにファイルが表示され、元のファイルを表示したままでファイルのブラウジングを続行できます。
[ファイル] ペインと同様に、[相互参照] ペインで引き続き相互参照を参照できます。ペインにはパンくずリストが表示され、これを使用して異なる相互参照間を移動できます。
コードの検索
画面上部の検索ボックスを使用して、特定のファイルやコード スニペットを検索できます。検索は常にデフォルトのブランチに対して行われます。
すべての検索ではデフォルトで RE2 正規表現が使用されます。正規表現を使用しない場合は、検索を二重引用符(" )で囲みます。
注: 特定のファイルをすばやく検索するには、ピリオドの前にバックスラッシュを追加します。または、ファイル名全体を引用符で囲みます。
foo\.java
"foo.java"
次のフィルタを使用して検索を絞り込むことができます。
フィルタ | その他の方法 | 説明 | サンプル |
---|---|---|---|
lang: | language: | ファイルの言語で完全一致を実行します。 | lang:java テスト |
file: | filepath: path: f: |
||
case:yes | 検索で大文字と小文字が区別されるようにします。デフォルトでは、検索で大文字と小文字は区別されません。 | case:yes Hello World | |
class: | クラス名を検索します。 | class:MainClass | |
function: | func: | 関数名を検索します。 | 関数:print |
- | 検索から語句を反転します。 | Hello World | |
\ | 特殊文字(.、\、(.)など)をエスケープします。 | 実行\(\) | |
「[検索キーワード]」 | リテラル検索を実行する。 | 「class:main」 |
その他のサポート
問題を報告するには、画面の右上にある [フィードバック] ボタンをクリックし、フォームにフィードバックを入力します。