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 các tệp trong Dự án mã nguồn mở Android (AOSP) và tải các thay đổi lên Gerrit. Nó nhằm mục đích thực hiện những thay đổi nhỏ đối với một số lượng nhỏ tệp và cung cấp quy trình làm việc nhanh hơn so với việc tải xuống cây nguồn Android . Bạn nên làm quen với toàn bộ quy trình gửi các thay đổi tới AOSP bằ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 lên các thay đổi để tạo danh sách thay đổi Gerrit.
Đăng nhập
- Tải Trình soạn thảo nguồn Git trong trình duyệt.
Bấm Đă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 tin và thay đổi
Trình soạn thảo 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 bạn chọn, trong nhánh bạn chọn.
- Chỉnh sửa một thay đổi. Khi bạn chỉnh sửa 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 chỉnh sửa Git Source Editor của bạn sẽ được vá vào thay đổi đó dưới dạng một bộ bản vá mới.
- Nếu người khác đã tạo thay đổi, các chỉnh sửa trong Trình soạn thảo nguồn Git của bạn sẽ tạo ra một thay đổi mới mà bạn sở hữu, dựa trên thay đổi bạn đã tải.
Tải những gì bạn muốn chỉnh sửa
Bắt đầu phiên chỉnh sửa bằng cách tải tệp hoặc thay đổi.
Tải tập tin
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/main/Changes.md
Nhấp vào Tải tệp hoặc thay đổi .
Hình 2. Đang tải một tập tin hoặc thay đổi
Tệp tải trong khung soạn thảo. Ngăn điều hướng ở bên trái của ngăn soạn thảo 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 tin được tải vào khung chỉnh sửa
Bạn có thể sử dụng ngăn điều hướng để mở nhiều tệp hơn 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 tab ở hàng phía trên ngăn chỉnh sửa. Bấm vào một tab để mở tệp đó trong ngăn chỉnh sửa.
Hình 4. Các tab cho các tập tin được tải
Tải một thay đổi
Điều hướng đế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).
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 tab trong hàng phía trên khung chỉnh sửa (xem Hình 4). Bấm vào một tab để mở tệp đó trong ngăn chỉnh sửa.
Thực hiện chỉnh sửa của bạn
Chỉnh sửa tập tin bằng cách sử dụng khung 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 bạn vô tình đóng tab của tệp có các chỉnh sửa, bạn có thể mở lại tệp với các chỉnh sửa còn nguyên bằng cách nhấp vào tên của nó trong danh sách Thay đổi đang chờ xử lý.
Gửi 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 sự chấp thuận của 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 những thay đổi bạn đã thực hiện.
Bấm 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 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
Nhập mô tả thay đổi, mô tả này sẽ trở thành mô tả thay đổi trong Gerrit. Mô tả này là bắt buộc. Nếu bạn đang chỉnh sửa một thay đổi hiện có, bạn có thể chỉnh sửa mô tả của thay đổi đó nếu muốn.
Tùy chọn, xóa hoặc chọn hộp kiểm 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 thì 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 công bố.
Nhấp vào Tạo .
Thay đổi được tải lên Gerrit. Nếu bạn chọn hộp kiểm Xuất bản khi tạo thì thay đổi cũng được xuất bản trong Gerrit. Sự thay đổi được liên kết trong một thông báo ở đầu màn hình.
Hình 6. Thay đổi thông báo đã tạo
Theo dõi 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ư bất kỳ thay đổi nào 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 tin
Chọn hộp kiểm Khác biệt bên dưới ngăn chỉnh sửa để xem những khác biệt của các chỉnh sửa 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 hữu ích khi thay đổi tệp và khi chỉnh sửa thay đổi hiện có.
Hình 8. Xem các khác biệt của tập tin
Hoàn nguyên tập tin
Bạn có thể hoàn nguyên các thay đổi từ một tệp duy nhất hoặc từ tất cả các tệp trong danh sách thay đổi đang chờ xử lý. Cả hai tùy chọn hoàn nguyên chỉ hoàn nguyên các thay đổi trong Git Source Editor. Họ sẽ KHÔNG cập nhật thay đổi trong Gerrit.
Hoàn nguyên một tập tin
Để 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 Thay đổi đang chờ xử lý.
Hình 9. Phần thay đổi đang chờ xử lý
Hoàn nguyên tất cả các tập tin
Để 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 tin
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 Hủy để giữ lại các thay đổi và tiếp tục chỉnh sửa.
Hình 11. Hoàn nguyên hộp thoại xác nhận tất cả các tập tin
Chỉnh sửa trang trực tiếp từ tìm kiếm mã Android
Bạn có thể mở tệp trong Git Source Editor trực tiếp từ tìm kiếm mã Android . Điều này rất hữu ích nếu bạn cần định vị tệp trước khi chỉnh sửa.
Làm theo quy trình này để chỉnh sửa tệp trực tiếp từ tìm kiếm mã Android.
Trong Tìm kiếm mã Android (cs.android.com), hãy điều hướng đến tệp bạn muốn chỉnh sửa.
Nhấp vào Chỉnh sửa mã .
Hình 12. Nút chỉnh sửa tìm kiếm mã Android
Trình chỉnh sửa nguồn Git mở bằng tệp được chọn trước để chỉnh sửa.
Chọn nhánh Git mà bạn muốn chỉnh sửa tệp từ danh sách thả xuống Chọn nhánh git , sau đó nhấp vào Chọn nhánh .
Hình 13. Chọn nhánh Git để chỉnh sửa
Tệp sẽ mở trong khung chỉnh sửa.
Tiếp tục chỉnh sửa như được mô tả trong phần Thực hiện chỉnh sửa của bạn .
Bạn có thể mở thêm file để chỉnh sửa như mô tả ở phần Đang tải file
Giải quyết xung đột
Để giải quyết xung đột:
Trong Trình chỉnh sửa nguồn, điều hướng đến thay đổi. Sau khi tải thay đổ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 file
Android.pbcó xung đột.
Hình 14. Xung đột với trình soạn thảo nguồn
Nhấp vào một tập tin xung đột. Tệp 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. Các dấu hiệu xung đột của trình soạn thảo nguồn
Khắc phục xung đột bằng cách chỉnh sửa tệp và xóa thủ công các điểm đánh dấu xung đột xung quanh nội dung bạn muốn giữ lại. Ngoài ra, hãy xóa nội dung và đánh dấu xung đột đối với nội dung bạn không muốn giữ lại.
Nhấp vào Tạo thay đổi để tạo thay đổi mới. Hộp thoại Tạo Thay đổi xuất hiện.
Hình 16. Tạo thay đổi
Nhập mô tả thay đổi và 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 để cung cấp phản hồi về Git Source Editor.