Trình chỉnh sửa nguồn Git

Tổng quan

Trình chỉnh sửa nguồn Git (ci.android.com/edit) là một công cụ dựa trên trình duyệt để chỉnh sửa tệp trong Dự án nguồn mở Android (AOSP) và tải các thay đổi lên Gerrit. Công cụ này dùng để thực hiện các thay đổi nhỏ đối với một số ít tệp và cung cấp quy trình công việc nhanh hơn so với việc tải cây nguồn Android xuống. Bạn phải nắm rõ toàn bộ quy trình gửi thay đổi cho AOSP bằng cách sử dụng Git, Repo và Gerrit trước khi sử dụng trình chỉnh sửa nguồn Git.

Khi bạn chỉnh sửa tệp bằng trình chỉnh sửa nguồn Git, tất cả công việc sẽ diễn ra trên máy cục bộ của bạn, cho đến khi bạn tải các thay đổi lên để tạo danh sách thay đổi Gerrit.

Đăng nhập

1. Tải Trình chỉnh sửa nguồn Git trong trình duyệt.

2. Nhấp vào Đăng nhập để đăng nhập vào tài khoản của bạn.

   

   Hình 1. Nút Đăng nhập

Chỉnh sửa tệp và nội dung thay đổi

Trình chỉnh sửa nguồn Git có các quy trình công việc chính sau:

• Chỉnh sửa một hoặc nhiều tệp mà bạn chọn trong nhánh mà bạn chọn.
• Chỉnh sửa thay đổi. Khi bạn chỉnh sửa một thay đổi, kết quả sẽ phụ thuộc vào người đã tạo thay đổi đó:
  • Nếu bạn đã tạo thay đổi, thì nội dung chỉnh sửa trong Git Source Editor sẽ được vá vào thay đổi đó dưới dạng một nhóm bản vá mới.
  • Nếu ai đó đã tạo thay đổi, thì nội dung chỉnh sửa của bạn trong Git Source Editor sẽ tạo một thay đổi mới mà bạn sở hữu, dựa trên thay đổi mà bạn đã tải.

Tải nội dung bạn muốn chỉnh sửa

Bắt đầu một phiên chỉnh sửa bằng cách tải một tệp hoặc một thay đổi.

Tải tệp

1. Nhập URL của tệp bạn muốn chỉnh sửa vào hộp file/change path (tệp/thay đổi đường dẫn) ở đầu trang.

   Đường dẫn tệp mẫu: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. Nhấp vào Tải tệp hoặc thay đổi.

   

   Hình 2. Đang tải tệp hoặc thay đổi

   Tệp sẽ tải trong ngăn trình chỉnh sửa. Ngăn điều hướng ở bên trái của ngăn trình chỉnh sửa là một trình duyệt tệp, trình duyệt này sẽ mở kho lưu trữ với tệp được tải trước.

   

   Hình 3. Tệp được tải vào ngăn chỉnh sửa

Bạn có thể sử dụng ngăn điều hướng để mở thêm tệp trong cùng một kho lưu trữ. Nếu bạn mở nhiều tệp, mỗi tệp sẽ xuất hiện dưới dạng một thẻ trong hàng phía trên ngăn chỉnh sửa. Nhấp vào một thẻ để mở tệp đó trong ngăn chỉnh sửa.

Hình 4. Thẻ cho tệp đã tải

Tải thay đổi

Chuyển đến thay đổi mà bạn muốn chỉnh sửa bằng cách nhập URL của danh sách thay đổi Gerrit vào hộp file/change path (đường dẫn tệp/thay đổi) ở đầu trang (xem Hình 2).

Đường liên kết thay đổi mẫu: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

Các tệp trong thay đổi sẽ mở trong ngăn chỉnh sửa (xem Hình 3).

Nếu thay đổi bao gồm nhiều tệp, thì mỗi tệp sẽ xuất hiện dưới dạng một thẻ trong hàng ở phía trên ngăn chỉnh sửa (xem Hình 4). Nhấp vào một thẻ để mở tệp đó trong ngăn chỉnh sửa.

Chỉnh sửa thông tin

Chỉnh sửa tệp bằng ngăn chỉnh sửa văn bản. Các tệp bạn chỉnh sửa sẽ xuất hiện trong danh sách Thay đổi đang chờ xử lý bên dưới ngăn chỉnh sửa. Nếu vô tình đóng thẻ của một tệp có nội dung chỉnh sửa, bạn có thể mở lại tệp đó mà không làm mất nội dung chỉnh sửa bằng cách nhấp vào tên tệp trong danh sách Thay đổi đang chờ xử lý.

Gửi các thay đổi

Bạn tạo và xuất bản thay đổi của mình lên Gerrit trong Trình chỉnh sửa nguồn Git. Sau đó, bạn theo dõi quá trình phê duyệt thay đổi trong Gerrit.

Tạo và xuất bản các thay đổi

Hãy làm theo quy trình này để tạo và xuất bản các thay đổi mà bạn đã thực hiện.

1. Nhấp vào nút thích hợp:

   • Nhấp vào Tạo thay đổi nếu bạn đang tạo một thay đổi mới.
   • Nhấp vào Cập nhật thay đổi nếu bạn đang cập nhật một thay đổi hiện có.

   Một hộp thoại sẽ mở ra.

   

   Hình 5. Tạo hộp thoại Thay đổi

2. Nhập nội dung mô tả thay đổi. Nội dung này sẽ trở thành nội dung mô tả thay đổi trong Gerrit. Bạn phải có nội dung mô tả này. Nếu đang chỉnh sửa một thay đổi hiện có, bạn có thể chỉnh sửa nội dung mô tả của thay đổi đó nếu muốn.

