Menelusuri codebase

Laporkan masalah Lihat sumber Per malam · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Ringkasan produk

Antarmuka penelusuran kode dan penjelajahan sumber Bazel adalah alat berbasis web untuk menelusuri repositori kode sumber Bazel. Anda dapat menggunakan fitur-fitur ini untuk menavigasi di antara repositori, cabang, dan . Anda juga bisa melihat histori, perbedaan, dan informasi kesalahan.

Memulai

Untuk mengakses antarmuka penelusuran kode dan penjelajahan sumber, buka https://source.bazel.build di browser web.

Layar utama akan muncul. Layar ini berisi komponen berikut:

  1. Toolbar Breadcrumb. {i>Toolbar<i} ini menampilkan lokasi Anda saat ini di repositori dan memungkinkan Anda untuk berpindah dengan cepat ke lokasi lain seperti repositori, atau lokasi lain dalam repositori, seperti file, cabang, dan melakukan commit.

  2. Daftar repositori yang dapat Anda jelajahi.

Di bagian atas layar adalah kotak penelusuran. Anda dapat menggunakan kotak ini untuk menelusuri file dan kode tertentu.

Bekerja dengan repositori

Membuka repositori

Untuk membuka repositori, klik namanya dari layar utama.

Atau, Anda dapat menggunakan {i>toolbar<i} Breadcrumb untuk menelusuri {i>specificrepository<i}. {i>Toolbar<i} ini menampilkan lokasi Anda saat ini di repositori dan memungkinkan Anda untuk berpindah dengan cepat ke lokasi lain seperti repositori, atau lokasi lain dalam repositori, seperti file, cabang, dan melakukan commit.

Beralih repositori

Untuk beralih ke repositori lain, pilih repositori dari toolbar Breadcrumb.

Melihat repositori di commit tertentu

Untuk melihat repositori pada commit tertentu:

  1. Dari tampilan repositori, pilih file.
  2. Dari toolbar Breadcrumb, buka menu Branch.
  3. Di submenu yang muncul, klik Commit.
  4. Pilih commit yang ingin Anda lihat.

Antarmuka kini menampilkan repositori seperti yang ada pada commit tersebut.

Membuka cabang, commit, atau tag

Secara {i>default<i}, antarmuka penelusuran kode dan penjelajahan sumber membuka repositori untuk untuk cabang default. Untuk membuka cabang yang berbeda, dari {i>toolbar<i} Breadcrumb, Klik menu Branch/Commit/Tag. Sebuah submenu akan terbuka, memungkinkan Anda untuk memilih menggunakan nama cabang, nama tag, atau melalui kotak penelusuran.

  • Untuk memilih cabang menggunakan nama cabang, pilih Branch, lalu klik nama cabang.
  • Untuk memilih cabang menggunakan nama tag, pilih Tag dan lalu klik nama tagnya.
  • Untuk memilih cabang menggunakan ID commit, pilih Commit lalu klik ID commit.
  • Untuk menelusuri cabang, commit, atau tag, pilih item yang sesuai dan ketik istilah penelusuran di kotak penelusuran.

Bekerja dengan file

Saat Anda memilih repositori dari layar utama, layar akan berubah untuk menampilkan adalah tampilan repositori tersebut. Jika file README sudah ada, isinya akan muncul di {i>file<i} Anda, yang terletak di sisi kanan layar. Jika tidak, daftar file dan folder repositori akan muncul. Di sisi kiri layar adalah pohon tampilan file dan folder repositori. Anda dapat menggunakan pohon ini untuk menjelajahi dan membuka file tertentu.

Perhatikan bahwa saat Anda melihat repositori, toolbar Breadcrumb sekarang memiliki tiga komponen:

  • Menu Repository, tempat Anda dapat memilih repositori yang berbeda
  • Menu Branch/Commit/Tag, yang memungkinkan Anda memilih cabang tertentu, tag, atau commit
  • Kotak File path, yang menampilkan nama file atau folder saat ini dan jalur yang sesuai

Membuka file

Anda dapat membuka file dengan menjelajahi direktorinya dan memilihnya. Pandangan repositori diperbarui untuk menampilkan isi file di panel file, dan lokasinya dalam repositori di panel hierarki.

Melihat perubahan file

Untuk melihat perubahan file:

  1. Dari tampilan repositori, pilih file.
  2. Klik BLAME, yang terletak di pojok kanan atas.

Panel {i>file<i} diperbarui untuk menampilkan siapa yang membuat perubahan pada file dan kapan.

Melihat histori perubahan

Untuk melihat histori perubahan file:

  1. Dari tampilan repositori, pilih file.
  2. Klik HISTORI yang terletak di pojok kanan atas. Panel Histori perubahan akan muncul, yang menampilkan commit untuk file ini.

Lihat peninjauan kode

Untuk peninjauan kode Gerrit, Anda dapat membuka alat ini langsung dari panel Change History.

