โค้ดเนม แท็ก และหมายเลขการสร้าง

รุ่นพัฒนา Android แบ่งออกเป็นกลุ่มต่างๆ โดยมีชื่อรหัสเรียงตามตัวอักษรซึ่งได้รับแรงบันดาลใจจากขนมแสนอร่อย หน้านี้ให้ข้อมูลเกี่ยวกับ ชื่อรหัสแพลตฟอร์ม เวอร์ชัน ระดับ API และการเผยแพร่ NDK พร้อมคำอธิบาย คำจำกัดความของรหัสบิวด์ ที่เกี่ยวข้อง

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

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

ชื่อรหัสแพลตฟอร์ม เวอร์ชัน ระดับ API และการเผยแพร่ NDK

ตารางนี้แสดงรายการชื่อรหัส หมายเลขเวอร์ชันที่เกี่ยวข้อง และระดับ API ที่เกี่ยวข้อง

สร้างคำจำกัดความ ID

ใน Android 8.0.0 (Oreo) และสูงกว่า แต่ละบิลด์จะถูกระบุด้วยรูปแบบ ID บิล ด์ PVBB.YYMMDD.bbb[.Cn] โดยที่:

• P หมายถึงตัวอักษรตัวแรกของชื่อรหัสของแพลตฟอร์มที่ออก เช่น O คือ Oreo
• V แสดงถึงแนวตั้งที่รองรับ ตามแบบแผนแล้ว P แสดงถึงสาขาแพลตฟอร์มหลัก
• BB เป็นรหัสตัวอักษรและตัวเลขที่ช่วยให้ Google สามารถระบุสาขารหัสที่แน่นอนที่ใช้สร้างได้
• YYMMDD ระบุวันที่ที่รีลีสแยกจากหรือซิงค์กับสาขาการพัฒนา ไม่ใช่วันที่ที่แน่นอนในการสร้าง build เสมอไป เนื่องจากเป็นเรื่องปกติที่รูปแบบย่อยที่เพิ่มลงใน build ที่มีอยู่จะใช้โค้ดวันที่เดียวกันกับ build ที่มีอยู่ซ้ำอีกครั้ง
• bbb ระบุแต่ละเวอร์ชันที่เกี่ยวข้องกับรหัสวันที่เดียวกัน โดยเริ่มจาก 001 ตามลำดับ
• Cn เป็นตัวเลือก ตัวอักษรและตัวเลข ที่ระบุฮอตฟิกซ์ที่ด้านบนของบิลด์ PVBB.YYMMDD.bbb ที่มีอยู่ โดยเริ่มจาก A1

Android รุ่นเก่าใช้โค้ด ID บิลด์อื่นที่สั้นกว่า (เช่น FRF85B ) โดยที่:

• ตัวอักษรตัวแรกคือชื่อรหัสของตระกูล release เช่น F คือ Froyo
• ตัวอักษรตัวที่สองคือรหัสสาขาที่ช่วยให้ Google สามารถระบุสาขารหัสที่แน่นอนที่ใช้สร้างได้ ตามแบบแผน R เป็นสาขาการเผยแพร่หลัก
• ตัวอักษรตัวที่สามและตัวเลขสองตัวถัดไปคือรหัสวันที่ ตัวอักษรนับไตรมาส ( A คือ Q1 ปี 2009, F คือ Q2 ปี 2010 และอื่นๆ) ตัวเลขสองตัวจะนับวันภายในไตรมาส ( F85 คือวันที่ 24 มิถุนายน 2553) รหัสวันที่ไม่ใช่วันที่ที่แน่นอนที่สร้างบิลด์เสมอไป เนื่องจากเป็นเรื่องปกติที่รูปแบบย่อยที่เพิ่มลงในบิลด์ที่มีอยู่จะใช้โค้ดวันที่เดียวกันกับบิลด์ที่มีอยู่อีกครั้ง
• ตัวอักษรตัวสุดท้ายระบุแต่ละเวอร์ชันที่เกี่ยวข้องกับรหัสวันที่เดียวกัน ตามลำดับเริ่มต้นด้วย A (ซึ่งโดยนัยและมักจะละไว้เพื่อความกระชับ)

แท็กซอร์สโค้ดและบิลด์

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

สาขา Froyo, Gingerbread, ICS-MR0, ICS-MR1, JB-DEV, JB-MR1-DEV, JB-MR1.1-DEV, JB-MR2-DEV และ KitKat-Dev เป็นตัวแทนสาขาการพัฒนาที่ไม่แน่นอน จับคู่การกำหนดค่าที่ทดสอบโดย Google ดังนั้นสาขาเหล่านี้อาจมีการเปลี่ยนแปลงที่หลากหลายนอกเหนือจากการเผยแพร่อย่างเป็นทางการและอาจไม่ได้รับการทดสอบอย่างละเอียด

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

repo forall -pc 'git log --no-merges --oneline branch-1..branch-2'

ตัวอย่างเช่น:

repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1'

ในการส่งเอาต์พุตไปยังไฟล์ข้อความ:

  repo forall -pc 'git log --no-merges --oneline android-4.4.2_r2..android-4.4.2_r1' > /tmp/android-4.4.2_r2-android-4.4.2_r1-diff.txt

โมดูล Honeycomb GPL

สำหรับ Honeycomb ซอร์สโค้ดแพลตฟอร์มทั้งหมดไม่สามารถใช้ได้ อย่างไรก็ตามส่วนของ Honeycomb ที่ได้รับอนุญาตภายใต้ GPL และ LGPL มีอยู่ภายใต้แท็กต่อไปนี้

