การอ้างอิงคำสั่งที่เก็บ

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

การใช้ที่เก็บจะมีรูปแบบต่อไปนี้

repo command options

องค์ประกอบที่ระบุหรือไม่ก็ได้จะแสดงในวงเล็บเหลี่ยม [] เช่น คำสั่งหลายรายการจะใช้ project-list เป็นอาร์กิวเมนต์ คุณระบุ project-list ได้ เป็นรายการชื่อหรือรายการเส้นทางไปยังไดเรกทอรีแหล่งที่มาในเครื่องสำหรับ โปรเจ็กต์:

repo sync [project0 project1 ... projectn]
repo sync [/path/to/project0 ... /path/to/projectn]

ความช่วยเหลือ

repo help

ให้ความช่วยเหลือเกี่ยวกับคำสั่ง repo คุณสามารถดูข้อมูลโดยละเอียดเกี่ยวกับ คำสั่ง Repo ที่ระบุคำสั่งเป็นตัวเลือก ดังนี้

repo help command

ตัวอย่างเช่น คำสั่งต่อไปนี้จะแสดงคำอธิบายและรายการตัวเลือกสำหรับคำสั่ง init

repo help init

หรือหากต้องการดูเฉพาะรายการตัวเลือกที่ใช้ได้สําหรับคําสั่ง ให้เรียกใช้

repo command --help

ดังตัวอย่างต่อไปนี้

repo init --help

Init

repo init -u url [options]

ติดตั้ง Repo ในไดเรกทอรีปัจจุบัน คำสั่งนี้จะสร้าง .repo/ ที่มีที่เก็บ Git สำหรับซอร์สโค้ดของที่เก็บและ ไฟล์ Manifest ของ Android แบบมาตรฐาน

ตัวเลือก:

• -u: ระบุ URL ที่จะใช้เรียกข้อมูลที่เก็บไฟล์ Manifest ไฟล์ Manifest ทั่วไปจะอยู่ที่ https://android.googlesource.com/platform/manifest

• -m: เลือกไฟล์ Manifest ภายในที่เก็บ หากไม่มีชื่อไฟล์ Manifest เลือกไว้ ค่าเริ่มต้นคือ default.xml

• -b: ระบุการแก้ไข ซึ่งก็คือ manifest-branch เฉพาะ

ซิงค์

repo sync [project-list]

ดาวน์โหลดการเปลี่ยนแปลงใหม่และอัปเดตไฟล์ที่ทำงานอยู่ในสภาพแวดล้อมในเครื่อง ซึ่งจะทําให้git fetchเสร็จสมบูรณ์ในที่เก็บ Git ทั้งหมด หากคุณเรียกใช้ repo sync โดยไม่ระบุอาร์กิวเมนต์ ระบบจะซิงค์ไฟล์สำหรับโปรเจ็กต์ทั้งหมด

เมื่อคุณเรียกใช้ repo sync นี่คือสิ่งที่เกิดขึ้น

• หากไม่เคยซิงค์โปรเจ็กต์ repo sync จะเท่ากับ git clone ระบบจะคัดลอกสาขาทั้งหมดในที่เก็บระยะไกลไปยังไดเรกทอรีโปรเจ็กต์ในเครื่อง

• หากโปรเจ็กต์เคยซิงค์มาก่อน repo sync จะเทียบเท่ากับ เป็น:

  git remote update
  git rebase origin/branch
  

  โดยที่ branch คือสาขาที่เช็คเอาต์ในปัจจุบันในไดเรกทอรีโปรเจ็กต์ในเครื่อง หากสาขาในเครื่องไม่ได้ติดตามสาขาในที่เก็บข้อมูลระยะไกล ระบบจะไม่ซิงค์โปรเจ็กต์

หลังจากเรียกใช้ repo sync สำเร็จ โค้ดในโปรเจ็กต์ที่ระบุจะเป็น อัปเดตและซิงค์กับโค้ดในที่เก็บระยะไกลแล้ว

ตัวเลือกคีย์

