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 qua 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. Bạn cũng có thể xem nhật ký, nội dung thay đổi 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 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 (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 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 kho lưu trữ, chẳng hạn như một tệp, nhánh hoặc thay đổi.
Danh sách các kho lưu trữ mà bạn có thể duyệt qua.
Ở đầ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ể.
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 (Dấu vết) để 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 kho lưu trữ, chẳng hạn như một tệp, nhánh hoặc thay đổi.
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 (Dấu vết).
Xem kho lưu trữ tại một thay đổi cụ thể
Cách xem kho lưu trữ tại một thay đổi cụ thể:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Trên thanh công cụ Breadcrumb (Dấu vết), hãy mở trình đơn Branch (Nhánh).
- Trong trình đơn phụ xuất hiện, hãy nhấp vào Commit (Ghi đè).
- Chọn thay đổi bạn muốn xem.
Giao diện hiện hiển thị kho lưu trữ như tồn tại tại lần thay đổi đó.
Mở một nhánh, thay đổi 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ữ cho nhánh mặc định. Để mở một nhánh khác, trên thanh công cụ Breadcrumb (Dấu vết), hãy nhấp vào trình đơn Branch/Commit/Tag (Nhánh/Ghi nhận/Thẻ). Một trình đơn phụ 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 Nhánh rồi 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 Thẻ rồi nhấp vào tên thẻ.
- Để chọn một nhánh bằng mã nhận dạng thay đổi, hãy chọn Commit (Ghi nhận thay đổi) rồi nhấp vào mã nhận dạng thay đổi.
- Để tìm một nhánh, thay đổi hoặc thẻ, hãy chọn mục tương ứng rồi 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ữ 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 ở 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 trong 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 (Tập hợp liên kết phân cấp) hiện có ba thành phần:
- Trình đơn Repository (Kho lưu trữ), trong đó bạn có thể chọn nhiều kho lưu trữ
- Trình đơn Nhánh/Ghi nhận thay đổi/Thẻ, trong đó bạn có thể chọn các nhánh, thẻ hoặc ghi nhận thay đổi cụ thể
- Hộp Đườ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 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 đến thư mục của tệp đó rồi chọn tệp đó. Chế độ xem của bản cập nhật kho lưu trữ sẽ 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 (TRÁCH NHIỆM) ở góc trên bên phải.
Ngăn tệp sẽ cập nhật để cho biết ai đã thực hiện thay đổi đối với tệp và thời điểm thực hiện thay đổi.
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Ý) ở góc trên bên phải. Ngăn Nhật ký thay đổi sẽ 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 các bài đánh giá mã Gerrit, bạn có thể mở công cụ này ngay trong 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Ý) ở góc trên bên phải. Ngăn Change History (Nhật ký thay đổi) sẽ xuất hiện, cho thấy các thay đổi đối với tệp này.
- Di chuột qua một thay đổi. 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 bài đánh giá mã.
Công cụ Gerrit Code Review (Xem xét mã Gerrit) sẽ mở trong một cửa sổ trình duyệt mới.
Mở tệp tại một thay đổi cụ thể
Cách mở một tệp tại một thay đổi cụ thể:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp.
- Nhấp vào HISTORY (NHẬT KÝ) ở góc trên bên phải. Ngăn Change History (Nhật ký thay đổi) sẽ xuất hiện, cho thấy các thay đổi đối với tệp này.
- Di chuột qua một thay đổi. 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 thay đổi khác
Cách so sánh một tệp ở một thay đổi khác:
- Trong chế độ xem kho lưu trữ, hãy chọn tệp. Để so sánh từ hai tệp thay đổi khác nhau, trước tiên, hãy mở tệp tại tệp thay đổi đó.
- Di chuột qua một thay đổi. Nút DIFF (SỰ KHÁC BIỆT) sẽ xuất hiện.
- Nhấp vào nút DIFF (SỰ KHÁC BIỆT).
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. Lần thay đổi cũ nhất trong hai lần thay đổi luôn nằm ở bên trái.
Trong ngăn Nhật ký thay đổi, cả hai thay đổi đều được làm nổi bật và một nhãn cho biết thay đổi đó 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 thay đổi trong ngăn Nhật ký thay đổi. Sau đó, nhấp vào nút Trái hoặc Phải để mở thay đổi ở bên trái hoặc bên phải của nội dung so sánh.
Duyệt qua các tệp tham chiếu chéo
Một cách khác để duyệt qua kho lưu trữ nguồn là 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.
Để dễ dàng xác định các tệp tham chiếu chéo, hãy nhấp vào Tham chiếu chéo ở góc trên bên phải. Tuỳ chọn này sẽ hiển thị một đường gạch dưới bên dưới tất cả các tệp tham chiếu chéo trong một tệp.
Lưu ý: Nếu mục Tham chiếu chéo có màu xám, thì tức là tệp đó không có tham chiếu chéo.
Nhấp vào một tệp tham chiếu chéo để mở ngăn Tham chiếu chéo. Ngăn này chứa hai phần:
- Phần Definition (Định nghĩa), liệt kê tệp hoặc các tệp xác định tệp đối chiếu
- Phần Tham chiếu, liệt kê các tệp trong đó tham chiếu cũng 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 chứa tệp tham chiếu. Để mở một tệp trong ngăn Tham chiếu chéo, hãy nhấp vào mục 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 xem tệp gốc.
Bạn có thể tiếp tục duyệt xem các tệp 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 làm như vậy, ngăn sẽ hiển thị một đường dẫn dạng chuỗi, bạn có thể sử dụng đường dẫn này để di chuyển giữa các tệp tham chiếu chéo.
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 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 được so khớp với 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 bạn không muốn sử dụng biểu thức chính quy, hãy đặt cụm từ tìm kiếm của bạn trong dấu ngoặc kép ( " ).
Lưu ý: Để nhanh chóng tìm một tệp cụ thể, hãy thêm dấu gạch chéo ngược vào 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ữ của tệp. | lang:java test |
| tệp: | filepath: path: 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 | |
| class: | Tìm tên lớp. | class:MainClass | |
| hàm: | func: | Tìm tên hàm. | function:print |
| - | Loại bỏ cụm từ đó khỏi nội dung tìm kiếm. | hello -world | |
| \ | Thoát khỏi các ký tự đặc biệt, chẳng hạn như ., \ hoặc (. | run\(\) | |
| "[từ khoá]" | Tìm kiếm theo văn bản. | "class:main" |
Dịch vụ hỗ trợ khác
Để báo cáo vấn đề, 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 rồi nhập ý kiến phản hồi của bạn vào biểu mẫu được cung cấp.