ไม่มีรายการที่มีโมดูลเหล่านี้อย่างแน่นอน แต่บางส่วนปรากฏให้เห็นว่าการสร้างส่วนประกอบเหล่านั้น คำสั่งต่อไปนี้ทำงานสำหรับ 3.0_r1.1:

repo init -b main -m base-for-3.0-gpl.xml
repo sync
repo forall -c git checkout android-3.0_r1.1

หากต้องการใช้เวอร์ชันอื่นให้เปลี่ยนพารามิเตอร์ git checkout และ (ถ้าจำเป็น) พารามิเตอร์ -m ใน repo init คำสั่ง git checkout จะแสดงข้อผิดพลาดสำหรับโครงการที่ไม่ใช่ GPL ใด ๆ ที่ไม่พบแท็ก

การอ้างอิงชื่อรหัสและทรัพยากรสำหรับการใช้งานกรณี

ทรัพยากรสำหรับประเภทของข้อมูลชื่อรหัสที่จำเป็นในการรองรับกรณีการใช้งานการตั้งค่าเฉพาะแสดงอยู่ด้านล่าง:

• หากคุณกำลังบูทเข้าสู่โหมด Fastboot (จากอุปกรณ์ที่อยู่ระหว่างการบูตเย็น) คุณต้องใช้ชุดค่าผสมคีย์ที่สอดคล้องกับอุปกรณ์ Android ที่คุณใช้ สำหรับรายชื่ออุปกรณ์ที่มี ชื่อรหัสอุปกรณ์ Android ที่สอดคล้องกัน (ตัวอย่างเช่น Nexus 5X เป็นชื่อรหัส Bullhead และใช้การรวมคีย์ที่เฉพาะเจาะจง) ดู การบูตเข้าสู่โหมดการบูตเร็ว เพื่อรับชุดค่าผสมคีย์ที่คุณต้องการ
• หากงานสร้างของคุณต้องการแหล่งที่มาจากที่เก็บ GIT หลายแห่งให้ใช้วิธี repo เพื่อดาวน์โหลดแหล่งที่มาและสร้างเครื่องมือ สิ่งนี้ทำให้มั่นใจได้ว่าการตั้งค่าไดเรกทอรีแหล่งที่ถูกต้อง หากต้องการรับชื่อ BRANCH สำหรับเคอร์เนลที่คุณต้องการดู การดาวน์โหลดแหล่งที่มาและสร้างเครื่องมือ สำหรับรายการการจับคู่ชื่อรหัสอุปกรณ์ (เช่น Pixel 5-Redfin), อ้างอิงข้ามไปยังเส้นทางไบนารีในต้นไม้ AOSP และสาขา repo ที่สอดคล้องกัน

การพัฒนา Android มีการจัดระเบียบเป็นครอบครัวโดยมีรหัสชื่อตัวอักษรที่ได้รับแรงบันดาลใจจากขนมอร่อย หน้านี้ให้ข้อมูลเกี่ยวกับ ชื่อโค้ดแพลตฟอร์มรุ่นระดับ API และการเผยแพร่ NDK พร้อมคำอธิบายของ คำจำกัดความของ Build ID ที่เกี่ยวข้อง

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

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

ชื่อรหัสแพลตฟอร์มรุ่นระดับ API และ NDK เปิดตัว

ตารางนี้แสดงชื่อรหัสชื่อหมายเลขเวอร์ชันที่เกี่ยวข้องและระดับ API ที่เกี่ยวข้อง

สร้างคำจำกัดความ ID

ใน Android 8.0.0 (Oreo) และสูงกว่าการสร้างแต่ละรายการจะถูกระบุด้วยรูปแบบ การสร้าง ID pvbb.yymmdd.bbb [.cn]

• P หมายถึงตัวอักษรตัวแรกของชื่อรหัสของการเปิดตัวแพลตฟอร์มตัวอย่างเช่น o คือ Oreo
• V หมายถึงแนวตั้งที่รองรับ โดยการประชุม P หมายถึงสาขาแพลตฟอร์มหลัก
• BB เป็นรหัสตัวอักษรและตัวเลขที่อนุญาตให้ Google ระบุสาขารหัสที่แน่นอนที่สร้างขึ้นมา
• Yymmdd ระบุวันที่เมื่อการเปิดตัวถูกแยกออกจากหรือซิงค์กับสาขาการพัฒนา It's not always the exact date at which a build was made as it's common for minor variations added to an existing build to re-use the same date code as the existing build.
• bbb identifies individual versions related to the same date code, sequentially starting with 001 .
• Cn is an optional, alphanumeric that identifies a hotfix on top of an existing PVBB.YYMMDD.bbb build, starting from A1 .

Older Android releases use a different, shorter build ID code (for example, FRF85B ) where:

• The first letter is the codename of the release family, for example, F is Froyo.
• The second letter is a branch code that allows Google to identify the exact code branch the build was made from. By convention, R is the primary release branch.
• The third letter and following two numbers are a date code. The letter counts quarters ( A is Q1 2009, F is Q2 2010, and so on). The two numbers count days within the quarter ( F85 is June 24, 2010). The date code isn't always the exact date at which a build was made as it's common for minor variations added to an existing build to re-use the same date code as the existing build.
• The last letter identifies individual versions related to the same date code, sequentially starting with A (which is implicit and usually omitted for brevity).

Source code tags and builds

Starting with Donut, the exact list of tags and builds is in the following table. The build ID provides information such as the platform release, code branch, and date the release was branched from or synced with the development branch.