ตัวแก้ไขแหล่งที่มา Git

ภาพรวม

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

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

เข้าสู่ระบบ

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

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

   

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

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

เครื่องมือแก้ไขซอร์สโค้ด Git มีเวิร์กโฟลว์หลักต่อไปนี้

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

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

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

โหลดไฟล์

1. ป้อน URL ของไฟล์ที่ต้องการแก้ไขในช่อง file/change path ที่ด้านบนของหน้า

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

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

   

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

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

   

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

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

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

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

ไปยังการเปลี่ยนแปลงที่ต้องการแก้ไขโดยป้อน URL ของรายการการเปลี่ยนแปลง Gerrit ในช่อง file/change path ที่ด้านบนของหน้า (ดูรูปที่ 2)

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

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

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

ทำการแก้ไข

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

ส่งข้อมูลการเปลี่ยนแปลง

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

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

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

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

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

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

   

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

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

3. เลือกหรือยกเลิกการเลือกช่องทำเครื่องหมายเผยแพร่เมื่อสร้าง (ไม่บังคับ)

   ช่องนี้จะเลือกไว้โดยค่าเริ่มต้น

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

4. คลิกสร้าง

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

   

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

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

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

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

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

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

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

เปลี่ยนไฟล์กลับ

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

เปลี่ยนไฟล์เดียวกลับ

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

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

เปลี่ยนกลับไฟล์ทั้งหมด

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

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

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

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

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

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

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

1. ใน Android Code Search (cs.android.com) ให้ไปที่ไฟล์ที่ต้องการแก้ไข

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

   

   รูปที่ 12 ปุ่มแก้ไขโค้ดของ Android Code Search

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

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

   

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

   ไฟล์จะเปิดในแผงแก้ไข

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

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

แก้ไขความขัดแย้ง

วิธีแก้ไขความขัดแย้ง

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

   

   รูปที่ 14 ตัวแก้ไขแหล่งที่มาทับซ้อนกัน

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

   

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

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

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

   

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

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

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

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

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

• การค้นหาโค้ด Android