Ringkasan produk
Antarmuka penelusuran kode dan penjelajahan sumber Bazel adalah alat berbasis web untuk menjelajahi repositori kode sumber Bazel. Anda dapat menggunakan fitur ini untuk berpindah di antara repositori, cabang, dan file yang berbeda. Anda juga dapat melihat informasi histori, perbedaan, dan kesalahan.
Memulai
Untuk mengakses antarmuka penelusuran kode dan penjelajahan sumber, buka https://source.bazel.build di browser web Anda.
Layar utama akan muncul. Layar ini berisi komponen berikut:
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.
Daftar repositori yang dapat Anda jelajahi.
Di bagian atas layar terdapat kotak penelusuran. Anda dapat menggunakan kotak ini untuk mencari file dan kode tertentu.
Menangani 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.
Mengganti repositori
Untuk beralih ke repositori lain, pilih repositori dari toolbar Breadcrumb.
Melihat repositori pada commit tertentu
Untuk melihat repositori pada commit tertentu:
- Dari tampilan repositori, pilih file.
- Dari toolbar Breadcrumb, buka menu Branch.
- Di submenu yang muncul, klik Commit.
- Pilih commit yang ingin Anda lihat.
Antarmuka sekarang menampilkan repositori seperti yang ada di commit tersebut.
Membuka cabang, commit, atau tag
Secara default, antarmuka penelusuran kode dan penjelajahan sumber membuka repositori ke cabang default. Untuk membuka cabang lain, dari toolbar Breadcrumb, klik menu Branch/Commit/Tag. Submenu akan terbuka, sehingga Anda dapat 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 ketik 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 sudah ada, isinya akan muncul di panel file, yang terletak di sisi kanan layar. Jika tidak, daftar file dan folder repositori akan muncul. Di sisi kiri layar terdapat tampilan hierarki file dan folder repositori. Anda bisa menggunakan hierarki ini untuk mencari 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, tempat Anda dapat memilih cabang, tag, atau commit tertentu
- Kotak File path, yang menampilkan nama file atau folder saat ini beserta jalur yang sesuai
Membuka file
Anda dapat membuka file dengan menelusuri direktorinya dan memilihnya. Tampilan repositori diperbarui untuk menampilkan konten file di panel file, dan lokasinya di repositori di panel hierarki.
Melihat perubahan file
Untuk melihat perubahan file:
- Dari tampilan repositori, pilih file.
- Klik BLAME, yang terletak di pojok kanan atas.
Panel file diperbarui untuk menampilkan siapa yang membuat perubahan pada file dan kapan.
Melihat histori perubahan
Untuk melihat histori perubahan file:
- Dari tampilan repositori, pilih file.
- Klik RIWAYAT, yang terletak di pojok kanan atas. Panel Change history akan muncul, menampilkan commit untuk file ini.
Lihat peninjauan kode
Untuk peninjauan kode Gerrit, Anda dapat membuka alat tersebut langsung dari panel Histori Perubahan.
Untuk melihat peninjauan kode untuk file:
- Dari tampilan repositori, pilih file.
- Klik RIWAYAT, yang terletak di pojok kanan atas. Panel Change History akan muncul, menampilkan commit untuk file ini.
- Arahkan kursor ke commit. Tombol Lainnya (tiga titik vertikal) akan muncul.
- Klik tombol Lainnya.
- Pilih Lihat peninjauan kode.
Alat Gerrit Code Review akan terbuka di jendela browser baru.
Membuka file di commit tertentu
Untuk membuka file di commit tertentu:
- Dari tampilan repositori, pilih file.
- Klik RIWAYAT, yang terletak di pojok kanan atas. Panel Change History akan muncul, menampilkan commit untuk file ini.
- Arahkan kursor ke commit. Tombol LIHAT akan muncul.
- Klik tombol LIHAT.
Membandingkan file dengan commit yang berbeda
Untuk membandingkan file di commit yang berbeda:
- Dari tampilan repositori, pilih file. Untuk membandingkan dari dua commit yang berbeda, pertama-tama buka file di commit tersebut.
- Arahkan kursor ke commit. Tombol DIFF akan muncul.
- Klik tombol DIFF.
Panel file akan diupdate untuk menampilkan perbandingan secara berdampingan antara kedua file. Yang terlama dari dua commit selalu berada di sebelah kiri.
Di panel Change History, 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 Change History. Kemudian, klik tombol Left atau Right untuk membuka commit di sisi kiri atau kanan operasi.
Menjelajahi referensi silang
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 Referensi Silang yang terletak di sudut kanan atas. Opsi ini menampilkan garis bawah di bawah semua referensi silang dalam file.
Catatan: Jika Referensi Silang berwarna abu-abu, itu menunjukkan bahwa referensi silang tidak tersedia untuk file tersebut.
Klik referensi silang untuk membuka panel Lintas Referensi. Panel ini berisi dua bagian:
- Bagian Definisi, yang mencantumkan file yang menentukan referensi
- Bagian References, yang mencantumkan file tempat referensi juga muncul
Kedua bagian menampilkan nama file, serta baris atau baris yang berisi referensi. Untuk membuka file dari panel Cross Reference, klik entri nomor baris. File akan muncul di bagian panel yang baru, sehingga Anda dapat terus menjelajahi file sambil mempertahankan tampilan file asli.
Anda dapat terus menjelajahi referensi silang menggunakan panel Cross Reference, seperti yang dapat Anda lakukan di panel File. Jika Anda melakukannya, panel akan menampilkan jejak breadcrumb, yang dapat Anda gunakan untuk berpindah di antara referensi silang yang berbeda.
Menelusuri kode
Anda dapat menelusuri file atau cuplikan kode tertentu menggunakan kotak penelusuran yang terletak 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, masukkan penelusuran Anda dalam tanda kutip ganda ( " ).
Catatan: Untuk menelusuri file tertentu dengan cepat, tambahkan garis miring terbalik di depan titik, atau kurung seluruh nama file dalam tanda kutip.
foo\.java
"foo.java"
Anda dapat menyaring penelusuran menggunakan filter berikut.
| Filter | Opsi lain | Deskripsi | Contoh |
|---|---|---|---|
| lang: | bahasa: | Lakukan pencocokan persis menurut bahasa file. | lang:pengujian java |
| file: | filepath: jalur: f: |
||
| kasus:ya | Jadikan penelusuran peka huruf besar/kecil. Secara default, penelusuran tidak peka huruf besar/kecil. | case:yes Halo Dunia | |
| : | Telusuri nama kelas. | class:MainClass | |
| : | func: | Telusuri nama fungsi. | fungsi:cetak |
| - | Menegasi istilah dari penelusuran. | halo -dunia | |
| \ | Meng-escape karakter khusus, seperti ., \, atau (. | run\(\) | |
| "[istilah]" | Lakukan penelusuran literal. | "class:main" |
Dukungan Tambahan
Untuk melaporkan masalah, klik tombol Masukan yang muncul di pojok kanan atas layar dan beri masukan Anda dalam formulir yang disediakan.