• -c: ดึงข้อมูลเฉพาะสาขาไฟล์ Manifest ปัจจุบันจากเซิร์ฟเวอร์
• -d: เปลี่ยนโปรเจ็กต์ที่ระบุกลับไปเป็นการแก้ไขไฟล์ Manifest ตัวเลือกนี้มีประโยชน์ในกรณีที่โปรเจ็กต์อยู่ในสาขาหัวข้อ แต่จำเป็นต้องแก้ไขไฟล์ Manifest ชั่วคราว
• -f: ดำเนินการซิงค์โปรเจ็กต์อื่นๆ ต่อ แม้ว่าโปรเจ็กต์จะซิงค์ไม่สำเร็จ
• threadcount: แยกการซิงค์ในชุดข้อความต่างๆ สำหรับ เสร็จเร็วขึ้น ระวังอย่าให้เครื่องทำงานหนักเกินไป แต่ปล่อยให้ CPU ทำงานหนักเกินไป สงวนไว้สำหรับงานอื่นๆ หากต้องการดูจํานวน CPU ที่พร้อมใช้งาน ให้เรียกใช้ nproc --all ก่อน
• -q: ทำงานอย่างเงียบๆ ด้วยการระงับข้อความสถานะ
• -s: ซิงค์กับบิลด์ที่ทราบดีตามที่ระบุโดยองค์ประกอบ manifest-server ในไฟล์ Manifest ปัจจุบัน

หากต้องการดูตัวเลือกเพิ่มเติม ให้เรียกใช้ repo help sync

อัปโหลด

repo upload [project-list]

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

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

เมื่อ Gerrit ได้รับข้อมูลออบเจ็กต์ผ่านเซิร์ฟเวอร์ ก็จะเปลี่ยนแต่ละคอมมิตเป็นการเปลี่ยนแปลงเพื่อให้ผู้ตรวจสอบแสดงความคิดเห็นในคอมมิตที่เฉพาะเจาะจงได้ หากต้องการรวมคอมมิตของจุดตรวจสอบหลายรายการเป็นคอมมิตเดียว ให้ใช้ git rebase -i ก่อนที่จะเรียกใช้การอัปโหลด

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

หากต้องการแก้ไขการเปลี่ยนแปลงหลังจากอัปโหลดแล้ว ให้ใช้เครื่องมือ เช่น git rebase -i หรือ git commit --amend เพื่ออัปเดตสัญญาผูกมัดในเครื่อง หลังจากแก้ไขเสร็จแล้ว ให้ทำดังนี้

• ตรวจสอบว่าสาขาที่อัปเดตเป็นสาขาที่เช็คเอาต์อยู่ในปัจจุบัน
• ใช้ repo upload --replace PROJECT เพื่อเปิดเครื่องมือแก้ไขการเปลี่ยนแปลงที่ตรงกัน

