การทำงานกับโค้ด Android ต้องใช้ทั้ง Git (ระบบควบคุมเวอร์ชันโอเพ่นซอร์ส) และ Repo (เครื่องมือการจัดการพื้นที่เก็บข้อมูลที่ Google สร้างขึ้นซึ่งทำงานบน Git) ดูหน้า เวิร์กโฟลว์การควบคุมแหล่งที่มา เพื่อดูสรุปการดำเนินการปกติที่คุณสามารถทำได้ เช่น การอัปโหลดการเปลี่ยนแปลงเพื่อตรวจสอบ
คอมไพล์
Git จัดการโปรเจ็กต์ขนาดใหญ่ที่กระจายอยู่ในที่เก็บข้อมูลหลายแห่ง Android ใช้ Git สำหรับการดำเนินการในเครื่อง เช่น การแตกสาขาในเครื่อง คอมมิต ความแตกต่าง และการแก้ไข ความท้าทายอย่างหนึ่งในการตั้งค่าโครงการ Android คือการกำหนดวิธีการสนับสนุนชุมชนภายนอกได้ดีที่สุด ตั้งแต่ชุมชนมือสมัครเล่นไปจนถึง OEM ขนาดใหญ่ที่สร้างอุปกรณ์สำหรับผู้บริโภคในตลาดมวลชน Google ต้องการให้ส่วนประกอบต่างๆ สามารถทดแทนได้ และต้องการให้ส่วนประกอบที่น่าสนใจมีชีวิตเป็นของตัวเอง นอกเหนือจาก Android ขั้นแรก Google เลือกระบบควบคุมการแก้ไขแบบกระจาย จากนั้นจำกัดให้แคบลงเหลือ Git
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Git โปรดดูที่ เอกสาร Git นี้
ซื้อซ้ำ
Repo รวมที่เก็บ Git เมื่อจำเป็น อัปโหลดไปยัง ระบบควบคุมการแก้ไข Gerrit และทำให้บางส่วนของขั้นตอนการพัฒนา Android เป็นอัตโนมัติ
Repo Launcher มีสคริปต์ Python ที่เริ่มต้นการชำระเงินและดาวน์โหลดส่วนที่สอง ซึ่งเป็นเครื่องมือ Repo เต็มรูปแบบ เครื่องมือ Repo แบบเต็มจะรวมอยู่ในการชำระเงินซอร์สโค้ดของ Android ตามค่าเริ่มต้นจะอยู่ใน $SRCDIR/.repo/repo/...
และรับคำสั่งที่ส่งต่อจาก Repo Launcher ที่ดาวน์โหลด
Repo ไม่ได้มาแทนที่ Git เพียงแต่ช่วยให้ทำงานกับ Git ในบริบทของ Android ได้ง่ายขึ้นเท่านั้น Repo ใช้ ไฟล์ Manifest เพื่อรวมโปรเจ็กต์ Git ไว้ในซูเปอร์โปรเจ็กต์ Android คุณสามารถใส่คำสั่ง repo
ซึ่งเป็นสคริปต์ Python ที่สามารถเรียกใช้งานได้ได้ทุกที่ในเส้นทางของคุณ ในการทำงานกับไฟล์ต้นฉบับของ Android คุณสามารถใช้ Repo สำหรับการดำเนินการข้ามเครือข่าย เช่น ด้วยไดเร็กทอรีการทำงาน Repo เดียว
ในสถานการณ์ส่วนใหญ่ คุณสามารถใช้ Git แทน Repo หรือผสมคำสั่ง Repo และ Git เพื่อสร้างคำสั่งที่ซับซ้อนได้ อย่างไรก็ตาม การใช้ Repo สำหรับการดำเนินงานข้ามเครือข่ายขั้นพื้นฐานทำให้งานของคุณง่ายขึ้นมาก สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Repo โปรดดู การอ้างอิงคำสั่ง Repo , Repo README , Preupload Hooks (การทดสอบ) ที่สามารถเปิดใช้งานใน Repo และ เอกสารทั่วไปใน AOSP
หากต้องการดาวน์โหลดและติดตั้ง Repo Launcher จาก git-repo- downloads โปรดดูที่ การติดตั้ง Repo
เกอร์ริท
Gerrit คือระบบตรวจสอบโค้ดบนเว็บสำหรับโปรเจ็กต์ที่ใช้ Git Gerrit สนับสนุนการใช้ Git แบบรวมศูนย์มากขึ้นโดยอนุญาตให้ผู้ใช้ที่ได้รับอนุญาตทั้งหมดส่งการเปลี่ยนแปลง ซึ่งจะถูกรวมเข้าด้วยกันโดยอัตโนมัติหากพวกเขาผ่านการตรวจสอบโค้ด นอกจากนี้ Gerrit ยังทำให้การตรวจสอบเป็นเรื่องง่าย โดยแสดงการเปลี่ยนแปลงควบคู่กันในเบราว์เซอร์ และเปิดใช้งานความคิดเห็นแบบอินไลน์
ค้นหาอินเทอร์เฟซการตรวจสอบ Android Gerrit ได้ที่ android-review.googlesource.com และอินเทอร์เฟซการนำทางโค้ดที่ android.googlesource.com
ค้นหารหัส Android
Android Code Search ช่วยให้คุณค้นหา AOSP โดยไม่ต้องดาวน์โหลดอะไรเลย คุณสามารถใช้การค้นหาโค้ดเพื่อดูซอร์สโค้ด AOSP สลับระหว่างสาขาโอเพ่นซอร์ส และนำทางการอ้างอิงโยง สำหรับข้อมูลเพิ่มเติม โปรดดูที่ไซต์ Google Developers สำหรับ เอกสารประกอบการค้นหาโค้ด
เครื่องมืออื่นๆ
Android Studio คือสภาพแวดล้อมการพัฒนาแบบรวมอย่างเป็นทางการ (IDE) สำหรับการพัฒนาแอป Android
Android Debug Bridge (ADB) ช่วยให้คุณเชื่อมต่อเวิร์กสเตชันการพัฒนากับอุปกรณ์ Android ได้โดยตรง เพื่อให้คุณติดตั้งแพ็กเกจและประเมินการเปลี่ยนแปลงได้
สำหรับการพัฒนา AOSP ให้ใช้ Android Studio สำหรับแพลตฟอร์ม (ASfP)
กำลังติดตั้ง Repo
ทำตามขั้นตอนเหล่านี้เพื่อติดตั้ง Repo
- เรียกใช้คำสั่งเหล่านี้เพื่อใช้แพ็คเกจอย่างเป็นทางการจากการกระจาย Linux ของคุณ:
sudo apt-get update
sudo apt-get install repo
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
- รันคำสั่งนี้:
- คาดหวังรายงานที่คล้ายกับสิ่งนี้:
- หมายเลข
repo launcher version
ที่รายงานเป็น 2.15 หรือสูงกว่า ระบุหมายเลขเวอร์ชันที่ถูกต้องและการติดตั้งที่เหมาะสม -
(from /usr/bin/repo)
ระบุการติดตั้งจากแพ็คเกจ -
(from /home/<>/bin/repo)
ระบุการติดตั้งด้วยตนเอง
คำสั่งเหล่านี้ตั้งค่าไฟล์ชั่วคราว ดาวน์โหลด repo ลงไป และตรวจสอบว่าคีย์ที่ให้มานั้นตรงกับคีย์ที่ต้องการ หากสำเร็จ การติดตั้งจะดำเนินต่อไป
หลังการติดตั้ง ให้ตรวจสอบว่า repo version
รายงานสิ่งที่คล้ายกับต่อไปนี้เมื่อทำงานในไดเร็กทอรีปกติ (ไดเร็กทอรีปกติไม่ได้เป็นส่วนหนึ่งของไคลเอ็นต์ repo ตัวอย่างเช่น เป็นไดเร็กทอรีหลักของคุณ)
repo version
<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
เสร็จสิ้นการติดตั้ง
ถัดไป: เพื่อให้การติดตั้ง Repo Tool เสร็จสมบูรณ์ โปรดดูที่ การเริ่มต้นไคลเอนต์ Repo ในหน้า การดาวน์โหลดซอร์ส
,การทำงานกับโค้ด Android ต้องใช้ทั้ง Git (ระบบควบคุมเวอร์ชันโอเพ่นซอร์ส) และ Repo (เครื่องมือการจัดการพื้นที่เก็บข้อมูลที่ Google สร้างขึ้นซึ่งทำงานบน Git) ดูหน้า เวิร์กโฟลว์การควบคุมแหล่งที่มา เพื่อดูสรุปการดำเนินการปกติที่คุณสามารถทำได้ เช่น การอัปโหลดการเปลี่ยนแปลงเพื่อตรวจสอบ
คอมไพล์
Git จัดการโปรเจ็กต์ขนาดใหญ่ที่กระจายอยู่ในที่เก็บข้อมูลหลายแห่ง Android ใช้ Git สำหรับการดำเนินการในเครื่อง เช่น การแตกสาขาในเครื่อง คอมมิต ความแตกต่าง และการแก้ไข ความท้าทายอย่างหนึ่งในการตั้งค่าโครงการ Android คือการกำหนดวิธีการสนับสนุนชุมชนภายนอกได้ดีที่สุด ตั้งแต่ชุมชนมือสมัครเล่นไปจนถึง OEM ขนาดใหญ่ที่สร้างอุปกรณ์สำหรับผู้บริโภคในตลาดมวลชน Google ต้องการให้ส่วนประกอบต่างๆ สามารถทดแทนได้ และต้องการให้ส่วนประกอบที่น่าสนใจมีชีวิตเป็นของตัวเอง นอกเหนือจาก Android ขั้นแรก Google เลือกระบบควบคุมการแก้ไขแบบกระจาย จากนั้นจำกัดให้แคบลงเหลือ Git
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Git โปรดดูที่ เอกสาร Git นี้
ซื้อซ้ำ
Repo รวมที่เก็บ Git เมื่อจำเป็น อัปโหลดไปยัง ระบบควบคุมการแก้ไข Gerrit และทำให้บางส่วนของขั้นตอนการพัฒนา Android เป็นอัตโนมัติ
Repo Launcher มีสคริปต์ Python ที่เริ่มต้นการชำระเงินและดาวน์โหลดส่วนที่สอง ซึ่งเป็นเครื่องมือ Repo เต็มรูปแบบ เครื่องมือ Repo แบบเต็มจะรวมอยู่ในการชำระเงินซอร์สโค้ดของ Android ตามค่าเริ่มต้นจะอยู่ใน $SRCDIR/.repo/repo/...
และรับคำสั่งที่ส่งต่อจาก Repo Launcher ที่ดาวน์โหลด
Repo ไม่ได้มาแทนที่ Git เพียงแต่ช่วยให้ทำงานกับ Git ในบริบทของ Android ได้ง่ายขึ้นเท่านั้น Repo ใช้ ไฟล์ Manifest เพื่อรวมโปรเจ็กต์ Git ไว้ในซูเปอร์โปรเจ็กต์ Android คุณสามารถใส่คำสั่ง repo
ซึ่งเป็นสคริปต์ Python ที่สามารถเรียกใช้งานได้ได้ทุกที่ในเส้นทางของคุณ ในการทำงานกับไฟล์ต้นฉบับของ Android คุณสามารถใช้ Repo สำหรับการดำเนินการข้ามเครือข่าย เช่น ด้วยไดเร็กทอรีการทำงาน Repo เดียว
ในสถานการณ์ส่วนใหญ่ คุณสามารถใช้ Git แทน Repo หรือผสมคำสั่ง Repo และ Git เพื่อสร้างคำสั่งที่ซับซ้อนได้ อย่างไรก็ตาม การใช้ Repo สำหรับการดำเนินงานข้ามเครือข่ายขั้นพื้นฐานทำให้งานของคุณง่ายขึ้นมาก สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Repo โปรดดู การอ้างอิงคำสั่ง Repo , Repo README , Preupload Hooks (การทดสอบ) ที่สามารถเปิดใช้งานใน Repo และ เอกสารทั่วไปใน AOSP
หากต้องการดาวน์โหลดและติดตั้ง Repo Launcher จาก git-repo- downloads โปรดดูที่ การติดตั้ง Repo
เกอร์ริท
Gerrit คือระบบตรวจสอบโค้ดบนเว็บสำหรับโปรเจ็กต์ที่ใช้ Git Gerrit สนับสนุนการใช้ Git แบบรวมศูนย์มากขึ้นโดยอนุญาตให้ผู้ใช้ที่ได้รับอนุญาตทั้งหมดส่งการเปลี่ยนแปลง ซึ่งจะถูกรวมเข้าด้วยกันโดยอัตโนมัติหากพวกเขาผ่านการตรวจสอบโค้ด นอกจากนี้ Gerrit ยังทำให้การตรวจสอบเป็นเรื่องง่าย โดยแสดงการเปลี่ยนแปลงควบคู่กันในเบราว์เซอร์ และเปิดใช้งานความคิดเห็นแบบอินไลน์
ค้นหาอินเทอร์เฟซการตรวจสอบ Android Gerrit ได้ที่ android-review.googlesource.com และอินเทอร์เฟซการนำทางโค้ดที่ android.googlesource.com
ค้นหารหัส Android
Android Code Search ช่วยให้คุณค้นหา AOSP โดยไม่ต้องดาวน์โหลดอะไรเลย คุณสามารถใช้การค้นหาโค้ดเพื่อดูซอร์สโค้ด AOSP สลับระหว่างสาขาโอเพ่นซอร์ส และนำทางการอ้างอิงโยง สำหรับข้อมูลเพิ่มเติม โปรดดูที่ไซต์ Google Developers สำหรับ เอกสารประกอบการค้นหาโค้ด
เครื่องมืออื่นๆ
Android Studio คือสภาพแวดล้อมการพัฒนาแบบรวมอย่างเป็นทางการ (IDE) สำหรับการพัฒนาแอป Android
Android Debug Bridge (ADB) ช่วยให้คุณเชื่อมต่อเวิร์กสเตชันการพัฒนากับอุปกรณ์ Android ได้โดยตรง เพื่อให้คุณติดตั้งแพ็กเกจและประเมินการเปลี่ยนแปลงได้
สำหรับการพัฒนา AOSP ให้ใช้ Android Studio สำหรับแพลตฟอร์ม (ASfP)
กำลังติดตั้ง Repo
ทำตามขั้นตอนเหล่านี้เพื่อติดตั้ง Repo
- เรียกใช้คำสั่งเหล่านี้เพื่อใช้แพ็คเกจอย่างเป็นทางการจากการกระจาย Linux ของคุณ:
sudo apt-get update
sudo apt-get install repo
export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
- รันคำสั่งนี้:
- คาดหวังรายงานที่คล้ายกับสิ่งนี้:
- หมายเลข
repo launcher version
ที่รายงานเป็น 2.15 หรือสูงกว่า ระบุหมายเลขเวอร์ชันที่ถูกต้องและการติดตั้งที่เหมาะสม -
(from /usr/bin/repo)
ระบุการติดตั้งจากแพ็คเกจ -
(from /home/<>/bin/repo)
ระบุการติดตั้งด้วยตนเอง
คำสั่งเหล่านี้ตั้งค่าไฟล์ชั่วคราว ดาวน์โหลด repo ลงไป และตรวจสอบว่าคีย์ที่ให้มานั้นตรงกับคีย์ที่ต้องการ หากสำเร็จ การติดตั้งจะดำเนินต่อไป
หลังการติดตั้ง ให้ตรวจสอบว่า repo version
รายงานสิ่งที่คล้ายกับต่อไปนี้เมื่อทำงานในไดเร็กทอรีปกติ (ไดเร็กทอรีปกติไม่ได้เป็นส่วนหนึ่งของไคลเอ็นต์ repo ตัวอย่างเช่น เป็นไดเร็กทอรีหลักของคุณ)
repo version
<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
เสร็จสิ้นการติดตั้ง
ถัดไป: เพื่อให้การติดตั้ง Repo Tool เสร็จสมบูรณ์ โปรดดูที่ การเริ่มต้นไคลเอนต์ Repo ในหน้า การดาวน์โหลดซอร์ส