Untuk melihat peninjauan kode suatu file:

  1. Dari tampilan repositori, pilih file.
  2. Klik HISTORI yang terletak di pojok kanan atas. Panel Histori Perubahan muncul, yang menunjukkan commit untuk file ini.
  3. Arahkan kursor ke commit. Tombol Lainnya (tiga titik vertikal) akan muncul.
  4. Klik tombol Lainnya.
  5. Pilih Lihat peninjauan kode.

Alat Gerrit Code Review akan terbuka di jendela browser baru.

Membuka file pada commit tertentu

Untuk membuka file pada commit tertentu:

  1. Dari tampilan repositori, pilih file.
  2. Klik HISTORI yang terletak di pojok kanan atas. Panel Histori Perubahan muncul, yang menunjukkan commit untuk file ini.
  3. Arahkan kursor ke commit. Tombol LIHAT akan muncul.
  4. Klik tombol LIHAT.

Membandingkan file dengan commit yang berbeda

Untuk membandingkan file pada commit yang berbeda:

  1. Dari tampilan repositori, pilih file. Untuk membandingkan antara dua {i>commit<i} yang berbeda, pertama-tama buka file pada {i>commit<i} tersebut.
  2. Arahkan kursor ke commit. Tombol berbeda akan muncul.
  3. Klik tombol diff.

Panel {i>file<i} diperbarui untuk menampilkan perbandingan secara berdampingan antara keduanya . Commit yang terlama dari kedua commit tersebut selalu berada di sebelah kiri.

Di panel Change History, kedua commit disorot, dan label menunjukkan jika commit ditampilkan di sebelah kiri atau kanan.

Untuk mengubah salah satu file, arahkan kursor ke commit di panel Change History. Lalu: klik tombol Left atau Right untuk membuka commit pada sisi kiri atau kanan diff.

Referensi silang penjelajahan

Cara lain untuk menjelajahi repositori sumber adalah melalui penggunaan referensi. Referensi ini muncul secara otomatis sebagai {i>hyperlink<i} dalam file sumbernya.

Agar referensi silang lebih mudah diidentifikasi, klik Referensi Lintas, yang terletak di sudut kanan atas. Opsi ini menampilkan garis bawah di bawah semua referensi silang dalam file.

Catatan: Jika Cross References berwarna abu-abu, hal ini menunjukkan bahwa referensi silang tidak tersedia untuk file tersebut.

Klik referensi silang untuk membuka panel Referensi Silang. Panel ini berisi dua bagian:

  • Bagian Definisi, yang mencantumkan file atau file yang menentukan referensi
  • Bagian Referensi, yang mencantumkan file yang juga memiliki referensi muncul

Kedua bagian menampilkan nama {i>file<i}, serta baris atau beberapa baris yang berisi referensi. Untuk membuka file dari panel {i>Cross Reference<i}, klik entri nomor baris. File akan muncul di bagian baru dalam panel, sehingga Anda dapat terus menjelajahi file dengan tetap menyimpan file aslinya terlihat.

Anda bisa terus menelusuri referensi silang menggunakan panel Referensi Silang, cukup seperti yang Anda lakukan di panel {i>File<i}. Saat Anda melakukannya, panel akan menampilkan jejak breadcrumb, yang dapat Anda gunakan untuk berpindah-pindah di antara berbagai referensi silang.

Anda dapat mencari file atau cuplikan kode tertentu menggunakan kotak pencarian yang terletak di bagian atas layar. Penelusuran selalu berhadapan dengan cabang default.

Semua penelusuran menggunakan ekspresi reguler RE2 secara {i>default<i}. Jika Anda tidak ingin menggunakan ekspresi reguler, sertakan penelusuran Anda dalam tanda kutip ganda ( " ).

Catatan: Untuk menelusuri file tertentu dengan cepat, tambahkan garis miring terbalik di depan tanda titik, atau mengapit seluruh nama file dengan tanda kutip.

foo\.java
"foo.java"

Anda dapat menyaring penelusuran menggunakan filter berikut.

Filter Opsi lain Deskripsi Contoh
lang: bahasa: Lakukan pencocokan persis berdasarkan bahasa file. pengujian lang:java
file: filepath:
jalur:
f:
kasus:ya Buat huruf besar/kecil penelusuran. Secara default, penelusuran tidak peka huruf besar/kecil. case:yes Hello World (Halo Dunia)
: Telusuri nama kelas. class:MainClass
{i>function<i}: func: Telusuri nama fungsi. function:print
- Menegasikan istilah dari penelusuran. halo -dunia
\ Escape karakter khusus, seperti ., \, atau (. lari\(\)
"[istilah]" Lakukan penelusuran literal. &quot;class:main&quot;

Dukungan Tambahan

Untuk melaporkan masalah, klik tombol Masukan yang muncul di bagian atas pojok kanan layar dan ketik masukan Anda dalam formulir yang disediakan.