เครื่องมือควบคุมแหล่งที่มา

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

Git

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

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Git โปรดดู เอกสารประกอบ Git นี้

Repo

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 Command Reference , Repo README , Preupload Hooks (การทดสอบ) ที่สามารถเปิดใช้งานใน Repo และ เอกสารทั่วไปใน AOSP

หากต้องการดาวน์โหลดและติดตั้ง Repo Launcher จาก การดาวน์โหลด git- repo โปรดดู การติดตั้ง Repo

Gerrit

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

ค้นหาอินเทอร์เฟซการตรวจสอบ Android Gerrit ที่ android-review.googlesource.com และอินเทอร์เฟซการนำทางโค้ดที่ android.googlesource.com

ค้นหารหัส Android

Android Code Search ให้คุณค้นหา AOSP โดยไม่ต้องดาวน์โหลดอะไรเลย คุณสามารถใช้ Code Search เพื่อดูซอร์สโค้ด AOSP สลับระหว่างสาขาโอเพ่นซอร์ส และนำทางไปยังการอ้างอิงโยง สำหรับข้อมูลเพิ่มเติม โปรดดูที่ไซต์ Google Developers สำหรับ เอกสารประกอบการค้นหาโค้ด

เครื่องมืออื่นๆ

Android Studio คือสภาพแวดล้อมการพัฒนาแบบบูรณาการอย่างเป็นทางการ (IDE) สำหรับการพัฒนาแอพ Android

Android Debug Bridge (ADB) ให้คุณเชื่อมต่อเวิร์กสเตชันการพัฒนาของคุณกับอุปกรณ์ Android ของคุณได้โดยตรง คุณจึงสามารถติดตั้งแพ็คเกจและประเมินการเปลี่ยนแปลงของคุณได้

สำหรับ Android 10 ขึ้นไป ให้ใช้ IntelliJ พร้อม AIDEgen IDE สำหรับการพัฒนาแพลตฟอร์ม Android

การติดตั้ง Repo

ทำตามขั้นตอนเหล่านี้เพื่อติดตั้ง Repo

1. เรียกใช้คำสั่งเหล่านี้เพื่อใช้แพ็คเกจอย่างเป็นทางการจากการแจกจ่าย Linux ของคุณ:

     sudo apt-get update
     sudo apt-get install repo
   

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

   export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
   curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
   gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
   curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
   

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

หลังการติดตั้ง ให้ตรวจสอบว่า repo version รายงานสิ่งที่คล้ายกับต่อไปนี้เมื่อทำงานในไดเร็กทอรีปกติ (ไดเร็กทอรีปกติไม่ได้เป็นส่วนหนึ่งของไคลเอ็นต์ repo เช่น เป็นโฮมไดเร็กทอรีของคุณ)

2. เรียกใช้คำสั่งนี้:

repo version

3. คาดหวังรายงานที่คล้ายกับรายงานนี้:

<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)

• หมายเลข repo launcher version ที่รายงานเป็น 2.15 หรือสูงกว่า ระบุหมายเลขเวอร์ชันที่ถูกต้องและการติดตั้งที่เหมาะสม
• (from /usr/bin/repo) หมายถึงการติดตั้งจากแพ็คเกจ
• (from /home/<>/bin/repo) หมายถึงการติดตั้งด้วยตนเอง

เสร็จสิ้นการติดตั้ง

ถัดไป: หากต้องการทำการติดตั้ง Repo Tool แบบสมบูรณ์ โปรดดู ที่ Initializing a Repo client ในหน้า Download the Source