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 nền tảng web để duyệt xem 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 nhật ký, thông tin khác nhau và đổ lỗi cho thông tin.
Bắt đầu
Để truy cập giao diện duyệt mã và tìm kiếm mã, 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 (tập hợp liên kết phân cấp). 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 di chuyển nhanh đế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 kho lưu trữ, chẳng hạn như tệp, nhánh hoặc cam kết.
Danh sách kho lưu trữ mà bạn có thể duyệt xem.
Ở đầu màn hình là 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ể.
Làm việ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 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 xem 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 di chuyển nhanh đế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 kho lưu trữ, chẳng hạn như 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 (tập hợp liên kết phân cấp).
Xem kho lưu trữ theo cam kết cụ thể
Cách xem kho lưu trữ theo một cam kết cụ thể:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp.
- Từ thanh công cụ Breadcrumb, hãy mở trình đơn Branch (Nhánh).
- Trong trình đơn phụ xuất hiện, hãy nhấp vào Cam kết.
- Chọn thay đổi mà bạn muốn xem.
Giao diện hiện tại cho thấy kho lưu trữ vì tồn tại theo cam kết đó.
Mở chi nhánh, cam kết hoặc thẻ
Theo mặc định, giao diện tìm kiếm mã và giao diện duyệt nguồn sẽ mở kho lưu trữ cho 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 phụ sẽ mở ra, cho phép bạn chọn một nhánh có 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 cách sử dụng tên chi nhánh, hãy chọn Nhánh, sau đó nhấp vào tên của chi nhánh đó.
- Để chọn một nhánh sử dụng tên thẻ, hãy chọn Tag (Thẻ), sau đó nhấp vào tên thẻ.
- Để chọn một nhánh sử dụng mã cam kết, hãy chọn Commit (Cam kết) rồi 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 và nhập một cụm từ tìm kiếm vào hộp tìm kiếm.
Làm việc với tệp
Khi bạn chọn một kho lưu trữ từ màn hình chính, màn hình sẽ thay đổi để hiển thị chế độ xem kho lưu trữ đó. Nếu tệp README tồn tại, 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 cho 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 xem và mở các tệp cụ thể.
Lưu ý rằng khi bạn đang xem một kho lưu trữ, thanh công cụ Breadcrumb hiện có ba thành phần:
- Trình đơn Kho lưu trữ, từ đó bạn có thể chọn những kho lưu trữ khác nhau
- Trình đơn Nhánh/Cam kết/Thẻ, từ đó 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) cho thấy tên của tệp hoặc thư mục hiện tại và đường dẫn tương ứng của tệp hoặc thư mục đó
Mở tệp
Bạn có thể mở một tệp bằng cách duyệt tới thư mục đó 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 kho lưu trữ trong kho lưu trữ ở 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:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào BLAME, ở góc trên bên phải.
Ngăn tệp sẽ cập nhật để cho biết ai đã thay đổi tệp và thời điểm thay đổi.
Xem nhật ký thay đổi
Cách xem nhật ký thay đổi của một tệp:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào LỊCH SỬ, ở góc trên bên phải. Ngăn Nhật ký thay đổi xuất hiện, cho thấy các thay đổi đối với tệp này.
Xem bài đánh giá mã
Đối với bài đánh giá về mã Gerrit, bạn có thể mở công cụ này ngay trên ngăn Nhật ký thay đổi.
Cách xem bài đánh giá mã cho một tệp:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào LỊCH SỬ, ở góc trên bên phải. Ngăn Lịch sử thay đổi xuất hiện, cho thấy cam kết cho tệp này.
- Di chuột qua một cam kết. Nút Thêm (ba dấu chấm dọc) sẽ xuất hiện.
- Nhấp vào nút Thêm.
- Chọn Xem lại mã.
Công cụ Gerrit Code Review sẽ mở 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 theo một cam kết cụ thể:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào LỊCH SỬ, ở góc trên bên phải. Ngăn Lịch sử thay đổi xuất hiện, cho thấy cam kết cho tệp này.
- Di chuột qua một cam kết. Nút XEM xuất hiện.
- Nhấp vào nút XEM.
So sánh tệp với một cam kết khác
Cách so sánh một tệp ở một cam kết khác:
- Từ chế độ xem kho lưu trữ, hãy chọn tệp. Để so sánh từ hai cam kết khác nhau, trước tiên, hãy mở tệp tại cam kết đó.
- Di chuột qua một cam kết. Nút DIFF xuất hiện.
- Nhấp vào nút DIFF.
Ngăn tệp sẽ cập nhật để hiển thị một thông tin so sánh cạnh nhau giữa hai tệp. Giá trị cũ nhất trong hai giá trị luôn nằm ở bên trái.
Trong ngăn Lịch sử thay đổi, cả hai thay đổi đều được đánh dấu và một nhãn cho biết liệu cam kết sẽ hiển thị ở bên trái hay bên phải.
Để thay đổi một trong hai tệp, hãy di chuột qua 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 trang diff.
Tham chiếu chéo duyệt web
Một cách khác để duyệt qua các kho lưu trữ nguồn là thông qua việc sử dụng tệp tham chiếu chéo. Các tệp tham chiếu này 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.
Để tham chiếu chéo dễ dàng hơn, hãy nhấp vào Tham chiếu chéo, ở góc trên bên phải. Tuỳ chọn này hiển thị một dấu gạch dưới bên dưới tất cả tham chiếu chéo trong một tệp.
Lưu ý: Nếu Tệp đối chiếu chéo có màu xám, thì tức là tệp tham chiếu đó không hiển thị.
Nhấp vào một tệp đối chiếu chéo để mở ngăn Tham chiếu chéo. Ngăn này chứa hai phần:
- Phần Định nghĩa liệt kê tệp hoặc các tệp xác định tệp tham chiếu
- Phần References (Tham chiếu), liệt kê các tệp mà tệp đối chiếu cũng xuất hiện
Cả hai phần đều hiển thị tên của tệp, cũng như các dòng hoặc dòng chứa tệp đối chiếu. Để mở 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 này 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 giữ tệp gốc trong chế độ xem.
Bạn có thể tiếp tục duyệt qua các tệp tham chiếu chéo bằng cách sử dụng ngăn Tham chiếu chéo, giống như cách bạn có thể thực hiện trong ngăn Tệp. Khi bạn làm như vậy, ngăn này sẽ hiển thị một đường dẫn breadcrumb mà bạn có thể dùng để di chuyển giữa các tệp tham chiếu chéo.
Đang tìm mã
Bạn có thể tìm kiếm các tệp hoặc đoạn mã cụ thể bằng cách sử dụng hộp tìm kiếm ở đầu màn hình. Các lượt tìm kiếm luôn đối chiếu với nhánh mặc định.
Tất cả lượt tìm kiếm đều sử dụng biểu thức chính quy RE2 theo mặc định. Nếu bạn không muốn sử dụng biểu thức chính quy, hãy đặt tìm kiếm của bạn 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 đưa toàn bộ tên tệp vào trong dấu ngoặc kép.
foo\.java
"foo.java"
Bạn có thể tinh chỉnh kết quả tìm kiếm bằng các bộ lọc sau.
| Bộ lọc | Tuỳ chọn khác | Mô tả | Ví dụ |
|---|---|---|---|
| ngôn ngữ: | ngôn ngữ: | Thực hiện đối sánh chính xác theo ngôn ngữ của tệp. | lang:java kiểm tra |
| tệp: | đường dẫn tệp: đường dẫn: f: |
||
| Case:có | Phân biệt chữ hoa chữ thường của cụm từ tìm kiếm. Theo mặc định, nội dung tìm kiếm không phân biệt chữ hoa chữ thường. | Case:yes Xin chào thế giới | |
| lớp: | Tìm một tên lớp. | class:MainClass | |
| hàm: | func: | Tìm tên hàm. | function:print |
| - | Ý nghĩa của cụm từ khỏi tìm kiếm. | xin chào – thế giới | |
| \ | Thoát khỏi các ký tự đặc biệt, chẳng hạn như ., \ hoặc (. | chạy\(\) | |
| "[từ]" | Thực hiện tìm kiếm theo nghĩa đen. | "class:main" |
Hỗ trợ bổ sung
Để báo cáo sự cố, hãy nhấp vào nút Phản hồi xuất hiện ở góc trên cùng bên phải màn hình và nhập phản hồi của bạn vào biểu mẫu được cung cấp.