Tổng quan về sản phẩm
Giao diện duyệt tìm nguồn và tìm kiếm mã của Bazel là công cụ dựa trên web để duyệt qua kho mã nguồn Bazel. Bạn có thể sử dụng các tính năng này để điều hướng giữa các kho lưu trữ, nhánh và tệp. Bạn cũng có thể xem nhật ký, điểm khác biệt và thông tin đổ lỗi.
Bắt đầu
Để truy cập vào giao diện tìm kiếm mã và duyệt qua nguồn, hãy mở https://source.bazel.build trong trình duyệt web.
Màn hình chính 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ữ cũng như giúp bạn nhanh chóng di chuyển đến vị trí khác kho lưu trữ 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 những kho lưu trữ mà bạn có thể duyệt qua.
Ở đầ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 tệp và mã cụ thể.
Làm việc với các 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 qua 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ữ cũng như giúp bạn nhanh chóng di chuyển đến vị trí khác kho lưu trữ 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.
Xem kho lưu trữ tại một xác nhận cụ thể
Cách xem kho lưu trữ tại một cam kết cụ thể:
- Trong khung hiển thị 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 Xác nhận.
- Chọn cam kết bạn muốn xem.
Giờ đây, giao diện cho thấy kho lưu trữ khi tồn tại trong bản xác nhận đó.
Mở một nhánh, xác nhận hoặc thẻ
Theo mặc định, giao diện tìm kiếm mã và duyệt qua nguồn sẽ mở một kho lưu trữ để nhánh mặc định. Để mở một nhánh khác, từ thanh công cụ Breadcrumb, hãy nhấp vào trình đơn Branch/Commit/Tag. Một trình đơn phụ sẽ mở ra, cho phép bạn chọn một nhánh bằng cách sử dụ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 Nhánh rồi nhấp vào tên chi nhánh.
- Để chọn một nhánh bằng tên thẻ, hãy chọn Thẻ và sau đó nhấp vào tên thẻ.
- Để chọn một nhánh bằng mã xác nhận, hãy chọn Commit (Xác nhận), sau đó nhấp vào mã cam kết.
- Để tìm kiếm một nhánh, xác nhận hoặc thẻ, hãy chọn mục tương ứng và nhập 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ẽ chuyển sang chế độ hiển thị thành phần hiển thị 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à một cái cây các tệp và thư mục trong kho lưu trữ. Bạn có thể sử dụng cây này để duyệt qua 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 Repository (Kho lưu trữ) để chọn nhiều kho lưu trữ
- Trình đơn Branch/Commit/Tag, nơi bạn có thể chọn các nhánh cụ thể, thẻ hoặc cam kết
- 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 của nó
Mở tệp
Bạn có thể mở tệp bằng cách duyệt đến thư mục của tệp đó rồi chọn tệp đó. Chế độ xem của kho lưu trữ sẽ cập nhật để hiện nội dung của tệp trong ngăn tệp và vị trí của tệp đó trong kho lưu trữ ở ngăn cây.
Xem các thay đổi về tệp
Cách xem những thay đổi về tệp:
- Trong khung hiển thị 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 để hiển thị thời điểm và người đã thực hiện thay đổi đối với tệp.
Xem nhật ký thay đổi
Cách xem nhật ký thay đổi của một tệp:
- Trong khung hiển thị kho lưu trữ, hãy chọn tệp đó.
- Nhấp vào NHẬT KÝ HOẠT ĐỘNG ở góc trên bên phải. Ngăn Lịch sử thay đổi xuất hiện, hiển thị các thay đổi cho tệp này.
Xem bài đánh giá mã
Để xem lại 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 xét mã cho một tệp:
- Trong khung hiển thị kho lưu trữ, hãy chọn tệp đó.
- Nhấp vào NHẬT KÝ HOẠT ĐỘNG ở góc trên bên phải. Ngăn Nhật ký thay đổi xuất hiện, hiển thị các thay đổi 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 quá trình xem xét mã.
Công cụ Gerrit Code Review mở ra trong một cửa sổ trình duyệt mới.
Mở một tệp tại một lệnh xác nhận cụ thể
Cách mở tệp tại một lệnh xác nhận (commit) cụ thể:
- Trong khung hiển thị kho lưu trữ, hãy chọn tệp đó.
- Nhấp vào NHẬT KÝ HOẠT ĐỘNG ở góc trên bên phải. Ngăn Nhật ký thay đổi xuất hiện, hiển thị các thay đổi cho tệp này.
- Di chuột qua một cam kết. Nút XEM sẽ xuất hiện.
- Nhấp vào nút 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 ở một cam kết khác:
- Trong khung hiển thị kho lưu trữ, hãy chọn tệp đó. Để so sánh giữa hai các 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 YYYY sẽ xuất hiện.
- Nhấp vào nút Khác.
Ngăn tệp sẽ cập nhật để hiển thị thông tin so sánh song song giữa hai tệp tệp. Thay đổi cũ nhất trong 2 thay đổi luôn ở 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 nếu cam kết xuất hiện ở bên trái hoặc bên phải.
Để thay đổi một trong hai tệp, hãy di chuột qua cam kết trong ngăn Lịch sử thay đổi. Sau đó: nhấp vào nút Left (Trái) hoặc Right (Phải) để mở cam kết trên bên trái hoặc bên phải của điểm khác biệt.
Duyệt qua tham chiếu chéo
Một cách khác để duyệt qua các kho lưu trữ nguồn là sử dụng tài liệu tham khả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 nội dung tham chiếu nhất định tệp nguồn.
Để xác định tham chiếu chéo dễ dàng hơn, hãy nhấp vào Tham chiếu chéo, nằm ở góc trên bên phải. Lựa chọn này sẽ hiển thị 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 mục Tham chiếu chéo chuyển sang màu xám, thì tức là không có thông tin tham chiếu chéo 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 hai phần:
- Phần Định nghĩa liệt kê các tệp hoặc các tệp dùng để xác định tham chiếu
- Phần References (Tài liệu tham khảo), liệt kê các tệp mà tệp đối chiếu cũng chứa trong đó xuất hiện
Cả hai phần đều hiển thị tên tệp, cũng như dòng hoặc các dòng có chứa tham chiếu. Cách mở tệp từ ngăn Tham chiếu chéo: 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 qua 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ài liệu tham khảo chéo bằng cách sử dụng ngăn Tham chiếu chéo, như cách bạn có thể làm 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ể sử dụng để điều hướng giữa các tham chiếu chéo khác nhau.
Đ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 nằm ở ở đầu màn hình. Các tìm kiếm luôn chống lại nhánh 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 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 nội dung tìm kiếm của bạn trong dấu ngoặc kép ( " ).
Lưu ý: Để tìm nhanh một tệp cụ thể, hãy thêm dấu gạch chéo ngược vào 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ách sử dụng các bộ lọc sau.
| Bộ lọc | Lựa chọn khác | Nội dung mô tả | Ví dụ |
|---|---|---|---|
| ngôn ngữ: | ngôn ngữ: | Thực hiện so khớp chính xác theo ngôn ngữ của tệp. | kiểm thử lang:java |
| tệp: | filepath: đường dẫn: điểm: |
||
| case:yes [có] | 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 Xin chào mọi người | |
| lớp: | Tìm tên lớp học. | lớp:MainClass | |
| hàm: | func: | Tìm một tên hàm. | function:print |
| - | Phủ định cụm từ tìm kiếm. | xin chào thế giới | |
| \ | Thoát các ký tự đặc biệt, chẳng hạn như ., \ hoặc (. | chạy\(\) | |
| "[điều khoản]" | Thực hiện tìm kiếm theo chữ. | "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 ở trên cùng góc bên phải 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.