โปรแกรมแก้ไขแหล่งที่มาของ Git

ภาพรวม

โปรแกรมแก้ไขซอร์ส Git (ci.android.com/edit) เป็นเครื่องมือบนเบราว์เซอร์สำหรับการแก้ไขไฟล์ใน Android Open Source Project (AOSP) และการอัปโหลดการเปลี่ยนแปลงไปยัง Gerrit มีไว้สำหรับการเปลี่ยนแปลงเล็กๆ น้อยๆ กับไฟล์จำนวนเล็กน้อย และให้ขั้นตอนการทำงานที่เร็วกว่า การดาวน์โหลดซอร์สทรีของ Android คุณควรคุ้นเคยกับกระบวนการทั้งหมดในการส่งการเปลี่ยนแปลงไปยัง AOSP โดยใช้ Git, Repo และ Gerrit ก่อนที่จะใช้ตัวแก้ไขซอร์ส Git

เมื่อคุณแก้ไขไฟล์โดยใช้โปรแกรมแก้ไขซอร์ส Git งานทั้งหมดจะเกิดขึ้นบนเครื่องของคุณ จนกว่าคุณจะอัปโหลดการเปลี่ยนแปลงเพื่อสร้างรายการเปลี่ยนแปลง Gerrit

เข้าสู่ระบบ

1. โหลด Git Source Editor ในเบราว์เซอร์

2. คลิก เข้าสู่ระบบ เพื่อเข้าสู่บัญชีของคุณ

   

   รูปที่ 1 ปุ่มเข้าสู่ระบบ

แก้ไขไฟล์และการเปลี่ยนแปลง

Git Source Editor มีเวิร์กโฟลว์หลักดังนี้:

• แก้ไขไฟล์ที่คุณเลือกตั้งแต่หนึ่งไฟล์ขึ้นไปในสาขาที่คุณเลือก
• แก้ไขการเปลี่ยนแปลง เมื่อคุณแก้ไขการเปลี่ยนแปลง ผลลัพธ์จะขึ้นอยู่กับว่าใครเป็นผู้สร้างการเปลี่ยนแปลง:
  • หากคุณสร้างการเปลี่ยนแปลง การแก้ไข Git Source Editor ของคุณจะได้รับแพตช์ลงในการเปลี่ยนแปลงเป็นชุดแพตช์ใหม่
  • หากมีบุคคลอื่นเป็นผู้สร้างการเปลี่ยนแปลง การแก้ไข Git Source Editor ของคุณจะสร้างการเปลี่ยนแปลงใหม่ที่คุณเป็นเจ้าของ โดยขึ้นอยู่กับการเปลี่ยนแปลงที่คุณโหลด

โหลดสิ่งที่คุณต้องการแก้ไข

เริ่มเซสชันการแก้ไขโดยการโหลดไฟล์หรือการเปลี่ยนแปลง

โหลดไฟล์

1. ป้อน URL ของไฟล์ที่คุณต้องการแก้ไขในกล่อง ไฟล์/เส้นทางการเปลี่ยนแปลง ที่ด้านบนของหน้า

   เส้นทางไฟล์ตัวอย่าง: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. คลิก โหลดไฟล์หรือเปลี่ยนแปลง

   

   รูปที่ 2. กำลังโหลดไฟล์หรือการเปลี่ยนแปลง

   โหลดไฟล์ในบานหน้าต่างตัวแก้ไข บานหน้าต่างนำทางทางด้านซ้ายของบานหน้าต่างตัวแก้ไขคือเบราว์เซอร์ไฟล์ซึ่งจะเปิด repo โดยมีไฟล์ของคุณโหลดไว้ล่วงหน้า

   

   รูปที่ 3 ไฟล์ที่โหลดลงในบานหน้าต่างแก้ไข

คุณสามารถใช้บานหน้าต่างนำทางเพื่อเปิดไฟล์เพิ่มเติมภายใน repo เดียวกันได้ หากคุณเปิดหลายไฟล์ แต่ละไฟล์จะแสดงเป็นแถบในแถวด้านบนบานหน้าต่างแก้ไข คลิกแท็บเพื่อเปิดไฟล์นั้นในบานหน้าต่างแก้ไข

รูปที่ 4. แท็บสำหรับไฟล์ที่โหลด

โหลดการเปลี่ยนแปลง

นำทางไปยังการเปลี่ยนแปลงที่คุณต้องการแก้ไขโดยป้อน URL ของรายการการเปลี่ยนแปลง Gerrit ลงในกล่อง ไฟล์/เส้นทางการเปลี่ยนแปลง ที่ด้านบนของหน้า (ดูรูปที่ 2)

ลิงค์ตัวอย่างการเปลี่ยนแปลง: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

ไฟล์ในการเปลี่ยนแปลงจะเปิดในบานหน้าต่างแก้ไข (ดูรูปที่ 3)

