ทรัพยากร Dependency ของบิลด์คือคอมโพเนนต์ภายนอกที่จำเป็นสำหรับการสร้างโปรเจ็กต์ให้สำเร็จ บิลด์อาจขึ้นอยู่กับไลบรารี, ปลั๊กอิน, โปรเจ็กต์ย่อย, Android SDK, เครื่องมือต่างๆ เช่น คอมไพเลอร์ Kotlin และ Java, สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ เช่น Android Studio และ Gradle เอง
ทรัพยากร Dependency แต่ละรายการอาจต้องใช้ทรัพยากร Dependency อื่นๆ ด้วย เราเรียกสิ่งเหล่านี้ว่าทรัพยากร Dependency แบบสกรรมกริยา และสามารถเพิ่มทรัพยากร Dependency โดยรวมที่แอปพลิเคชันของคุณใช้ได้อย่างรวดเร็ว เมื่อต้องการอัปเกรดทรัพยากร Dependency ไม่ว่าจะเป็นไลบรารี เครื่องมือ หรือ Android SDK การอัปเกรดนั้นอาจส่งผลต่อทรัพยากร Dependency อื่นๆ อีกหลายรายการ
ซึ่งมักจะไม่ก่อให้เกิดปัญหา เนื่องจากไลบรารีจำนวนมากใช้รูปแบบที่เรียกว่าการกำหนดเวอร์ชันตามความหมาย ไลบรารีเหล่านี้จำกัดประเภทการเปลี่ยนแปลงที่ทำเพื่อให้เข้ากันได้กับเวอร์ชันที่ต่ำกว่า
การกำหนดเวอร์ชันทางอรรถศาสตร์จะเป็นไปตามรูปแบบ major.minor.patch ตัวอย่างเช่น ในหมายเลขเวอร์ชัน 4.8.3 เลข 4 คือเวอร์ชันmajor เลข 8 คือเวอร์ชันminor และเลข 3 คือหมายเลขpatch เมื่อส่วน major มีการเปลี่ยนแปลง ไลบรารีอาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบใน API หรือลักษณะการทำงาน ซึ่งอาจส่งผลต่อบิลด์หรือลักษณะการทำงานของแอปพลิเคชัน
เมื่อส่วน minor (ฟีเจอร์ใหม่) หรือ patch (การแก้ไขข้อบกพร่อง) มีการเปลี่ยนแปลง นักพัฒนาไลบรารีจะแจ้งให้คุณทราบว่าไลบรารียังคงเข้ากันได้และไม่ควรส่งผลกระทบต่อแอปพลิเคชันของคุณ
ความสัมพันธ์ในบิลด์ของคุณ
บิลด์ Android มีความสัมพันธ์ระหว่างสิ่งต่อไปนี้
- ซอร์สโค้ด - โค้ดและทรัพยากรที่คุณควบคุมได้
- ทรัพยากร Dependency ของไลบรารี - ไลบรารีหรือโมดูลภายนอกที่โปรเจ็กต์และโปรเจ็กต์ย่อยของคุณรวมไว้เมื่อสร้าง
- เครื่องมือ - คอมไพเลอร์, ปลั๊กอิน และ SDK ที่แปลแหล่งที่มาของคุณเป็นแอปพลิเคชันหรือไลบรารี
ซอร์สโค้ด
ซอร์สโค้ดคือโค้ด Kotlin หรือ Java ที่คุณเขียนในแอปพลิเคชันหรือไลบรารี (ดูรายละเอียดเกี่ยวกับการใช้ C++ ได้ที่ Android NDK)
ซอร์สโค้ดขึ้นอยู่กับไลบรารี (รวมถึงไลบรารีรันไทม์ Kotlin และ Java) และ Android SDK และต้องใช้คอมไพเลอร์ Kotlin หรือ Java ที่เกี่ยวข้อง
ซอร์สโค้ดบางรายการมีคำอธิบายประกอบที่ต้องมีการประมวลผลเพิ่มเติม ตัวอย่างเช่น หากคุณเขียนโค้ด Jetpack Compose คุณจะเพิ่มคำอธิบายประกอบ เช่น @Composable ที่ต้องประมวลผลโดยปลั๊กอินคอมไพเลอร์ Compose Kotlin คำอธิบายประกอบอื่นๆ อาจประมวลผลโดย Kotlin Symbol Processor (KSP) หรือเครื่องมือประมวลผลคำอธิบายประกอบแยกต่างหาก
ทรัพยากร Dependency ของไลบรารี
ไลบรารีมีไบต์โค้ดที่ดึงเข้ามาเป็นส่วนหนึ่งของแอปพลิเคชัน ซึ่งอาจเป็น Java JAR, ไลบรารี Android (AAR) หรือโปรเจ็กต์ย่อยในบิลด์ ไลบรารีจำนวนมากใช้การกำหนดเวอร์ชันเชิงความหมาย ซึ่งจะช่วยให้คุณเข้าใจว่าไลบรารีจะยังคงเข้ากันได้ (หรือไม่) เมื่ออัปเกรด
ไลบรารีมักมีทรัพยากร Dependency แบบทรานซิทีฟในไลบรารีอื่นๆ ซึ่งจะช่วยลดสิ่งที่คุณต้องจัดการอย่างชัดเจน โดยคุณระบุทรัพยากร Dependency โดยตรง แล้ว Gradle จะดึงทรัพยากรเหล่านั้นเข้ามาพร้อมกับทรัพยากร Dependency แบบทรานซิทีฟ การอัปเกรดทรัพยากร Dependency โดยตรงอาจอัปเกรดทรัพยากร Dependency แบบทรานซิทีฟด้วย
บางครั้งไลบรารีอาจต้องใช้ Android SDK เวอร์ชันขั้นต่ำที่รันไทม์ (minSdk) หรือเวลาคอมไพล์ (compileSdk) ซึ่งจำเป็นเมื่อไลบรารีใช้ฟังก์ชันที่รวมอยู่ใน Android SDK หรือ API ของ JDK ที่มีให้ minSdkที่มีผลของแอปพลิเคชันคือminSdkสูงสุดที่แอปพลิเคชันของคุณและทรัพยากร Dependency ของไลบรารีแบบโดยตรงและแบบสกรรมกริยาทั้งหมดร้องขอ
การใช้ไลบรารีบางรายการอาจต้องใช้ปลั๊กอิน Gradle ที่เฉพาะเจาะจง ปลั๊กอินตัวช่วยเหล่านี้มักจะติดตั้ง Kotlin Symbol Processor หรือโปรเซสเซอร์สำหรับคำอธิบายประกอบอื่นๆ ที่สร้างโค้ดหรือแก้ไขการคอมไพล์แหล่งที่มาเพื่อรองรับการใช้ฟีเจอร์ของไลบรารี ตัวอย่างเช่น Jetpack Room มีคำอธิบายประกอบและ KSP ที่แปลงคำอธิบายประกอบเป็นโค้ดที่สร้างขึ้นเพื่อดึงข้อมูลและแก้ไขข้อมูลในฐานข้อมูล Jetpack Compose ต้องใช้ปลั๊กอินคอมไพเลอร์ Compose เพื่อแก้ไขฟังก์ชันที่มีคำอธิบายประกอบเพื่อจัดการวิธีและเวลาที่จะเรียกใช้ฟังก์ชันนั้นอีกครั้ง
เครื่องมือ
Gradle |
Gradle เป็นเครื่องมือบิลด์ที่อ่านไฟล์บิลด์และสร้างแอปพลิเคชันหรือไลบรารี รวมถึงแสดง API สำหรับปลั๊กอินเพื่อขยายความสามารถ Gradle จะเรียกใช้กระบวนการหลายรายการใน Java Virtual Machine อย่างน้อย 1 เครื่อง และปลั๊กอิน Java จะเรียกใช้เครื่องมือ Java ภายใน JDK |
ปลั๊กอิน Gradle |
ปลั๊กอิน Gradle จะขยาย Gradle โดยการกำหนดงานและการกำหนดค่าใหม่ การใช้ปลั๊กอินกับบิลด์จะเปิดใช้ความสามารถของบิลด์ที่เฉพาะเจาะจง ซึ่งกำหนดค่าเป็นข้อมูลในสคริปต์บิลด์ สำหรับบิลด์ Android ปลั๊กอิน Gradle ที่สำคัญที่สุดคือปลั๊กอิน Android Gradle (AGP) |
คอมไพเลอร์ |
คอมไพเลอร์ Kotlin หรือ Java จะแปลงซอร์สโค้ดเป็นไบต์โค้ดที่เรียกใช้ได้ คอมไพเลอร์ Kotlin แสดง API ของปลั๊กอินที่ช่วยให้การวิเคราะห์ภายนอกและการสร้างโค้ดทำงานภายในคอมไพเลอร์ได้โดยตรง โดยเข้าถึงโครงสร้างโค้ดที่แยกวิเคราะห์แล้ว |
ปลั๊กอินคอมไพเลอร์ |
ปลั๊กอินคอมไพเลอร์จะทำการวิเคราะห์และสร้างโค้ดภายในคอมไพเลอร์ Kotlin ขณะที่คอมไพเลอร์ Kotlin กำลังวิเคราะห์โค้ด และจะติดตั้งเมื่อคุณใช้ปลั๊กอิน Gradle กับบิลด์ |
Android SDK |
Android SDK ประกอบด้วยแพลตฟอร์ม Android และ Java API สำหรับ Android เวอร์ชันที่เฉพาะเจาะจง รวมถึงเครื่องมือที่เกี่ยวข้อง เครื่องมือเหล่านี้จะช่วยคุณจัดการ SDK, สร้างแอปพลิเคชัน ตลอดจนสื่อสารและจำลองอุปกรณ์ Android Android SDK แต่ละเวอร์ชันมี Java API ที่เฉพาะเจาะจงซึ่งซอร์สโค้ดของคุณเข้าถึงได้ และการรองรับกระบวนการ Desugaring เพื่อใช้ API เหล่านั้นใน Android เวอร์ชันก่อนหน้า |
JDK |
Java Development Kit ซึ่งมีไลบรารี Java และไฟล์ปฏิบัติการเพื่อคอมไพล์ซอร์สโค้ด Java และเรียกใช้แอปพลิเคชัน Java มี JDK หลายรายการที่ทำงานอยู่ในบิลด์ Android ดูรายละเอียดเพิ่มเติมได้ที่เวอร์ชัน Java ในบิลด์ Android |
ขอบเขต Gradle
Gradle จะจัดกลุ่มทรัพยากร Dependency ของไลบรารีออกเป็นขอบเขตต่างๆ (เรียกว่าการกำหนดค่าใน Gradle API) ซึ่งช่วยให้คุณระบุชุดทรัพยากร Dependency ของไลบรารีที่แตกต่างกันเพื่อใช้ในส่วนต่างๆ ของบิลด์ได้ ตัวอย่างเช่น คุณอาจไม่ต้องการรวมไลบรารีทดสอบ เช่น JUnit ไว้ในแอปพลิเคชันหรือไลบรารีที่เผยแพร่ แต่คุณต้องการไลบรารีดังกล่าวเมื่อสร้างและดำเนินการ Unit Test นอกจากนี้ คุณยังใช้ขอบเขตเพื่อเพิ่มสัญลักษณ์หรือโปรเซสเซอร์สำหรับคำอธิบายประกอบเพื่อวิเคราะห์โค้ดได้ด้วย
ตัวอย่างเช่น AGP กำหนดขอบเขต implementation และ api ซึ่งเป็นวิธีระบุว่าควรแสดงทรัพยากร Dependency ต่อผู้ใช้โปรเจ็กต์ย่อยหรือไม่
ดูคำอธิบายของขอบเขตเหล่านี้และขอบเขตอื่นๆ ที่ใช้ในบิลด์ Android ได้ที่กำหนดค่าทรัพยากร Dependency
เพิ่มทรัพยากร Dependency ของไลบรารีในบล็อก dependencies ของไฟล์บิลด์เป็นสตริง group:artifact:version ดังนี้
Kotlin
// In a module-level build script // explicit dependency strings ("group:artifact:version") dependencies { implementation("com.example:library1:1.2.3") api("com.example:library2:1.1.1") }
ดึงดูด
// In a module-level build script // explicit dependency strings ("group:artifact:version") dependencies { implementation 'com.example:library1:1.2.3' api 'com.example:library2:1.1.1' }
หรือในแคตตาล็อกเวอร์ชัน:
# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"
[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }
[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }
และระบุตัวแปรที่สร้างขึ้นในไฟล์บิลด์ ดังนี้
Kotlin
// In a module-level build script // Using a version catalog plugins { alias(libs.plugins.example.plugin) } dependencies { implementation(libs.example.library) }
ดึงดูด
// In a module-level build script // Using a version catalog plugins { alias(libs.plugins.example.plugin) } dependencies { implementation libs.example.library }