Tổng quan về sản phẩm
Giao diện duyệt mã nguồn và tìm kiếm mã của Bazel là một công cụ dựa trên nền tảng web để duyệt qua các kho lưu trữ mã nguồn của Bazel. Bạn có thể dùng những tính năng này để di chuyển giữa nhiều 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 về nguyên nhân.
Bắt đầu
Để truy cập giao diện tìm kiếm mã và duyệt nguồn, hãy mở https://source.bazel.build trên 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 cho biết 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ư 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 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ể.
Xử lý kho lưu trữ
Mở kho lưu trữ
Để mở 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ể dùng thanh công cụ Breadcrumb để duyệt xem một kho lưu trữ cụ thể. Thanh công cụ này cho biết 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ư 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 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 của 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 phụ xuất hiện, hãy nhấp vào Cam kết.
- Chọn cam kết bạn muốn xem.
Giờ đây, giao diện sẽ cho thấy kho lưu trữ tại thời điểm cam kết đó.
Mở một 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ở 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. 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 Branch (Nhánh) rồi nhấp vào tên của nhánh đó.
- Để chọn một nhánh sử dụng tên thẻ, hãy chọn Tag, sau đó nhấp vào tên thẻ.
- Để chọn một nhánh sử dụng mã nhận dạng cam kết, hãy chọn Commit rồi nhấp vào mã nhận dạng 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.
Xử lý 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 để cho thấy khung hiển thị của 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 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 qua và mở các tệp cụ thể.
Lưu ý rằng khi bạn đang xem kho lưu trữ, thanh công cụ Breadcrumb hiện có 3 thành phần:
- Trình đơn Kho lưu trữ để bạn có thể chọn nhiều kho lưu trữ
- Trình đơn Branch/Commit/Tag, bạn có thể chọn các nhánh, thẻ hoặc thay đổi 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 đó và chọn tệp đó. Khung hiển thị của 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ữ ở 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 của kho lưu trữ, hãy chọn tệp.
- Nhấp vào BLAME nằm ở 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:
- Trong chế độ xem của kho lưu trữ, hãy chọn tệp.
- Nhấp vào NHẬT KÝ nằm ở góc trên bên phải. Ngăn Lịch sử 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 quá trình xem xét mã Gerrit, bạn có thể mở công cụ này trực tiếp từ ngăn Lịch sử thay đổi.
Để xem quy trình xem lại mã cho một tệp:
- Trong chế độ xem của kho lưu trữ, hãy chọn tệp.
- Nhấp vào NHẬT KÝ nằm ở 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 cho tệp này.
- Di chuột qua một lệnh xác nhận. 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 sẽ mở trong cửa sổ trình duyệt mới.
Mở tệp tại một thời điểm xác nhận cụ thể
Cách mở tệp tại một lệnh xác nhận cụ thể:
- Trong chế độ xem của kho lưu trữ, hãy chọn tệp.
- Nhấp vào NHẬT KÝ nằm ở 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 cho tệp này.
- Di chuột qua một lệnh xác nhận. Nút CHẾ ĐỘ 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 tại một cam kết khác:
- Trong chế độ xem của kho lưu trữ, hãy chọn tệp. Để so sánh với 2 thay đổi khác nhau, trước tiên, hãy mở tệp tại lần xác nhận đó.
- Di chuột qua một lệnh xác nhận. Nút DIFF xuất hiện.
- Nhấp vào nút khác.
Ngăn tệp sẽ cập nhật để cho thấy dữ liệu so sánh song song giữa 2 tệp. Hai thay đổi cũ nhất 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 liệu cam kết được 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 Lịch sử thay đổi. Sau đó, hãy nhấp vào nút Left (Trái) hoặc Right (Phải) để mở lệnh xác nhận ở bên trái hoặc bên phải của phần khác biệt.
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.
Để xác định các tệp 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ị dấu 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 mục Tham chiếu chéo chuyển sang màu xám, tức là tệp đó không dùng được tệp tham chiếu chéo.
Nhấp vào một tham chiếu chéo để mở ngăn Tham chiếu chéo. Ngăn này gồm 2 phần:
- Phần Định nghĩa, liệt kê các tệp hoặc các tệp xác định tham chiếu
- Phần Tệp đối chiếu, liệt kê các tệp mà tệp đối chiếu cũng xuất hiện trong đó
Cả hai phần đều hiển thị tên của tệp, cũng như dòng hoặc dòng chứa tệp 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 này 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 xem tệp trong khi vẫn giữ nguyên chế độ xem.
Bạn có thể tiếp tục duyệt qua 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 thực hiện thao tác này, ngăn này sẽ hiển thị một đường dẫn breadcrumb mà bạn có thể sử dụng để di chuyển giữa nhiều 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 nằm ở đầu màn hình. Tìm kiếm luôn đi ngược lại 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 nội dung tìm kiếm 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 ở 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 | 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. | kiểm thử lang:java |
| tệp: | filepath: đường dẫn: f: |
||
| case:có | Phân biệt chữ hoa chữ thường. Theo mặc định, các cụm 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. | lớp:Lớp Chính | |
| hàm: | func: | Tìm tên hàm. | hàm:print |
| - | Phủ định từ khoá đó trong nội dung 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 (. | run\(\) | |
| "[từ khoá]" | 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 Feedback (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.