หากการเปลี่ยนแปลงมีหลายไฟล์ แต่ละไฟล์จะปรากฏเป็นแท็บในแถวเหนือบานหน้าต่างแก้ไข (ดูรูปที่ 4) คลิกแท็บเพื่อเปิดไฟล์นั้นในบานหน้าต่างแก้ไข

ทำการแก้ไขของคุณ

แก้ไขไฟล์โดยใช้บานหน้าต่างแก้ไขข้อความ ไฟล์ที่คุณแก้ไขจะปรากฏในรายการการเปลี่ยนแปลงที่รอดำเนินการด้านล่างบานหน้าต่างแก้ไข หากคุณปิดแท็บของไฟล์ที่มีการแก้ไขโดยไม่ได้ตั้งใจ คุณสามารถเปิดไฟล์อีกครั้งโดยที่การแก้ไขยังคงอยู่ โดยคลิกที่ชื่อไฟล์ในรายการการเปลี่ยนแปลงที่รอดำเนินการ

ส่งการเปลี่ยนแปลง

คุณสร้างและเผยแพร่การเปลี่ยนแปลงของคุณไปยัง Gerrit ใน Git Source Editor จากนั้นคุณติดตามการอนุมัติการเปลี่ยนแปลงใน Gerrit

สร้างและเผยแพร่การเปลี่ยนแปลง

ทำตามขั้นตอนนี้เพื่อสร้างและเผยแพร่การเปลี่ยนแปลงที่คุณทำ

1. คลิกปุ่มที่เหมาะสม:

   • คลิก สร้างการเปลี่ยนแปลง หากคุณกำลังสร้างการเปลี่ยนแปลงใหม่
   • คลิก อัปเดตการเปลี่ยนแปลง หากคุณกำลังอัปเดตการเปลี่ยนแปลงที่มีอยู่

   กล่องโต้ตอบจะเปิดขึ้น

   

   รูปที่ 5 กล่องโต้ตอบสร้างการเปลี่ยนแปลง

2. ป้อนคำอธิบายการเปลี่ยนแปลง ซึ่งจะกลายเป็นคำอธิบายการเปลี่ยนแปลงใน Gerrit จำเป็นต้องมีคำอธิบายนี้ หากคุณกำลังแก้ไขการเปลี่ยนแปลงที่มีอยู่ คุณสามารถแก้ไขคำอธิบายได้หากต้องการ

3. ทางเลือก ล้างหรือเลือกกล่องกา เครื่องหมายเผยแพร่เมื่อสร้าง

   กล่องนี้ถูกเลือกไว้ตามค่าเริ่มต้น

   หากเลือกกล่องนี้เมื่อคุณสร้างการเปลี่ยนแปลง การเปลี่ยนแปลงจะถูกเผยแพร่ไปยัง Gerrit ทันที หากไม่ได้เลือกกล่อง การเปลี่ยนแปลงจะถูกอัปโหลดไปยัง Gerrit แต่จะไม่มีการเผยแพร่

4. คลิก สร้าง

   การเปลี่ยนแปลงถูกอัปโหลดไปยัง Gerrit หากคุณเลือกกล่องกา เครื่องหมายเผยแพร่เมื่อสร้าง การเปลี่ยนแปลงจะถูกเผยแพร่ใน Gerrit ด้วย การเปลี่ยนแปลงจะลิงก์อยู่ในการแจ้งเตือนที่ด้านบนของหน้าจอ

   

   รูปที่ 6 เปลี่ยนการแจ้งเตือนที่สร้างขึ้น

ติดตามการอนุมัติการเปลี่ยนแปลงใน Gerrit

ติดตามสถานะการส่งการเปลี่ยนแปลงได้โดยตรงใน Gerrit เช่นเดียวกับที่คุณทำกับการเปลี่ยนแปลงอื่นๆ

รูปที่ 7 การติดตามสถานะการส่งการเปลี่ยนแปลงใน Gerrit

ดูความแตกต่างไฟล์

เลือกช่องทำเครื่องหมาย Diff ใต้บานหน้าต่างแก้ไขเพื่อดูความแตกต่างของการแก้ไขที่คุณทำกับไฟล์ที่ใช้งานอยู่ในบานหน้าต่างแก้ไข สิ่งนี้มีประโยชน์เมื่อเปลี่ยนแปลงไฟล์และเมื่อแก้ไขการเปลี่ยนแปลงที่มีอยู่

รูปที่ 8 ความแตกต่างในการดูไฟล์

แปลงไฟล์กลับ

คุณสามารถคืนค่าการเปลี่ยนแปลงจากไฟล์เดียวหรือจากไฟล์ทั้งหมดในรายการการเปลี่ยนแปลงที่รอดำเนินการได้ ตัวเลือกการย้อนกลับทั้งสองจะคืนค่าการเปลี่ยนแปลงใน Git Source Editor เท่านั้น พวกเขาจะไม่อัปเดตการเปลี่ยนแปลงใน Gerrit

