Menelusuri codebase

Laporkan masalah Lihat sumber

Ringkasan produk

Antarmuka penelusuran dan penjelajahan sumber Bazel adalah alat berbasis web untuk menjelajahi repositori kode sumber Bazel. Anda dapat menggunakan fitur-fitur ini untuk bernavigasi di antara repositori, cabang, dan file yang berbeda. Anda juga dapat melihat histori, perbedaan, dan menyalahkan.

Memulai

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

Layar utama akan muncul. Layar ini berisi komponen berikut:

  1. Toolbar Breadcrumb. Toolbar ini menampilkan lokasi Anda saat ini di repositori dan memungkinkan Anda berpindah dengan cepat ke lokasi lain seperti repositori lain, atau lokasi lain dalam repositori, seperti file, cabang, atau commit.

  2. Daftar repositori yang dapat Anda jelajahi.

Di bagian atas layar terdapat 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 toolbar Breadcrumb untuk mencari repositori tertentu. Toolbar ini menampilkan lokasi Anda saat ini di repositori dan memungkinkan Anda berpindah dengan cepat ke lokasi lain seperti repositori lain, atau lokasi lain dalam repositori, seperti file, cabang, atau commit.

Beralih repositori

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

Melihat repositori pada 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 di commit tersebut.

Membuka cabang, commit, atau tag

Secara default, penelusuran kode dan antarmuka penjelajahan sumber membuka repositori ke cabang default. Untuk membuka cabang lain, dari toolbar Breadcrumb, klik menu Branch/Commit/Tag. Submenu terbuka, memungkinkan Anda memilih cabang 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, lalu klik nama tag.
  • Untuk memilih cabang menggunakan ID commit, pilih Commit, lalu klik ID commit.
  • Untuk menelusuri cabang, commit, atau tag, pilih item yang sesuai dan istilahkan istilah penelusuran di kotak penelusuran.

Bekerja dengan file

Saat Anda memilih repositori dari layar utama, layar akan berubah untuk menampilkan tampilan repositori tersebut. Jika file README ada, kontennya akan muncul di panel file yang terletak di sisi kanan layar. Jika tidak, daftar file dan folder repositori akan muncul. Di sebelah kiri layar adalah tampilan hierarki file dan folder repositori. Anda dapat menggunakan pohon ini untuk menjelajahi dan membuka file tertentu.

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

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

Membuka file

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

Lihat perubahan file

Untuk melihat perubahan file:

  1. Dari tampilan repositori, pilih file.
  2. Klik LACAK, yang terletak di sudut kanan atas.

Panel file 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 ulasan kode

Untuk peninjauan kode Gerrit, Anda dapat membuka alat langsung dari panel Histori Perubahan.

Untuk melihat peninjauan kode sebuah 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.
  3. Arahkan kursor ke commit. Tombol More (tiga titik vertikal) akan muncul.
  4. Klik tombol Lainnya.
  5. Pilih Lihat peninjauan kode.

Alat Tinjauan Kode Gerrit 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 akan muncul, yang menampilkan commit untuk file ini.
  3. Arahkan kursor ke commit. Tombol VIEW 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 dari dua commit yang berbeda, buka file pada commit tersebut terlebih dahulu.
  2. Arahkan kursor ke commit. Tombol DIFF akan muncul.
  3. Klik tombol DIFF.

Panel file akan diperbarui untuk menampilkan perbandingan secara berdampingan di antara dua file. Yang pertama di antara dua commit selalu berada di sebelah kiri.

Di panel Histori Perubahan, kedua commit ditandai, dan label menunjukkan apakah commit ditampilkan di sebelah kiri atau kanan.

Untuk mengubah salah satu file, arahkan kursor ke commit di panel Histori Perubahan. Lalu, klik tombol Kiri atau Kanan agar commit terbuka di sisi kiri atau kanan diff.

Referensi silang penjelajahan

Cara lain untuk menjelajahi repositori sumber adalah melalui penggunaan referensi silang. Referensi ini muncul secara otomatis sebagai hyperlink dalam file sumber tertentu.

Agar referensi silang lebih mudah diidentifikasi, klik Cross References, yang terletak di pojok 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 Lintas Referensi. Panel ini berisi dua bagian:

  • Bagian Definition, yang mencantumkan file atau beberapa file yang menentukan referensi
  • Bagian References, yang mencantumkan file tempat referensi juga muncul

Kedua bagian menampilkan nama file, serta baris atau beberapa baris yang berisi referensi. Untuk membuka file dari panel Cross Reference, klik entri nomor baris. File muncul di bagian baru panel, yang memungkinkan Anda terus menjelajahi file tanpa mengubah file aslinya.

Anda dapat terus menjelajahi referensi silang menggunakan panel Cross Reference, seperti yang dapat Anda lakukan di panel File. Saat Anda melakukannya, panel menampilkan jejak breadcrumb, yang dapat digunakan untuk menavigasi di antara referensi silang yang berbeda.

Anda dapat menelusuri file atau cuplikan kode tertentu menggunakan kotak penelusuran yang ada di bagian atas layar. Penelusuran selalu bertentangan dengan cabang default.

Semua penelusuran menggunakan ekspresi reguler RE2 secara default. Jika Anda tidak ingin menggunakan ekspresi reguler, apit penelusuran Anda dalam tanda kutip ganda ( " ).

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

foo\.java
"foo.java"

Anda dapat menyaring penelusuran menggunakan filter berikut.

Filter Opsi lainnya Deskripsi Contoh
bahasa: bahasa: Melakukan pencocokan persis berdasarkan bahasa file. pengujian lang:java
file: filepath:
jalur:
f:
kasus:ya Membuat huruf besar/kecil penelusuran. Secara default, penelusuran tidak peka huruf besar/kecil. case:yes Halo Dunia
kelas: Telusuri nama kelas. class:MainClass
fungsi: fungsi: Telusuri nama fungsi. function:cetak
- Menegasikan istilah dari penelusuran. halo -dunia
\ Meng-escape karakter khusus, seperti ., \, atau (. jalankan\(\)
"[jangka waktu]" Lakukan penelusuran literal. "class:main"

Dukungan Tambahan

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