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

Tổng quan

Trình chỉnh sửa mã 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 làm việc nhanh hơn so với việc tải cây nguồn Android xuống. Bạn nên làm quen với toàn bộ quy trình gửi các thay đổi đến AOSP bằng Git, Repo và Gerrit trước khi sử dụng trình chỉnh sửa mã nguồn Git.

Khi bạn chỉnh sửa một tệp bằng trình chỉnh sửa mã 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 mã 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à các thay đổi

Trình chỉnh sửa mã nguồn Git có các quy trình làm 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 một 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, các nội dung chỉnh sửa trong Trình chỉnh sửa mã nguồn Git sẽ được vá vào thay đổi đó dưới dạng một bộ vá mới.
  • Nếu người khác tạo thay đổi, các nội dung chỉnh sửa trong Trình chỉnh sửa mã nguồn Git 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 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 đường dẫn tệp/thay đổi ở đầu trang.

   Đường dẫn tệp mẫu: https://android.googlesource.com/platform/build/+show/refs/heads/android17-release/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 ngăn trình chỉnh sửa là một trình duyệt tệp, mở kho lưu trữ với tệp của bạn được tải sẵn.

   

   Hình 3. Một 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. Các thẻ cho tệp đã tải

Tải một thay đổi

Chuyển đến thay đổi 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 đườ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, 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.

Thực hiện chỉnh sửa

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 Các 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 đó với nội dung chỉnh sửa còn nguyên vẹn bằng cách nhấp vào tên của tệp đó trong danh sách Các 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 mã 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. Hộp thoại Tạo 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 nhập 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 hộp này được chọn khi bạn tạo thay đổi, thay đổi đó sẽ được xuất bản ngay lập tức lên Gerrit. Nếu hộp này không được chọn, thay đổi đó sẽ được tải lên Gerrit nhưng không được xuất bản.

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

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

   

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

Theo dõi quá trình phê duyệt thay đổi trong Gerrit

Theo dõi trạng thái gửi thay đổi trực tiếp trong Gerrit, giống như 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 giữa các tệp

Chọn hộp đánh dấu Diff (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. Tính năng này hữu ích khi thay đổi một tệp và khi chỉnh sửa một thay đổi hiện có.

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

Hoàn nguyên tệp

Bạn có thể hoàn nguyên 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 hoàn nguyên đều chỉ hoàn nguyên các thay đổi trong Trình chỉnh sửa mã nguồn Git. Các tuỳ chọn này sẽ KHÔNG cập nhật thay đổi trong Gerrit.

Hoàn nguyên một tệp

Để hoàn nguyên một tệp, hãy nhấp vào X bên cạnh tên tệp trong danh sách Các thay đổi đang chờ xử lý.

Hình 9. Phần Các thay đổi đang chờ xử lý

Hoàn nguyên tất cả các tệp

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

Hình 10. Nút Hoàn nguyên tất cả các tệp

Một hộp thoại bật lên sẽ mở ra. Nhấp vào Hoàn nguyên tất cả để hoàn nguyên các thay đổi trong tất cả cá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 hoàn nguyên tất cả các tệp

Chỉnh sửa trang trực tiếp từ tính năng tìm kiếm mã Android

Bạn có thể mở một tệp trong Trình chỉnh sửa mã nguồn Git trực tiếp từ tính năng tìm kiếm mã Android. Tính năng này 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 một tệp trực tiếp từ tính năng tìm kiếm mã Android.

1. Trong tính năng Tìm kiếm mã Android (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 tính năng Android Code Search

   Trình chỉnh sửa mã nguồn Git sẽ mở ra 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 Chọn một nhánh git, sau đó nhấp vào 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 Thực hiện chỉnh sửa.

5. Bạn có thể mở thêm tệp để 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 mã nguồn, hãy chuyển đến 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 trong trình chỉnh sửa mã 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 trong trình chỉnh sửa mã nguồn

3. Khắc phục xung đột bằng cách chỉnh sửa tệp và xoá đ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à điểm đánh dấu xung đột đối với nội dung 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 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 phản hồi về Trình chỉnh sửa mã nguồn Git.

Tài liệu có liên quan

• Tìm kiếm mã Android