โปรเจ็กต์ใน Android Studio มีทุกอย่างที่กำหนดเวิร์กสเปซสำหรับแอป ตั้งแต่ซอร์สโค้ดและชิ้นงานไปจนถึงโค้ดทดสอบและการกำหนดค่าการสร้าง
เมื่อคุณเริ่มโปรเจ็กต์ใหม่ Android Studio จะสร้างโครงสร้างที่จำเป็นสำหรับไฟล์ทั้งหมดและทำให้ไฟล์เหล่านั้นปรากฏในหน้าต่างโปรเจ็กต์ใน Android Studio หากต้องการเปิดหน้าต่าง ให้เลือกดู > หน้าต่างเครื่องมือ > โปรเจ็กต์
หน้านี้จะแสดงภาพรวมของคอมโพเนนต์หลักในโปรเจ็กต์
โมดูล
โมดูลคือคอลเล็กชันของไฟล์ต้นฉบับและการตั้งค่าบิลด์ที่ช่วยให้คุณแบ่งโปรเจ็กต์ออกเป็นหน่วยฟังก์ชันที่แยกกันได้ โปรเจ็กต์อาจมีโมดูลเดียวหรือหลายโมดูลก็ได้ และโมดูลหนึ่งสามารถใช้โมดูลอื่นเป็นข้อกําหนดได้ คุณสามารถสร้าง ทดสอบ และแก้ไขข้อบกพร่องของโมดูลแต่ละรายการได้อย่างอิสระ
โมดูลเพิ่มเติมมีประโยชน์เมื่อสร้างไลบรารีโค้ดภายในโปรเจ็กต์ของคุณเอง หรือเมื่อคุณต้องการสร้างชุดโค้ดและทรัพยากรที่แตกต่างกันสำหรับอุปกรณ์ประเภทต่างๆ เช่น โทรศัพท์และอุปกรณ์ที่สวมใส่ได้ แต่เก็บไฟล์ทั้งหมดไว้ภายในโปรเจ็กต์เดียวกันและแชร์โค้ดบางส่วน
ในการเพิ่มโมดูลใหม่ในโครงการ ให้คลิก ไฟล์ > ใหม่ > โมดูลใหม่
Android Studio มีโมดูล 2-3 ประเภทที่แตกต่างกัน ดังนี้
- โมดูลแอป Android
- มีคอนเทนเนอร์สำหรับซอร์สโค้ด ไฟล์ทรัพยากร และการตั้งค่าระดับแอปของแอป เช่น ไฟล์บิลด์ระดับโมดูลและไฟล์ Manifest ของ Android เมื่อสร้างโปรเจ็กต์ใหม่ โมดูลแอปเริ่มต้นจะมีชื่อว่า "แอป"
Android Studio มีโมดูลแอปประเภทต่อไปนี้
- โทรศัพท์และแท็บเล็ต
- ยานยนต์
- Wear OS
- โทรทัศน์
- เครื่องมือสร้างโปรไฟล์พื้นฐาน
- เปรียบเทียบ
แต่ละโมดูลจะมีไฟล์ที่จำเป็นและเทมเพลตโค้ดบางรายการที่เหมาะกับแอปหรือประเภทอุปกรณ์ที่เกี่ยวข้อง
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มโมดูลได้ที่หัวข้อเพิ่มโมดูลสำหรับอุปกรณ์ใหม่
- โมดูลฟีเจอร์
-
หมายถึงฟีเจอร์แบบแยกส่วนของแอปซึ่งใช้ประโยชน์จากการนำส่งฟีเจอร์ Play ได้ ตัวอย่างเช่น โมดูลฟีเจอร์ช่วยให้คุณมอบฟีเจอร์บางอย่างของแอปแก่ผู้ใช้ได้ตามต้องการหรือเป็นประสบการณ์การใช้งาน Instant ผ่าน Google Play Instant
Android Studio มีโมดูลฟีเจอร์ประเภทต่อไปนี้
- โมดูลฟีเจอร์แบบไดนามิก
- โมดูลคลังฟีเจอร์แบบไดนามิกแบบทันที
ดูข้อมูลเพิ่มเติมได้ที่การนำส่งฟีเจอร์ Play
- โมดูลคลัง
- มีคอนเทนเนอร์สำหรับโค้ดที่นำมาใช้ใหม่ได้ ซึ่งคุณสามารถใช้เป็นทรัพยากร Dependency ในโมดูลอื่นๆ ของแอปหรือนำเข้าไปยังโปรเจ็กต์อื่นๆ ได้ ตามโครงสร้าง โมดูลไลบรารีจะเหมือนกับโมดูลแอป แต่เมื่อสร้างแล้ว จะสร้างไฟล์ที่เก็บถาวรโค้ดแทน APK จึงติดตั้งในอุปกรณ์ไม่ได้
ในหน้าต่างสร้างโมดูลใหม่ Android Studio มีโมดูลไลบรารีประเภทต่อไปนี้
- ไลบรารี Android: มีไฟล์ทุกประเภทที่รองรับในโปรเจ็กต์ Android ยกเว้นโค้ด C++ เนทีฟ รวมถึงซอร์สโค้ด Java และ Kotlin, ทรัพยากร และไฟล์ Manifest ผลลัพธ์การสร้างคือไฟล์ Android Archive (AAR) ที่คุณเพิ่มเป็น Dependency สําหรับโมดูลแอป Android ได้
- ไลบรารีแบบเนทีฟของ Android: มีไฟล์ทุกประเภทที่รองรับในโปรเจ็กต์ Android ซึ่งคล้ายกับไลบรารี Android อย่างไรก็ตาม ไลบรารีเนทีฟของ Android อาจมีซอร์สโค้ด C++ เนทีฟด้วย ผลลัพธ์การสร้างคือไฟล์ Android Archive (AAR) ที่คุณเพิ่มเป็น Dependency สําหรับโมดูลแอป Android ได้
- ไลบรารี Java หรือ Kotlin: มีเฉพาะไฟล์ซอร์ส Kotlin หรือ Java ผลลัพธ์การสร้างคือไฟล์ Java Archive (JAR) ที่คุณเพิ่มเป็น Dependency สำหรับโมดูลแอป Android หรือโปรเจ็กต์ Kotlin หรือ Java อื่นๆ ได้
บางครั้งโมดูลจะเรียกว่าโปรเจ็กต์ย่อย เนื่องจาก Gradle เรียกโมดูลว่าโปรเจ็กต์ด้วย
เมื่อสร้างโมดูลไลบรารีและต้องการเพิ่มเป็นทรัพยากร Dependency ให้กับโมดูลแอป Android คุณต้องประกาศดังนี้
Groovy
dependencies { implementation project(':my-library-module') }
Kotlin
dependencies { implementation(project(":my-library-module")) }
ไฟล์โครงการ
โดยค่าเริ่มต้น Android Studio จะแสดงไฟล์โปรเจ็กต์ในมุมมองAndroid มุมมองนี้ไม่ได้แสดงลำดับชั้นไฟล์จริงบนดิสก์ แต่ระบบจะจัดระเบียบตามข้อบังคับและประเภทไฟล์เพื่อลดความซับซ้อนในการไปยังส่วนต่างๆ ของไฟล์ต้นฉบับหลักของโปรเจ็กต์ โดยซ่อนไฟล์หรือไดเรกทอรีบางรายการที่ไม่ได้ใช้โดยทั่วไป
ความแตกต่างเชิงโครงสร้างบางอย่างระหว่างมุมมอง Android กับโครงสร้างในดิสก์คือมุมมอง Android
- แสดงไฟล์การกําหนดค่าที่เกี่ยวข้องกับการสร้างทั้งหมดของโปรเจ็กต์ในกลุ่มสคริปต์ Gradle ระดับบนสุด
- แสดงไฟล์ Manifest ทั้งหมดสําหรับแต่ละโมดูลในกลุ่มระดับโมดูลเมื่อคุณมีไฟล์ Manifest ที่แตกต่างกันสําหรับผลิตภัณฑ์ย่อยและประเภทบิลด์ที่แตกต่างกัน
- แสดงไฟล์ทรัพยากรทางเลือกทั้งหมดในกลุ่มเดียวแทนที่จะแสดงในโฟลเดอร์แยกกันตามตัวระบุทรัพยากร เช่น ไอคอนตัวเปิดแอปทุกเวอร์ชันที่มีความละเอียดจะแสดงอยู่เคียงข้างกัน
ภายในโมดูลแอป Android แต่ละรายการ ไฟล์จะแสดงในกลุ่มต่อไปนี้
- ไฟล์ Manifest
- มีไฟล์
AndroidManifest.xml - java
- มีไฟล์ซอร์สโค้ด Kotlin และ Java คั่นด้วยชื่อแพ็กเกจ รวมถึงโค้ดทดสอบ JUnit
- res
- มีทรัพยากรที่ไม่ใช่โค้ดทั้งหมด เช่น สตริง UI และรูปภาพบิตแมป โดยแบ่งออกเป็นไดเรกทอรีย่อยที่เกี่ยวข้อง โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับประเภททรัพยากรที่เป็นไปได้ที่ภาพรวมทรัพยากรของแอป
มุมมองโปรเจ็กต์
หากต้องการดูโครงสร้างไฟล์จริงของโปรเจ็กต์ รวมถึงไฟล์ทั้งหมดที่ซ่อนจากมุมมอง Android ให้เลือกโปรเจ็กต์จากเมนูที่ด้านบนของหน้าต่างโปรเจ็กต์
เมื่อเลือกมุมมองโปรเจ็กต์ คุณจะเห็นไฟล์และไดเรกทอรีจำนวนมากขึ้น ซึ่งรวมถึงรายการต่อไปนี้
module-name/-
build/- มีเอาต์พุตการสร้าง
libs/- มีห้องสมุดส่วนตัว
src/- มีไฟล์โค้ดและไฟล์ทรัพยากรทั้งหมดของโมดูลในไดเรกทอรีย่อยต่อไปนี้
androidTest/- มีโค้ดสําหรับการทดสอบเครื่องมือวัดผลที่ทํางานในอุปกรณ์ Android ดูข้อมูลเพิ่มเติมได้ที่ทดสอบใน Android Studio
cpp/- มีโค้ด C หรือ C++ เนทีฟที่ใช้ Java Native Interface (JNI) สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสารประกอบเกี่ยวกับ Android NDK
main/- มีไฟล์ชุดซอร์ส "หลัก" ซึ่งได้แก่ โค้ดและทรัพยากร Android ที่ตัวแปรของบิลด์ทั้งหมดใช้ร่วมกัน (ไฟล์สำหรับตัวแปรของบิลด์อื่นๆ จะอยู่ในไดเรกทอรีย่อย เช่น
src/debug/สำหรับประเภทบิลด์แก้ไขข้อบกพร่อง) ดังนี้AndroidManifest.xml- อธิบายลักษณะของแอปพลิเคชันและคอมโพเนนต์แต่ละรายการ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมไฟล์ Manifest ของแอป
java/- มีแหล่งที่มาของโค้ด Kotlin หรือ Java หรือทั้ง 2 แหล่ง หากแอปมีทั้งซอร์สโค้ด Kotlin และ Java
kotlin/- มีเฉพาะแหล่งที่มาของโค้ด Kotlin
res/- มีทรัพยากรแอปพลิเคชัน เช่น ไฟล์ที่วาดได้และไฟล์สตริง UI ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมทรัพยากรแอป
assets/- มีไฟล์ที่จะคอมไพล์ลงในไฟล์ APK ตามที่เป็นอยู่ เช่น ตำแหน่งนี้เป็นตำแหน่งที่ดีสำหรับพื้นผิวและข้อมูลเกม คุณสามารถไปยังส่วนต่างๆ ของไดเรกทอรีนี้ในลักษณะเดียวกับระบบไฟล์ทั่วไปได้โดยใช้ URI และอ่านไฟล์เป็นสตรีมไบต์โดยใช้
AssetManager
test/- มีโค้ดสำหรับการทดสอบในเครื่องซึ่งทำงานบน JVM ของโฮสต์
build.gradleหรือbuild.gradle.kts(โมดูล)- ส่วนนี้ระบุการกำหนดค่าบิลด์เฉพาะโมดูล
build.gradleคือชื่อไฟล์ที่ถูกต้องหากคุณใช้ Groovy เป็นภาษาสคริปต์บิลด์ และจะเป็นbuild.gradle.ktsหากคุณใช้สคริปต์ Kotlin
build.gradleหรือbuild.gradle.kts(โปรเจ็กต์)- ซึ่งระบุการกำหนดค่าบิลด์ที่ใช้กับโมดูลทั้งหมด
build.gradleเป็นชื่อไฟล์ที่ถูกต้องหากคุณใช้ Groovy เป็นภาษาสคริปต์บิลด์ และจะเป็นbuild.gradle.ktsหากคุณใช้สคริปต์ Kotlin ไฟล์นี้เป็นส่วนสำคัญสำหรับโปรเจ็กต์นี้ ดังนั้นให้คงไฟล์นี้ไว้ในการควบคุมการแก้ไขพร้อมกับซอร์สโค้ดอื่นๆ ทั้งหมดดูข้อมูลเกี่ยวกับไฟล์บิลด์อื่นๆ ได้ที่หัวข้อกำหนดค่าบิลด์
การตั้งค่าโครงสร้างโปรเจ็กต์
หากต้องการเปลี่ยนการตั้งค่าต่างๆ สำหรับโปรเจ็กต์ Android Studio ให้เปิดกล่องโต้ตอบโครงสร้างโปรเจ็กต์โดยคลิกไฟล์ > โครงสร้างโปรเจ็กต์ ซึ่งประกอบด้วยส่วนต่างๆ ต่อไปนี้
- โปรเจ็กต์: ตั้งค่าเวอร์ชันสำหรับ Gradle และปลั๊กอิน Android Gradle รวมถึงชื่อตำแหน่งที่เก็บข้อมูล
- ตำแหน่ง SDK: ตั้งค่าตำแหน่งของ JDK, Android SDK และ Android NDK ที่โปรเจ็กต์ใช้
- ตัวแปร: ช่วยให้คุณแก้ไขตัวแปรที่ใช้ภายในสคริปต์การสร้างได้
-
โมดูล: ช่วยให้คุณแก้ไขการกำหนดค่าบิลด์เฉพาะโมดูลได้ ซึ่งรวมถึง SDK เป้าหมายและ SDK ขั้นต่ำ ลายเซ็นแอป และทรัพยากร Dependency ของไลบรารี หน้าการตั้งค่าของข้อบังคับแต่ละข้อแบ่งออกเป็นแท็บต่อไปนี้
- พร็อพเพอร์ตี้: ระบุเวอร์ชันของ SDK และสร้างเครื่องมือสร้างที่จะใช้เพื่อคอมไพล์โมดูล
- การลงนาม: ระบุใบรับรองที่จะใช้เพื่อลงนามแอป
-
การขึ้นต่อกัน: แสดงรายการทรัพยากร Dependency ของไลบรารี ไฟล์ และโมดูลสำหรับโมดูลนี้ คุณเพิ่ม แก้ไข และลบทรัพยากร Dependency ได้จากแผงนี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ของโมดูลได้ที่กำหนดค่าตัวแปรของบิลด์
-
เวอร์ชันบิลด์: ช่วยให้คุณกำหนดค่าเวอร์ชันและประเภทบิลด์ต่างๆ สำหรับโปรเจ็กต์ได้
-
Flavour: ช่วยให้คุณสร้างFlavour ของบิลด์ได้หลายรายการ โดยที่แต่ละ Flavour จะระบุชุดการตั้งค่าการกําหนดค่า เช่น เวอร์ชัน SDK ขั้นต่ำและเวอร์ชันเป้าหมายของโมดูล รวมถึงรหัสเวอร์ชันและชื่อเวอร์ชัน
ตัวอย่างเช่น คุณอาจกำหนด Flavor 1 รายการที่มี SDK ขั้นต่ำ 21 และ SDK เป้าหมาย 29 และอีก Flavor 1 รายการที่มี SDK ขั้นต่ำ 24 และ SDK เป้าหมาย 33
- ประเภทบิลด์: ช่วยให้คุณสร้างและแก้ไขการกำหนดค่าบิลด์ ตามที่อธิบายไว้ในกำหนดค่าตัวแปรของบิลด์ โดยค่าเริ่มต้น โมดูลทุกรายการจะมีประเภทบิลด์แก้ไขข้อบกพร่องและรุ่น และคุณกำหนดประเภทเพิ่มเติมได้ตามต้องการ
-