• ป้อนรหัสการเปลี่ยนแปลง Gerrit ไว้ในวงเล็บสำหรับแต่ละคอมมิตในชุด

  # Replacing from branch foo
  [ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific...
  [ 2829 ] ec18b4ba Update proto client to support patch set replacements
  # Insert change numbers in the brackets to add a new patch set.
  # To create a new change record, leave the brackets empty.
  

หลังจากอัปโหลดเสร็จแล้ว การเปลี่ยนแปลงจะมีชุดแพตช์เพิ่มเติม

หากต้องการอัปโหลดเฉพาะสาขา Git ที่ตรวจสอบอยู่ในปัจจุบัน ให้ใช้ Flag --current-branch (หรือ --cbr สั้นๆ)

ความแตกต่าง

repo diff [project-list]

แสดงการเปลี่ยนแปลงที่โดดเด่นระหว่างคอมมิตและโครงสร้างการทำงานที่ใช้ git diff

ดาวน์โหลด

repo download target change

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

เช่น หากต้องการดาวน์โหลด change 23823 เป็น ไดเรกทอรี platform/build:

repo download platform/build 23823

การเรียกใช้ repo sync จะนำการคอมมิตที่ดึงข้อมูลด้วย repo download ออก หรือจะตรวจสอบสาขาระยะไกลโดยใช้ git checkout m/main ก็ได้

Forall

repo forall [project-list] -c command

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

• ตั้งชื่อ REPO_PROJECT เป็นชื่อที่ไม่ซ้ำกันของโปรเจ็กต์แล้ว
• REPO_PATH คือเส้นทางที่สัมพันธ์กับรูทของไคลเอ็นต์
• REPO_REMOTE คือชื่อระบบระยะไกลจากไฟล์ Manifest
• REPO_LREV คือชื่อของเวอร์ชันแก้ไขจากไฟล์ Manifest ที่แปลเป็นสาขาการติดตามในเครื่อง ใช้ตัวแปรนี้หากต้องการส่งรีวิชันไฟล์ Manifest ไปยังคําสั่ง Git ที่เรียกใช้จากเครื่อง
• REPO_RREV คือชื่อของเวอร์ชันแก้ไขจากไฟล์ Manifest ตามที่เขียนไว้อย่างตรงทั้งหมดในไฟล์ Manifest

ตัวเลือก:

• -c: คำสั่งและอาร์กิวเมนต์ที่จะดำเนินการ ระบบจะประเมินคำสั่งผ่าน /bin/sh และส่งอาร์กิวเมนต์ต่อจากคำสั่งนั้นผ่านพารามิเตอร์ตำแหน่งของเชลล์
• -p: แสดงส่วนหัวของโปรเจ็กต์ก่อนเอาต์พุตของคำสั่งที่ระบุ ซึ่งทำได้โดยการเชื่อมโยงไปป์กับสตรีม stdin, stdout และ sterr ของคำสั่ง และส่งออกข้อมูลทั้งหมดไปยังสตรีมต่อเนื่องที่แสดงในเซสชันโปรแกรมเลื่อนหน้าเดียว
• -v: แสดงข้อความที่คำสั่งเขียนไปยัง stderr

ลูกพรุน

repo prune [project-list]

ตัด (ลบ) หัวข้อที่ผสานรวมแล้ว

เริ่มต้น

repo start branch-name [project-list]

เริ่มสาขาใหม่สําหรับการพัฒนา โดยเริ่มจากฉบับที่ระบุไว้ในไฟล์ Manifest

อาร์กิวเมนต์ BRANCH_NAME มีคำอธิบายสั้นๆ เกี่ยวกับการเปลี่ยนแปลงที่คุณพยายามทำกับโปรเจ็กต์ หากไม่ทราบ ให้ลองใช้ชื่อ default

อาร์กิวเมนต์ project-list จะระบุโปรเจ็กต์ที่เข้าร่วมสาขาหัวข้อนี้

status

repo status [project-list]

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

หากต้องการดูสถานะของสาขาปัจจุบันเท่านั้น ให้เรียกใช้ repo status . ข้อมูลสถานะจะแสดงตามโปรเจ็กต์ ระบบจะใช้รหัส 2 ตัวอักษรสำหรับไฟล์แต่ละไฟล์ในโปรเจ็กต์

ในคอลัมน์แรก อักษรตัวพิมพ์ใหญ่แสดงให้เห็นว่าพื้นที่ทดลองใช้แตกต่างกันอย่างไร จากสถานะที่คอมมิตล่าสุด

จดหมาย	ความหมาย	คำอธิบาย
-	ไม่มีการเปลี่ยนแปลง	เหมือนกันใน HEAD และดัชนี
ก	เพิ่มแล้ว	ไม่อยู่ใน HEAD ในดัชนี
จ	แก้ไขแล้ว	ใน HEAD แก้ไขในดัชนี
D	ลบแล้ว	อยู่ใน HEAD ไม่อยู่ในดัชนี
R	เปลี่ยนชื่อแล้ว	ไม่อยู่ใน HEAD มีการเปลี่ยนแปลงเส้นทางในดัชนี
C	คัดลอกแล้ว	ไม่อยู่ใน HEAD แต่คัดลอกมาจากส่วนอื่นในดัชนี
T	เปลี่ยนโหมด	เนื้อหาเหมือนกันใน HEAD และดัชนี มีการเปลี่ยนแปลงโหมด
U	ยกเลิกการผสานแล้ว	เกิดความขัดแย้งระหว่าง HEAD กับดัชนี ต้องมีการแก้ไข

ในคอลัมน์ที่ 2 อักษรตัวพิมพ์เล็กจะระบุความแตกต่างระหว่างไดเรกทอรีทํางานกับดัชนี

จดหมาย	ความหมาย	คำอธิบาย
-	ใหม่/ไม่ทราบ	ไม่ได้อยู่ในดัชนี แต่อยู่ใน Work Tree
m	แก้ไขแล้ว	ในดัชนี ในทรีงาน แก้ไขแล้ว
d	ลบแล้ว	ในดัชนี ไม่อยู่ในโครงสร้างงาน

จัดการข้อผิดพลาดเกี่ยวกับรีโป

git commit -a # Commit local changes first so they aren't lost.
repo start branch-name # Start the branch
git reset --hard HEAD@{1} # And reset the branch so that it matches the commit before repo start
repo upload .

ข้อผิดพลาด repo: error: no branches ready for upload จะปรากฏขึ้นเมื่อไม่ได้เรียกใช้คำสั่ง repo start เมื่อเริ่มเซสชัน หากต้องการกู้คืน คุณสามารถตรวจสอบ รหัสคอมมิต แล้วเริ่มต้นสาขาใหม่แล้วรวมรหัสดังกล่าว