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
คือชื่อระบบระยะไกลจากไฟล์ ManifestREPO_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
เมื่อเริ่มเซสชัน หากต้องการกู้คืน คุณสามารถตรวจสอบ
รหัสคอมมิต แล้วเริ่มต้นสาขาใหม่แล้วรวมรหัสดังกล่าว