개요
Git 소스 편집기 (ci.android.com/edit)는 AOSP(Android 오픈 소스 프로젝트)의 파일을 편집하고 변경 사항을 Gerrit에 업로드하기 위한 브라우저 기반 도구입니다. 적은 수의 파일을 약간만 변경하기 위한 것이며 Android 소스 트리를 다운로드하는 것보다 더 빠른 워크플로를 제공합니다. Git 소스 편집기를 사용하기 전에 Git, Repo 및 Gerrit를 사용하여 AOSP에 변경 사항을 제출하는 전체 프로세스를 숙지해야 합니다.
Git 소스 편집기를 사용하여 파일을 편집하면 변경 사항을 업로드하여 Gerrit 변경 목록을 생성할 때까지 모든 작업이 로컬 시스템에서 수행됩니다.
로그인
- 브라우저에서 Git Source Editor 를 로드합니다.
로그인을 클릭하여 계정에 로그인합니다.
그림 1. 로그인 버튼
파일 편집 및 변경
Git Source Editor에는 다음과 같은 주요 작업 흐름이 있습니다.
- 선택한 분기에서 원하는 파일을 하나 이상 편집합니다.
- 변경 사항을 편집합니다. 변경 사항을 편집할 때 변경 사항을 만든 사람에 따라 결과가 달라집니다.
- 변경 사항을 생성한 경우 Git Source Editor 편집 내용이 새 패치 세트로 변경 사항에 패치됩니다.
- 다른 사람이 변경 사항을 생성한 경우 Git 소스 편집기 편집은 로드한 변경 사항을 기반으로 귀하가 소유한 새로운 변경 사항을 생성합니다.
수정하려는 항목 로드 중
파일 또는 변경 사항을 로드하여 편집 세션을 시작합니다.
파일 로드 중
페이지 상단의 파일/경로 변경 상자에 편집할 파일의 URL을 입력합니다.
샘플 파일 경로: https://android.googlesource.com/platform/build/+show/refs/heads/master/Changes.md
파일 로드 또는 변경 을 클릭합니다.
그림 2. 파일 로드 또는 변경
파일이 편집기 창에 로드됩니다. 편집기 창 왼쪽에 있는 탐색 창은 파일이 미리 로드된 저장소를 여는 파일 브라우저입니다.
그림 3. 편집 창에 로드된 파일
탐색 창을 사용하여 동일한 리포지토리 내에서 더 많은 파일을 열 수 있습니다. 여러 파일을 여는 경우 각 파일은 편집 창 위의 행에 탭으로 나타납니다. 편집 창에서 해당 파일을 열려면 탭을 클릭합니다.
그림 4. 로드된 파일의 탭
변경사항 로드 중
페이지 상단에 있는 파일/경로 변경 상자에 Gerrit 변경 목록의 URL을 입력하여 편집하려는 변경으로 이동합니다(그림 2 참조).
샘플 변경 링크: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
변경된 파일이 편집 창에서 열립니다(그림 3 참조).
변경 사항에 여러 파일이 포함된 경우 각 파일은 편집 창 위의 행에 탭으로 나타납니다(그림 4 참조). 편집 창에서 해당 파일을 열려면 탭을 클릭합니다.
수정하기
텍스트 편집 창을 사용하여 파일을 편집합니다. 편집한 파일은 편집 창 아래의 보류 중인 변경 사항 목록에 나타납니다. 수정 사항이 있는 파일의 탭을 실수로 닫은 경우 보류 중인 변경 사항 목록에서 해당 이름을 클릭하여 수정 사항이 그대로 있는 파일을 다시 열 수 있습니다.
변경 사항 제출
Git 소스 편집기에서 변경 사항을 생성하고 Gerrit에 게시합니다. 그런 다음 Gerrit에서 변경 승인을 추적합니다.
변경 사항 생성 및 게시
이 절차에 따라 변경 사항을 만들고 게시하십시오.
해당 버튼을 클릭합니다.
- 새 변경을 만드는 경우 변경 만들기 를 클릭합니다.
- 기존 변경 사항을 업데이트하는 경우 변경 사항 업데이트 를 클릭합니다.
대화 상자가 열립니다.
그림 5. 변경 사항 만들기 대화 상자
Gerrit에서 변경 설명이 될 변경 설명을 입력합니다. 이 설명은 필수입니다. 기존 변경 사항을 편집하는 경우 원하는 경우 해당 설명을 편집할 수 있습니다.
필요 에 따라 생성 시 게시 확인란을 선택 취소하거나 선택합니다.
이 상자는 기본적으로 선택되어 있습니다.
변경 사항을 생성할 때 이 상자를 선택하면 변경 사항이 즉시 Gerrit에 게시됩니다. 상자를 선택하지 않으면 변경 사항이 Gerrit에 업로드되지만 게시되지는 않습니다.
만들기 를 클릭합니다.
변경 사항이 Gerrit에 업로드됩니다. 생성 시 게시 확인란을 선택한 경우 변경 사항이 Gerrit에도 게시됩니다. 변경 사항은 화면 상단의 알림에 링크되어 있습니다.
그림 6. 생성된 알림 변경
Gerrit에서 변경 승인 추적
다른 변경과 마찬가지로 Gerrit에서 직접 변경 제출 상태를 추적합니다.
그림 7. Gerrit에서 변경 제출 상태 추적
파일 비교 보기
편집 창 아래에 있는 Diff 확인란을 선택하여 편집 창에서 활성 상태인 파일에 대해 수행한 편집 내용의 차이점을 확인합니다. 이는 파일을 변경하거나 기존 변경 사항을 편집할 때 유용합니다.
그림 8. 파일 diff 보기
파일 되돌리기
단일 파일 또는 보류 중인 변경 목록의 모든 파일에서 변경 사항을 되돌릴 수 있습니다. 되돌리기 옵션 모두 Git 소스 편집기에서만 변경 사항을 되돌립니다. 그들은 Gerrit의 변경 사항을 업데이트하지 않습니다.
단일 파일 되돌리기
단일 파일을 되돌리려면 보류 중인 변경 사항 목록에서 파일 이름 옆에 있는 X 를 클릭합니다.
그림 9. 보류 중인 변경 사항 섹션
모든 파일 되돌리기
모든 파일을 한 번에 되돌리려면 편집 창 아래의 모든 파일 되돌리기 를 클릭합니다.
그림 10. 모든 파일 되돌리기 버튼
팝업 대화 상자가 열립니다. 보류 중인 모든 파일의 변경 사항을 되돌리려 면 모두 되돌리기 를 클릭하고 변경 사항을 유지하고 편집을 계속하려면 취소 를 클릭합니다.
그림 11. 모든 파일 되돌리기 확인 대화 상자
Android 코드 검색에서 직접 페이지 편집
Android 코드 검색 에서 직접 Git Source Editor에서 파일을 열 수 있습니다. 이것은 편집하기 전에 파일을 찾아야 하는 경우에 유용합니다.
Android 코드 검색에서 직접 파일을 편집하려면 이 절차를 따르십시오.
Android 코드 검색(cs.android.com)에서 편집하려는 파일로 이동합니다.
코드 수정 을 클릭합니다.
그림 12. Android 코드 검색 코드 편집 버튼
편집을 위해 미리 선택된 파일과 함께 Git 소스 편집기가 열립니다.
Git 분기 선택 드롭다운 목록에서 파일을 편집할 Git 분기를 선택한 다음 분기 선택 을 클릭합니다.
그림 13. 편집할 Git 분기 선택
편집 창에서 파일이 열립니다.
편집하기 섹션에 설명된 대로 편집을 계속합니다.
파일 로드 섹션에 설명된 대로 편집할 추가 파일을 열 수 있습니다.
충돌 해결
충돌을 해결하려면:
소스 편집기에서 변경 사항으로 이동합니다. 변경 사항이 로드되면 충돌하는 파일이 화면 하단에 나열됩니다. 예를 들어 그림 14는
Android.pb파일에 충돌이 있음을 보여줍니다.
그림 14. 소스 편집기 충돌
충돌하는 파일을 클릭합니다. 파일이 로드되고 Git 마커(
<<<<<<<및>>>>>>>내에서 충돌하는 콘텐츠 블록이 연속적으로 표시됩니다.
그림 15. 소스 편집기 충돌 마커
파일을 편집하고 유지하려는 콘텐츠 주변의 충돌 마커를 수동으로 제거하여 충돌을 수정합니다. 또한 보관하지 않으려는 콘텐츠에 대한 콘텐츠 및 충돌 마커를 제거하십시오.
새 변경을 만들려면 변경 만들기 를 클릭합니다. 변경 만들기 대화 상자가 나타납니다.
그림 16. 변경 생성
변경 설명을 입력하고 만들기 를 클릭합니다.
피드백 보내기
버그 버튼 사용
오른쪽 상단 모서리에 있는 Git Source Editor에 대한 피드백을 제공합니다.