Tổng quan về sản phẩm
Giao diện tìm kiếm mã và duyệt nguồn của Bazel là một công cụ dựa trên web để duyệt các kho lưu trữ mã nguồn Bazel. Bạn có thể sử dụng các tính năng này để di chuyển giữa các kho lưu trữ, nhánh và tệp khác nhau. Bạn cũng có thể xem thông tin về nhật ký xem, sự khác biệt và lỗi.
Bắt đầu
Để truy cập vào giao diện tìm kiếm mã và duyệt nguồn, hãy mở https://source.bazel.build trong trình duyệt web.
Màn hình chính sẽ xuất hiện. Màn hình này chứa các thành phần sau:
Thanh công cụ Breadcrumb. Thanh công cụ này hiển thị vị trí hiện tại của bạn trong kho lưu trữ và cho phép bạn nhanh chóng di chuyển đến một vị trí khác, chẳng hạn như một kho lưu trữ khác hoặc một vị trí khác trong một kho lưu trữ, chẳng hạn như một tệp, nhánh hoặc cam kết.
Danh sách các kho lưu trữ mà bạn có thể duyệt.
Ở đầu màn hình là một hộp tìm kiếm. Bạn có thể sử dụng hộp này để tìm kiếm các tệp và mã cụ thể.
Thao tác với kho lưu trữ
Mở kho lưu trữ
Để mở một kho lưu trữ, hãy nhấp vào tên của kho lưu trữ đó trên màn hình chính.
Ngoài ra, bạn có thể sử dụng thanh công cụ Breadcrumb để duyệt tìm một kho lưu trữ cụ thể. Thanh công cụ này hiển thị vị trí hiện tại của bạn trong kho lưu trữ và cho phép bạn nhanh chóng di chuyển đến một vị trí khác, chẳng hạn như một kho lưu trữ khác hoặc một vị trí khác trong một kho lưu trữ, chẳng hạn như một tệp, nhánh hoặc cam kết.
Chuyển đổi kho lưu trữ
Để chuyển sang một kho lưu trữ khác, hãy chọn kho lưu trữ đó trên thanh công cụ Breadcrumb.
Xem kho lưu trữ tại một cam kết cụ thể
Cách xem kho lưu trữ tại một cam kết cụ thể:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Trên thanh công cụ Breadcrumb, hãy mở trình đơn Branch (Nhánh).
- Trong trình đơn con xuất hiện, hãy nhấp vào Commit (Cam kết).
- Chọn cam kết mà bạn muốn xem.
Giao diện hiện hiển thị kho lưu trữ như khi tồn tại tại cam kết đó.
Mở nhánh, cam kết hoặc thẻ
Theo mặc định, giao diện tìm kiếm mã và duyệt nguồn sẽ mở một kho lưu trữ đến nhánh mặc định. Để mở một nhánh khác, trên thanh công cụ Breadcrumb, hãy nhấp vào trình đơn Branch/Commit/Tag (Nhánh/Cam kết/Thẻ). Một trình đơn con sẽ mở ra, cho phép bạn chọn một nhánh bằng tên nhánh, tên thẻ hoặc thông qua hộp tìm kiếm.
- Để chọn một nhánh bằng tên nhánh, hãy chọn Branch (Nhánh), sau đó nhấp vào tên của nhánh đó.
- Để chọn một nhánh bằng tên thẻ, hãy chọn Tag (Thẻ), sau đó nhấp vào tên thẻ.
- Để chọn một nhánh bằng mã cam kết, hãy chọn Commit (Cam kết), sau đó nhấp vào mã cam kết.
- Để tìm kiếm một nhánh, cam kết hoặc thẻ, hãy chọn mục tương ứng rồi nhập cụm từ tìm kiếm vào hộp tìm kiếm.
Thao tác với tệp
Khi bạn chọn một kho lưu trữ trên màn hình chính, màn hình sẽ thay đổi để hiển thị chế độ xem của kho lưu trữ đó. Nếu có tệp README, nội dung của tệp đó sẽ xuất hiện trong ngăn tệp, nằm ở bên phải màn hình. Nếu không, danh sách các tệp và thư mục của kho lưu trữ sẽ xuất hiện. Ở bên trái màn hình là chế độ xem dạng cây của các tệp và thư mục của kho lưu trữ. Bạn có thể sử dụng cây này để duyệt và mở các tệp cụ thể.
Xin lưu ý rằng khi bạn đang xem một kho lưu trữ, thanh công cụ Breadcrumb hiện có 3 thành phần:
- Trình đơn Repository (Kho lưu trữ), nơi bạn có thể chọn các kho lưu trữ khác nhau
- Trình đơn Branch/Commit/Tag (Nhánh/Cam kết/Thẻ), nơi bạn có thể chọn các nhánh, thẻ hoặc cam kết cụ thể
- Hộp File path (Đường dẫn tệp), hiển thị tên của tệp hoặc thư mục hiện tại và đường dẫn tương ứng
Mở tệp
Bạn có thể mở một tệp bằng cách duyệt đến thư mục của tệp đó rồi chọn tệp. Chế độ xem kho lưu trữ sẽ cập nhật để hiển thị nội dung của tệp trong ngăn tệp và vị trí của tệp trong kho lưu trữ trong ngăn cây.
Xem các thay đổi đối với tệp
Cách xem các thay đổi đối với tệp:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào BLAME (ĐỔ LỖI), nằm ở góc trên cùng bên phải.
Ngăn tệp sẽ cập nhật để hiển thị người đã thực hiện các thay đổi đối với tệp và thời điểm thực hiện.
Xem nhật ký thay đổi
Cách xem nhật ký thay đổi của một tệp:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào HISTORY (NHẬT KÝ), nằm ở góc trên cùng bên phải. Ngăn Change history (Nhật ký thay đổi) sẽ xuất hiện, cho thấy các cam kết đối với tệp này.
Xem các bài đánh giá mã
Đối với các bài đánh giá mã Gerrit, bạn có thể mở công cụ này trực tiếp từ ngăn Nhật ký thay đổi.
Cách xem bài đánh giá mã cho một tệp:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào HISTORY (NHẬT KÝ), nằm ở góc trên cùng bên phải. Ngăn Nhật ký thay đổi sẽ xuất hiện, cho thấy các cam kết đối với tệp này.
- Di chuột lên một cam kết. Nút More (Thêm) (3 dấu chấm dọc) sẽ xuất hiện.
- Nhấp vào nút More (Thêm).
- Chọn View code review (Xem bài đánh giá mã).
Công cụ Đánh giá mã Gerrit sẽ mở ra trong một cửa sổ trình duyệt mới.
Mở tệp tại một cam kết cụ thể
Cách mở tệp tại một cam kết cụ thể:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào HISTORY (NHẬT KÝ), nằm ở góc trên cùng bên phải. Ngăn Nhật ký thay đổi sẽ xuất hiện, cho thấy các cam kết đối với tệp này.
- Di chuột lên một cam kết. Nút VIEW (XEM) sẽ xuất hiện.
- Nhấp vào nút VIEW (XEM).
So sánh một tệp với một cam kết khác
Cách so sánh một tệp tại một cam kết khác:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp. Để so sánh từ 2 cam kết khác nhau, trước tiên, hãy mở tệp tại cam kết đó.
- Di chuột lên một cam kết. Nút DIFF (SO SÁNH) sẽ xuất hiện.
- Nhấp vào nút DIFF (SO SÁNH).
Ngăn tệp sẽ cập nhật để hiển thị thông tin so sánh song song giữa 2 tệp. Cam kết cũ nhất trong 2 cam kết luôn ở bên trái.
Trong ngăn Nhật ký thay đổi, cả 2 cam kết đều được làm nổi bật và một nhãn cho biết cam kết có được hiển thị ở bên trái hay bên phải hay không.
Để thay đổi một trong 2 tệp, hãy di chuột lên cam kết trong ngăn Nhật ký thay đổi. Sau đó, hãy nhấp vào nút Left (Trái) hoặc Right (Phải) để mở cam kết ở bên trái hoặc bên phải của sự khác biệt.
Duyệt tìm các tham chiếu chéo
Một cách khác để duyệt các kho lưu trữ nguồn là sử dụng các tham chiếu chéo. Các tham chiếu này sẽ tự động xuất hiện dưới dạng siêu liên kết trong một tệp nguồn nhất định.
Để dễ dàng xác định các tham chiếu chéo, hãy nhấp vào Cross References (Tham chiếu chéo), nằm ở góc trên cùng bên phải. Lựa chọn này sẽ hiển thị một đường gạch dưới bên dưới tất cả các tham chiếu chéo trong một tệp.
Lưu ý: Nếu Cross References (Tham chiếu chéo) bị làm mờ, thì tức là các tham chiếu chéo không có sẵn cho tệp đó.
Nhấp vào một tham chiếu chéo để mở ngăn Tham chiếu chéo. Ngăn này chứa 2 phần:
- Phần Definition (Định nghĩa), liệt kê tệp hoặc các tệp xác định tham chiếu
- Phần References (Tham chiếu), liệt kê các tệp mà tham chiếu cũng xuất hiện
Cả 2 phần đều hiển thị tên của tệp, cũng như dòng hoặc các dòng chứa tham chiếu. Để mở một tệp từ ngăn Tham chiếu chéo, hãy nhấp vào mục nhập số dòng. Tệp sẽ xuất hiện trong một phần mới của ngăn, cho phép bạn tiếp tục duyệt tệp trong khi vẫn xem được tệp gốc.
Bạn có thể tiếp tục duyệt các tham chiếu chéo bằng ngăn Tham chiếu chéo, giống như trong ngăn Tệp. Khi bạn thực hiện việc này, ngăn sẽ hiển thị một đường dẫn dạng breadcrumb mà bạn có thể dùng để di chuyển giữa các tham chiếu chéo khác nhau.
Tìm kiếm mã
Bạn có thể tìm kiếm các tệp hoặc đoạn mã cụ thể bằng hộp tìm kiếm nằm ở đầu màn hình. Các lượt tìm kiếm luôn được thực hiện dựa trên nhánh mặc định.
Theo mặc định, tất cả các lượt tìm kiếm đều sử dụng biểu thức chính quy RE2. Nếu không muốn sử dụng biểu thức chính quy, hãy đặt nội dung tìm kiếm trong dấu ngoặc kép (").
Lưu ý: Để nhanh chóng tìm kiếm một tệp cụ thể, hãy thêm dấu gạch chéo ngược ở phía trước dấu chấm hoặc đặt toàn bộ tên tệp trong dấu ngoặc kép.
foo\.java
"foo.java"
Bạn có thể tinh chỉnh nội dung tìm kiếm bằng các bộ lọc sau.
| Bộ lọc | Lựa chọn khác | Nội dung mô tả | Ví dụ |
|---|---|---|---|
| lang: | ngôn ngữ: | Thực hiện so khớp chính xác theo ngôn ngữ tệp. | lang:java test |
| tệp: | đường dẫn tệp: đường dẫn: f: |
||
| case:yes | Tìm kiếm phân biệt chữ hoa chữ thường. Theo mặc định, các lượt tìm kiếm không phân biệt chữ hoa chữ thường. | case:yes Hello World | |
| hạng: | Tìm tên lớp. | class:MainClass | |
| chức năng: | func: | Tìm tên hàm. | function:print |
| - | Phủ định cụm từ tìm kiếm. | hello -world | |
| Example Source: This is a test Example Translation: Dies ist ein Test Source: This is a test with another placeholder Translation: Dies ist ein Test mit einem anderen Platzhalter | Loại bỏ các ký tự đặc biệt, chẳng hạn như ., \, hoặc (. | run\(\) | |
| "[term]" | Thực hiện tìm kiếm theo nghĩa đen. | "class:main" |
Hỗ trợ khác
Để báo cáo vấn đề, hãy nhấp vào nút Feedback (Phản hồi) xuất hiện ở góc trên cùng bên phải của màn hình rồi nhập ý kiến phản hồi của bạn vào biểu mẫu được cung cấp.