แปลงกลับไฟล์เดียว

หากต้องการแปลงกลับไฟล์เดียว ให้คลิก X ถัดจากชื่อไฟล์ในรายการการเปลี่ยนแปลงที่รอดำเนินการ

รูปที่ 9 ส่วนการเปลี่ยนแปลงที่รอดำเนินการ

คืนค่าไฟล์ทั้งหมด

หากต้องการแปลงไฟล์ทั้งหมดในครั้งเดียว ให้คลิก แปลงไฟล์ทั้งหมด ด้านล่างบานหน้าต่างแก้ไข

รูปที่ 10 ปุ่มย้อนกลับไฟล์ทั้งหมด

กล่องโต้ตอบป๊อปอัปจะเปิดขึ้น คลิก คืนค่าทั้งหมด เพื่อคืนค่าการเปลี่ยนแปลงในไฟล์ที่ค้างอยู่ทั้งหมด หรือคลิก ยกเลิก เพื่อเก็บการเปลี่ยนแปลงและแก้ไขต่อ

รูปที่ 11 กล่องโต้ตอบยืนยันการคืนค่าไฟล์ทั้งหมด

แก้ไขหน้าได้โดยตรงจากการค้นหาโค้ด Android

คุณสามารถเปิดไฟล์ใน Git Source Editor ได้โดยตรงจาก การค้นหาโค้ด Android สิ่งนี้มีประโยชน์หากคุณต้องการค้นหาไฟล์ก่อนทำการแก้ไข

ทำตามขั้นตอนนี้เพื่อแก้ไขไฟล์โดยตรงจากการค้นหาโค้ด Android

1. ใน Android Code Search (cs.android.com) ให้นำทางไปยังไฟล์ที่คุณสนใจที่จะแก้ไข

2. คลิก แก้ไขโค้ด

   

   รูปที่ 12 ปุ่ม แก้ไข การค้นหาโค้ด Android

   Git Source Editor จะเปิดขึ้นพร้อมกับไฟล์ที่เลือกไว้ล่วงหน้าสำหรับการแก้ไข

3. เลือกสาขา Git ที่คุณต้องการแก้ไขไฟล์จากรายการดรอปดาวน์ เลือกสาขา git จากนั้นคลิก เลือกสาขา

   

   รูปที่ 13 การเลือกสาขา Git ที่จะแก้ไข

   ไฟล์จะเปิดขึ้นในบานหน้าต่างแก้ไข

4. แก้ไขต่อไปตามที่อธิบายไว้ในส่วน การแก้ไขของคุณ

5. คุณสามารถเปิดไฟล์เพิ่มเติมเพื่อแก้ไขตามที่อธิบายไว้ในส่วน การโหลดไฟล์

แก้ไขข้อขัดแย้ง

วิธีแก้ไขข้อขัดแย้ง:

1. ใน Source Editor ให้นำทางไปยังการเปลี่ยนแปลง หลังจากที่โหลดการเปลี่ยนแปลงแล้ว ไฟล์ที่ขัดแย้งกันจะแสดงรายการอยู่ที่ส่วนล่างของหน้าจอ ตัวอย่างเช่น รูปที่ 14 แสดงว่าไฟล์ Android.pb มีข้อขัดแย้ง

   

   รูปที่ 14 ข้อขัดแย้งของตัวแก้ไขซอร์ส

2. คลิกไฟล์ที่ขัดแย้งกัน ไฟล์โหลดและแสดงบล็อกเนื้อหาที่ขัดแย้งกันอย่างต่อเนื่องและภายในเครื่องหมาย Git ( <<<<<<< และ >>>>>>> )

   

   รูปที่ 15 เครื่องหมายข้อขัดแย้งของตัวแก้ไขซอร์ส

3. แก้ไขข้อขัดแย้งโดยการแก้ไขไฟล์และลบเครื่องหมายข้อขัดแย้งรอบเนื้อหาที่คุณต้องการเก็บไว้ด้วยตนเอง นอกจากนี้ ให้ลบเนื้อหาและเครื่องหมายข้อขัดแย้งสำหรับเนื้อหาที่คุณไม่ต้องการเก็บไว้

4. คลิก สร้างการเปลี่ยนแปลง เพื่อสร้างการเปลี่ยนแปลงใหม่ กล่องโต้ตอบสร้างการเปลี่ยนแปลงจะปรากฏขึ้น

   

   รูปที่ 16 สร้างการเปลี่ยนแปลง

5. พิมพ์คำอธิบายการเปลี่ยนแปลงแล้วคลิก สร้าง

ส่งความคิดเห็น

ใช้ปุ่มข้อผิดพลาด ที่มุมขวาบนเพื่อแสดงความคิดเห็นเกี่ยวกับ Git Source Editor

เอกสารที่เกี่ยวข้อง

• ค้นหารหัส Android