หน้านี้อธิบายการตั้งค่าแอปที่มีประโยชน์ในไฟล์ build.gradle.kts ระดับโมดูล นอกเหนือจากการให้ภาพรวมของพร็อพเพอร์ตี้สำคัญที่ตั้งค่าไว้ในไฟล์ build.gradle.kts แล้ว คุณยังจะได้ดูวิธีทำสิ่งต่อไปนี้ด้วย
- เปลี่ยนรหัสแอปพลิเคชันสำหรับการกำหนดค่าบิลด์ต่างๆ
- ปรับเนมสเปซได้อย่างปลอดภัยโดยไม่ขึ้นอยู่กับรหัสแอปพลิเคชัน
ตั้งค่ารหัสแอปพลิเคชัน
แอป Android ทุกแอปมีรหัสแอปพลิเคชันที่ไม่ซ้ำกันซึ่งมีลักษณะเหมือนชื่อแพ็กเกจ Java หรือ Kotlin เช่น com.example.myapp รหัสนี้จะช่วยระบุแอปของคุณได้แบบไม่ซ้ำกันบนอุปกรณ์และใน Google Play Store
รหัสแอปพลิเคชันจะกำหนดโดยพร็อพเพอร์ตี้ applicationId ในไฟล์ build.gradle.kts ของโมดูล ดังที่แสดงที่นี่ อัปเดตค่าของ applicationId โดยแทนที่ com.example.myapp ด้วยรหัสแอปของคุณ:
Kotlin
android { defaultConfig { applicationId = "com.example.myapp" minSdk = 15 targetSdk = 24 versionCode = 1 versionName = "1.0" } ... }
ดึงดูด
android { defaultConfig { applicationId "com.example.myapp" minSdkVersion 15 targetSdkVersion 24 versionCode 1 versionName "1.0" } ... }
แม้ว่ารหัสแอปพลิเคชันจะดูเหมือนชื่อแพ็กเกจ Kotlin หรือ Java แบบดั้งเดิม แต่กฎการตั้งชื่อรหัสแอปพลิเคชันจะเข้มงวดกว่าเล็กน้อย ดังนี้
- ต้องมีอย่างน้อย 2 ส่วน (มีจุดอย่างน้อย 1 จุด)
- แต่ละกลุ่มต้องขึ้นต้นด้วยตัวอักษร
- อักขระทั้งหมดต้องเป็นตัวอักษรและตัวเลขคละกันหรือขีดล่าง [a-zA-Z0-9_]
เมื่อคุณสร้างโปรเจ็กต์ใหม่ใน Android Studio ระบบจะกำหนดชื่อแพ็กเกจที่คุณเลือกในระหว่างการตั้งค่าให้กับ applicationId โดยอัตโนมัติ ในทางเทคนิคแล้ว คุณสามารถสลับพร็อพเพอร์ตี้ทั้ง 2 รายการแยกกันได้นับจากนั้นเป็นต้นไป แต่เราไม่แนะนำให้ทำเช่นนั้น
เราขอแนะนำให้คุณทำดังต่อไปนี้เมื่อตั้งค่ารหัสแอปพลิเคชัน
- ใช้รหัสแอปพลิเคชันเดียวกับเนมสเปซ ความแตกต่างระหว่างพร็อพเพอร์ตี้ทั้งสองอาจทำให้สับสนเล็กน้อย แต่หากคุณกำหนดให้เหมือนกัน ก็ไม่ต้องกังวลอะไร
- อย่าเปลี่ยนรหัสแอปพลิเคชันหลังจากเผยแพร่แอปแล้ว หากคุณเปลี่ยนรหัสแอปพลิเคชัน Google Play Store จะถือว่าการอัปโหลดครั้งต่อมาเป็นแอปใหม่
- กำหนดรหัสแอปพลิเคชันอย่างชัดเจน หากไม่ได้กำหนดรหัสแอปพลิเคชันไว้อย่างชัดเจนโดยใช้พร็อพเพอร์ตี้
applicationIdระบบจะใช้ค่าเดียวกับเนมสเปซโดยอัตโนมัติ ซึ่งหมายความว่าการเปลี่ยนเนมสเปซจะเปลี่ยนรหัสแอปพลิเคชัน ซึ่งมักจะไม่ใช่สิ่งที่คุณต้องการ
เปลี่ยนรหัสแอปพลิเคชันเพื่อทดสอบ
โดยค่าเริ่มต้น เครื่องมือสร้างจะใช้รหัสแอปพลิเคชันกับ APK การทดสอบการวัดคุมโดยใช้รหัสแอปพลิเคชันสำหรับตัวแปรบิลด์ที่ระบุซึ่งต่อท้ายด้วย .test ตัวอย่างเช่น APK ทดสอบสำหรับตัวแปรบิลด์ com.example.myapp.free จะมีรหัสแอปพลิเคชันเป็น com.example.myapp.free.test
แม้ว่าจะไม่จำเป็น แต่คุณสามารถเปลี่ยนรหัสแอปพลิเคชันได้โดยกำหนดพร็อพเพอร์ตี้ testApplicationId ในบล็อก defaultConfig หรือ productFlavor
ตั้งค่าเนมสเปซ
โมดูล Android ทุกโมดูลมีเนมสเปซ ซึ่งใช้เป็นชื่อแพ็กเกจ Kotlin หรือ Java สำหรับคลาส R และ BuildConfig ที่สร้างขึ้น
เนมสเปซของคุณกำหนดโดยพร็อพเพอร์ตี้ namespace ในไฟล์ build.gradle.kts ของโมดูล ดังที่แสดงในข้อมูลโค้ดต่อไปนี้ namespace
จะตั้งค่าเป็นชื่อแพ็กเกจที่คุณเลือกเมื่อสร้างโปรเจ็กต์ในตอนแรก
Kotlin
android { namespace = "com.example.myapp" ... }
ดึงดูด
android { namespace "com.example.myapp" ... }
ขณะสร้างแอปเป็นแพ็กเกจแอปพลิเคชัน (APK) ขั้นสุดท้าย เครื่องมือสร้าง Android จะใช้เนมสเปซเป็นเนมสเปซสำหรับคลาส R ที่สร้างขึ้นของแอป ซึ่งใช้เพื่อเข้าถึงทรัพยากรแอป ตัวอย่างเช่น ในไฟล์บิลด์ก่อนหน้า คลาส R จะสร้างขึ้นที่ com.example.myapp.R
ชื่อที่คุณตั้งค่าสำหรับพร็อพเพอร์ตี้ namespace ของไฟล์ build.gradle.kts ควรตรงกับชื่อแพ็กเกจฐานของโปรเจ็กต์เสมอ ซึ่งเป็นที่ที่คุณเก็บกิจกรรมและโค้ดอื่นๆ ของแอป คุณสามารถมีแพ็กเกจย่อยอื่นๆ ในโปรเจ็กต์ได้ แต่ไฟล์เหล่านั้นต้องนำเข้าคลาส R โดยใช้เนมสเปซจากพร็อพเพอร์ตี้ namespace
เพื่อให้เวิร์กโฟลว์ง่ายขึ้น ให้ใช้เนมสเปซเดียวกับรหัสแอปพลิเคชันตามค่าเริ่มต้น
เปลี่ยนเนมสเปซ
ในกรณีส่วนใหญ่ คุณควรใช้เนมสเปซและรหัสแอปพลิเคชันเดียวกันตามค่าเริ่มต้น อย่างไรก็ตาม คุณอาจต้องเปลี่ยนเนมสเปซในบางจุดหากกำลังจัดระเบียบโค้ดใหม่หรือเพื่อหลีกเลี่ยงการชนกันของเนมสเปซ
ในกรณีเหล่านี้ ให้เปลี่ยนเนมสเปซโดยอัปเดตพร็อพเพอร์ตี้ namespace ในไฟล์ build.gradle.kts ของโมดูลโดยไม่ขึ้นกับรหัสแอปพลิเคชัน ก่อนดำเนินการดังกล่าว โปรดตรวจสอบว่าได้กำหนดรหัสแอปพลิเคชันไว้อย่างชัดเจน เพื่อให้การเปลี่ยนเนมสเปซไม่เปลี่ยนรหัสแอปพลิเคชันด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่เนมสเปซส่งผลต่อรหัสแอปพลิเคชันได้ที่ตั้งค่ารหัสแอปพลิเคชัน
หากคุณมีชื่อที่แตกต่างกันสำหรับ namespace และ Gradle applicationId เครื่องมือสร้างจะคัดลอกรหัสแอปพลิเคชันลงในไฟล์ Manifest สุดท้ายของแอปเมื่อสิ้นสุดการสร้าง
ดังนั้น หากคุณตรวจสอบไฟล์ AndroidManifest.xml หลังจากบิลด์ แอตทริบิวต์ package จะตั้งค่าเป็นรหัสแอปพลิเคชัน แอตทริบิวต์ package ของไฟล์ Manifest ที่ผสานแล้วคือตำแหน่งที่ Google Play Store และแพลตฟอร์ม Android จะดูเพื่อระบุแอปของคุณ
เปลี่ยนเนมสเปซสำหรับการทดสอบ
เนมสเปซเริ่มต้นสำหรับชุดซอร์ส androidTest และ test คือเนมสเปซหลัก โดยมี .test เพิ่มไว้ที่ส่วนท้าย ตัวอย่างเช่น หากพร็อพเพอร์ตี้ namespace ในไฟล์ build.gradle คือ com.example.myapp ระบบจะตั้งค่าเนมสเปซการทดสอบเป็น com.example.myapp.test โดยค่าเริ่มต้น หากต้องการเปลี่ยนเนมสเปซสำหรับการทดสอบ ให้ใช้พร็อพเพอร์ตี้ testNamespace ดังที่แสดงในข้อมูลโค้ดต่อไปนี้
Kotlin
android { namespace = "com.example.myapp" testNamespace = "com.example.mytestapp" ... }
ดึงดูด
android { namespace "com.example.myapp" testNamespace "com.example.mytestapp" ... }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบได้ที่ทดสอบแอปใน Android