3. Bạn có thể bỏ chọn hoặc chọn hộp đánh dấu Xuất bản khi tạo.

   Hộp này được chọn theo mặc định.

   Nếu bạn chọn hộp này khi tạo thay đổi, thay đổi đó sẽ được phát hành ngay lập tức lên Gerrit. Nếu bạn không chọn hộp này, thay đổi sẽ được tải lên Gerrit nhưng không được phát hành.

4. Nhấp vào Tạo.

   Nội dung thay đổi được tải lên Gerrit. Nếu bạn đã chọn hộp đánh dấu Xuất bản khi tạo, thì thay đổi cũng được xuất bản trong Gerrit. Thay đổi này được liên kết trong một thông báo ở đầu màn hình.

   

   Hình 6. Thông báo về thay đổi đã tạo

Theo dõi việc phê duyệt thay đổi trong Gerrit

Theo dõi trạng thái gửi thay đổi ngay trong Gerrit, giống như cách bạn theo dõi mọi thay đổi khác.

Hình 7. Theo dõi trạng thái gửi thay đổi trong Gerrit

Xem sự khác biệt của tệp

Chọn hộp đánh dấu Diff (Sự khác biệt) bên dưới ngăn chỉnh sửa để xem sự khác biệt của các nội dung chỉnh sửa mà bạn đã thực hiện đối với tệp đang hoạt động trong ngăn chỉnh sửa. Điều này rất hữu ích khi thay đổi tệp và khi chỉnh sửa thay đổi hiện có.

Hình 8. Xem sự khác biệt của tệp

Huỷ bỏ các tệp

Bạn có thể huỷ bỏ các thay đổi từ một tệp hoặc từ tất cả các tệp trong danh sách thay đổi đang chờ xử lý. Cả hai tuỳ chọn huỷ bỏ đều chỉ huỷ bỏ các thay đổi trong Trình chỉnh sửa nguồn Git. Họ sẽ KHÔNG cập nhật thay đổi trong Gerrit.

Huỷ một tệp

Để huỷ một tệp, hãy nhấp vào biểu tượng X bên cạnh tên tệp trong danh sách Thay đổi đang chờ xử lý.

Hình 9. Mục Thay đổi đang chờ xử lý

Huỷ bỏ tất cả các tệp

Để huỷ bỏ tất cả tệp cùng một lúc, hãy nhấp vào Huỷ bỏ tất cả tệp bên dưới ngăn chỉnh sửa.

Hình 10. Nút Huỷ bỏ tất cả tệp

Một hộp thoại bật lên sẽ mở ra. Nhấp vào Huỷ bỏ tất cả để huỷ bỏ các thay đổi trong tất cả tệp đang chờ xử lý hoặc nhấp vào Huỷ để giữ lại các thay đổi và tiếp tục chỉnh sửa.

Hình 11. Hộp thoại xác nhận huỷ bỏ tất cả tệp

Chỉnh sửa trang ngay từ kết quả tìm kiếm mã Android

Bạn có thể mở tệp trong Trình soạn thảo nguồn Git ngay từ tính năng tìm kiếm mã Android. Điều này rất hữu ích nếu bạn cần tìm tệp trước khi chỉnh sửa.

Hãy làm theo quy trình này để chỉnh sửa tệp ngay từ tính năng tìm kiếm mã Android.

1. Trong Android Code Search (cs.android.com), hãy chuyển đến tệp bạn muốn chỉnh sửa.

2. Nhấp vào Chỉnh sửa mã.

   

   Hình 12. Nút Chỉnh sửa mã trong Android Code Search

   Trình chỉnh sửa nguồn Git sẽ mở ra cùng với tệp được chọn trước để chỉnh sửa.

3. Chọn nhánh Git mà bạn muốn chỉnh sửa tệp trong danh sách thả xuống Select a git branch (Chọn một nhánh git), sau đó nhấp vào Pick branch (Chọn nhánh).

   

   Hình 13. Chọn một nhánh Git để chỉnh sửa

   Tệp sẽ mở trong ngăn chỉnh sửa.

4. Tiếp tục chỉnh sửa như mô tả trong phần Chỉnh sửa.

5. Bạn có thể mở các tệp khác để chỉnh sửa như mô tả trong phần Tải tệp

Giải quyết xung đột

Cách giải quyết xung đột:

1. Trong Trình chỉnh sửa nguồn, hãy chuyển đến nội dung thay đổi. Sau khi thay đổi được tải, các tệp xung đột sẽ được liệt kê ở phần dưới cùng của màn hình. Ví dụ: Hình 14 cho thấy tệp Android.pb có xung đột.

   

   Hình 14. Xung đột trình chỉnh sửa nguồn

2. Nhấp vào một tệp xung đột. Tệp sẽ tải và hiển thị các khối nội dung xung đột liên tiếp và trong các điểm đánh dấu Git (<<<<<<< và >>>>>>>).

   

   Hình 15. Điểm đánh dấu xung đột của trình chỉnh sửa nguồn

3. Khắc phục xung đột bằng cách chỉnh sửa tệp và xoá các điểm đánh dấu xung đột xung quanh nội dung bạn muốn giữ lại theo cách thủ công. Ngoài ra, hãy xoá nội dung và các điểm đánh dấu xung đột đối với nội dung mà bạn không muốn giữ lại.

4. Nhấp vào Tạo thay đổi để tạo một thay đổi mới. Hộp thoại Create Change (Tạo thay đổi) sẽ xuất hiện.

   

   Hình 16. Tạo thay đổi

5. Nhập nội dung mô tả thay đổi rồi nhấp vào Tạo.

Gửi phản hồi

Sử dụng nút lỗi ở góc trên cùng bên phải để gửi ý kiến phản hồi về Trình chỉnh sửa nguồn Git.

Tài liệu liên quan

• Tìm kiếm mã Android