คุณสามารถดำเนินการสร้างทั้งหมดที่พร้อมใช้งานสำหรับโปรเจ็กต์ Android โดยใช้เครื่องมือบรรทัดคำสั่ง Gradle Wrapper โดยจะพร้อมใช้งานเป็นไฟล์แบตช์สำหรับ Windows (gradlew.bat) และสคริปต์ของ Shell สำหรับ Linux และ Mac (gradlew.sh) และเข้าถึงได้จากรูทของแต่ละโปรเจ็กต์ที่คุณสร้างด้วย Android Studio
หากต้องการเรียกใช้งานด้วย Wrapper ให้ใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้จากหน้าต่างเทอร์มินัล (จาก Android Studio ให้เลือกดู > หน้าต่างเครื่องมือ > เทอร์มินัล)
ใน Windows Command Shell ให้ทำดังนี้
gradlew task-nameใน Mac, Linux หรือ Windows PowerShell ให้ทำดังนี้
./gradlew task-name
หากต้องการดูรายการงานบิลด์ทั้งหมดที่ใช้ได้สำหรับโปรเจ็กต์ ให้เรียกใช้ tasks:
gradlew tasks
ส่วนที่เหลือของหน้านี้จะอธิบายพื้นฐานในการสร้างและเรียกใช้แอปด้วย Wrapper ของ Gradle ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าบิลด์ Android ได้ที่กำหนดค่าบิลด์
หากต้องการใช้เครื่องมือ Android Studio แทนเครื่องมือบรรทัดคำสั่ง โปรดดูหัวข้อสร้างและเรียกใช้แอป
เกี่ยวกับประเภทบิลด์
โดยค่าเริ่มต้น แอป Android ทุกแอปจะมีบิลด์ 2 ประเภท ได้แก่ บิลด์สำหรับการแก้ไขข้อบกพร่องของแอป (บิลด์การแก้ไขข้อบกพร่อง) และบิลด์สำหรับการเผยแพร่แอปให้ผู้ใช้ (บิลด์ที่เผยแพร่) เอาต์พุตที่ได้จากแต่ละบิลด์ต้องรับรองด้วยใบรับรองก่อนจึงจะทำให้แอปใช้งานได้ในอุปกรณ์ บิลด์การแก้ไขข้อบกพร่องจะได้รับการรับรองโดยอัตโนมัติด้วยคีย์การแก้ไขข้อบกพร่องที่ได้จาก SDK Tools (ซึ่งไม่ปลอดภัยและคุณไม่สามารถใช้เพื่อเผยแพร่ไปยัง Google Play Store) และบิลด์ที่เผยแพร่จะต้องได้รับการรับรองด้วยคีย์ส่วนตัวของคุณเอง
หากต้องการสร้างแอปเพื่อเผยแพร่ คุณต้องรับรองแอปด้วยคีย์ Signing ที่เหมาะสมด้วย อย่างไรก็ตาม หากเพิ่งเริ่มต้น คุณสามารถเรียกใช้แอปในโปรแกรมจำลองหรืออุปกรณ์ที่เชื่อมต่อได้อย่างรวดเร็วโดยสร้าง APK สำหรับแก้ไขข้อบกพร่อง
นอกจากนี้ คุณยังกำหนดประเภทบิลด์ที่กำหนดเองในไฟล์ build.gradle.kts และกำหนดค่าให้ลงชื่อเป็นบิลด์การแก้ไขข้อบกพร่องได้โดยใส่ debuggable true ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าตัวแปรบิลด์
สร้างและทำให้ APK ใช้งานได้
แม้ว่าการสร้าง App Bundle จะเป็นวิธีที่ดีที่สุดในการจัดแพ็กเกจแอปและอัปโหลดไปยัง Play Console แต่การสร้าง APK จะเหมาะกว่าเมื่อคุณต้องการทดสอบบิลด์การแก้ไขข้อบกพร่องอย่างรวดเร็วหรือแชร์แอปเป็นอาร์ติแฟกต์ที่ทำให้ใช้งานได้กับผู้อื่น
สร้าง APK สำหรับแก้ไขข้อบกพร่อง
หากต้องการทดสอบและแก้ไขข้อบกพร่องของแอปทันที คุณสามารถสร้าง APK สำหรับแก้ไขข้อบกพร่องได้
APK สำหรับแก้ไขข้อบกพร่องจะรับรองด้วยคีย์การแก้ไขข้อบกพร่องที่ SDK Tools มีให้ และอนุญาตให้แก้ไขข้อบกพร่องผ่าน adb
หากต้องการสร้าง APK สำหรับแก้ไขข้อบกพร่อง ให้เปิดบรรทัดคำสั่งและไปที่รูทของไดเรกทอรีโปรเจ็กต์ หากต้องการเริ่มบิลด์การแก้ไขข้อบกพร่อง ให้เรียกใช้
งาน assembleDebug ดังนี้
gradlew assembleDebug
ซึ่งจะสร้าง APK ชื่อ module_name-debug.apk ใน project_name/module_name/build/outputs/apk/
ไฟล์ได้รับการรับรองด้วยคีย์การแก้ไขข้อบกพร่องและจัดแนวด้วย zipalign แล้ว คุณจึงติดตั้งในอุปกรณ์ได้ทันที
หรือหากต้องการสร้าง APK และติดตั้งในโปรแกรมจำลองที่ทำงานอยู่หรืออุปกรณ์ที่เชื่อมต่อทันที ให้เรียกใช้ installDebug แทน ดังนี้
gradlew installDebug
ส่วน "Debug" ในชื่องานเป็นเพียงชื่อตัวแปรบิลด์เวอร์ชันการเขียนแบบ Camel Case จึงสามารถแทนที่ด้วยประเภทหรือตัวแปรบิลด์ใดก็ได้ที่คุณต้องการประกอบหรือติดตั้ง เช่น หากคุณมีเวอร์ชันผลิตภัณฑ์ "สาธิต" คุณจะสร้างเวอร์ชันแก้ไขข้อบกพร่องได้ด้วยงาน assembleDemoDebug
หากต้องการดูงานบิลด์และติดตั้งทั้งหมดที่มีให้สำหรับแต่ละตัวแปร (รวมถึงงานถอนการติดตั้ง) ให้เรียกใช้งาน tasks
นอกจากนี้ โปรดดูส่วนเกี่ยวกับวิธีเรียกใช้แอปในโปรแกรมจำลองและเรียกใช้แอปในอุปกรณ์
สร้าง Release Bundle หรือ APK
เมื่อพร้อมที่จะเผยแพร่และจัดจำหน่ายแอป คุณต้องสร้าง Bundle หรือ APK สำหรับเผยแพร่ที่รับรองด้วยคีย์ส่วนตัว ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับวิธีรับรองแอปจากบรรทัดคำสั่ง
ทำให้แอปใช้งานได้ในโปรแกรมจำลอง
หากต้องการใช้โปรแกรมจำลองของ Android คุณต้องสร้างอุปกรณ์เสมือน Android (AVD) โดยใช้ Android Studio
เมื่อมี AVD แล้ว ให้เริ่มโปรแกรมจำลองของ Android และติดตั้งแอปโดยทำดังนี้
ในบรรทัดคำสั่ง ให้ไปที่
android_sdk/tools/และเริ่มโปรแกรมจำลองโดยระบุ AVD ของคุณemulator -avd <var>avd_name</var>หากไม่แน่ใจเกี่ยวกับชื่อ AVD ให้เรียกใช้
emulator -list-avdsตอนนี้คุณสามารถติดตั้งแอปโดยใช้งานการติดตั้ง Gradle อย่างใดอย่างหนึ่งที่กล่าวถึงในส่วนเกี่ยวกับวิธีสร้าง APK สำหรับแก้ไขข้อบกพร่องหรือเครื่องมือ
adbหาก APK สร้างขึ้นโดยใช้ SDK เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ (หาก
targetSdkVersionเป็นตัวอักษรแทนตัวเลข) คุณต้องใส่ตัวเลือก-tพร้อมกับคำสั่งinstallเพื่อติดตั้ง APK ทดสอบadb install <var>path/to/your_app</var>.apkAPK ทั้งหมดที่คุณสร้างจะบันทึกไว้ใน
project_name/module_name/build/outputs/apk/
ดูข้อมูลเพิ่มเติมได้ที่เรียกใช้แอปในโปรแกรมจำลองของ Android
ติดตั้งใช้งานแอปในอุปกรณ์จริง
คุณต้องเปิดใช้การแก้ไขข้อบกพร่อง USB ในอุปกรณ์ก่อนจึงจะเรียกใช้แอปในอุปกรณ์ได้ คุณจะเห็นตัวเลือกนี้ในส่วนการตั้งค่า > ตัวเลือกสำหรับนักพัฒนาแอป
เมื่อตั้งค่าและเชื่อมต่ออุปกรณ์โดยใช้ USB แล้ว คุณจะติดตั้งแอปได้โดยใช้งานการติดตั้ง Gradle ที่กล่าวถึงในส่วนเกี่ยวกับวิธีสร้าง APK สำหรับแก้ไขข้อบกพร่องหรือเครื่องมือ adb
adb -d install path/to/your_app.apk
APK ทั้งหมดที่คุณสร้างจะบันทึกไว้ใน project_name/module_name/build/outputs/apk/
ดูข้อมูลเพิ่มเติมได้ที่เรียกใช้แอปในอุปกรณ์ฮาร์ดแวร์
สร้าง App Bundle
Android App Bundle มีโค้ดและทรัพยากรทั้งหมดของแอปที่คอมไพล์แล้ว แต่เลื่อนการสร้างและรับรอง APK ไปยัง Google Play คุณไม่สามารถติดตั้งใช้งาน App Bundle ในอุปกรณ์ได้โดยตรงเหมือนกับ APK ดังนั้น หากต้องการทดสอบหรือแชร์ APK กับผู้อื่นอย่างรวดเร็ว คุณควรสร้าง APK แทน
วิธีที่ง่ายที่สุดในการสร้าง App Bundle คือใช้ Android Studio อย่างไรก็ตาม หากต้องการสร้าง App Bundle จากบรรทัดคำสั่ง คุณสามารถทำได้โดยใช้ Gradle หรือ bundletool ตามที่อธิบายไว้ในส่วนต่อไปนี้
สร้าง App Bundle ด้วย Gradle
หากต้องการสร้าง App Bundle จากบรรทัดคำสั่ง ให้เรียกใช้งาน bundleVariant Gradle ในโมดูลพื้นฐานของแอป
ตัวอย่างเช่น คำสั่งต่อไปนี้จะสร้าง App Bundle สำหรับเวอร์ชันแก้ไขข้อบกพร่องของโมดูลพื้นฐาน
./gradlew :base:bundleDebug
หากต้องการสร้าง App Bundle ที่รับรองแล้วเพื่ออัปโหลดไปยัง Play Console คุณต้องกำหนดค่าไฟล์ build.gradle.kts ของโมดูลพื้นฐานด้วยข้อมูลการรับรองของแอปก่อน ดูข้อมูลเพิ่มเติมได้ที่ส่วนเกี่ยวกับวิธีกำหนดค่า Gradle เพื่อรับรองแอป จากนั้นคุณจะสร้างแอปเวอร์ชันที่เผยแพร่ได้ และ Gradle จะสร้าง App Bundle โดยอัตโนมัติและรับรองด้วยข้อมูลการรับรองที่คุณระบุไว้ในไฟล์ build.gradle.kts
หากต้องการรับรอง App Bundle เป็นขั้นตอนแยกต่างหาก คุณสามารถใช้ jarsigner เพื่อรับรอง App Bundle จากบรรทัดคำสั่งได้ คำสั่งในการสร้าง App Bundle คือ
jarsigner -keystore pathToKeystore app-release.aab keyAliasสร้าง App Bundle โดยใช้ bundletool
bundletool เป็นเครื่องมือบรรทัดคำสั่งที่ Android Studio, ปลั๊กอิน Android Gradle และ Google Play ใช้เพื่อแปลงโค้ดและทรัพยากรที่คอมไพล์แล้วของแอปเป็น App Bundle และสร้าง APK ที่ทำให้ใช้งานได้จาก App Bundle เหล่านั้น
ดังนั้น แม้ว่าการทดสอบ App Bundle ด้วย bundletool และสร้างวิธีที่ Google Play สร้าง APK ขึ้นมาใหม่ในเครื่องจะเป็นประโยชน์ แต่โดยปกติแล้วคุณไม่จำเป็นต้องเรียกใช้ bundletool เพื่อสร้าง App Bundle เอง แต่ควรใช้ Android Studio หรือ Gradle Task ตามที่อธิบายไว้ในส่วนก่อนหน้าแทน
อย่างไรก็ตาม หากไม่ต้องการใช้ Android Studio หรือ Gradle Tasks เพื่อสร้าง Bundle เช่น หากใช้ Toolchain ของบิลด์ที่กำหนดเอง คุณสามารถใช้ bundletool จากบรรทัดคำสั่งเพื่อสร้าง App Bundle จากโค้ดและทรัพยากรที่คอมไพล์ไว้ล่วงหน้าได้ หากยังไม่ได้ดำเนินการ ให้ดาวน์โหลด bundletool จากที่เก็บ GitHub
ส่วนนี้จะอธิบายวิธีแพ็กเกจโค้ดและทรัพยากรที่คอมไพล์แล้วของแอป และวิธีใช้ bundletool จากบรรทัดคำสั่งเพื่อแปลงเป็น Android App Bundle
สร้างไฟล์ Manifest และทรัพยากรในรูปแบบ Proto
bundletool กำหนดให้ข้อมูลบางอย่างเกี่ยวกับโปรเจ็กต์แอป เช่น ไฟล์ Manifest และทรัพยากรของแอป ต้องอยู่ในรูปแบบบัฟเฟอร์โปรโตคอลของ Google หรือที่เรียกว่า "protobuf" และใช้นามสกุลไฟล์ *.pb Protobufs มีกลไกที่ขยายได้ ไม่ขึ้นอยู่กับภาษา และไม่ขึ้นอยู่กับแพลตฟอร์มสำหรับการจัดเรียงข้อมูลที่มีโครงสร้าง ซึ่งคล้ายกับ XML แต่มีขนาดเล็กกว่า เร็วกว่า และง่ายกว่า
ดาวน์โหลด AAPT2
คุณสร้างไฟล์ Manifest และตารางทรัพยากรของแอปในรูปแบบ protobuf ได้โดยใช้ AAPT2 เวอร์ชันล่าสุดจากที่เก็บ Maven ของ Google
หากต้องการดาวน์โหลด AAPT2 จากที่เก็บ Maven ของ Google ให้ทำดังนี้
- ไปที่ com.android.tools.build > aapt2 ในดัชนีที่เก็บ
- คัดลอกชื่อ AAPT2 เวอร์ชันล่าสุด
แทรกชื่อเวอร์ชันที่คัดลอกไว้ลงใน URL ต่อไปนี้และระบุระบบปฏิบัติการเป้าหมาย https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar
ตัวอย่างเช่น หากต้องการดาวน์โหลดเวอร์ชัน 3.2.0-alpha18-4804415 สำหรับ Windows คุณจะต้องใช้ https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar
ไปที่ URL ในเบราว์เซอร์ แล้ว AAPT2 จะเริ่มดาวน์โหลดในไม่ช้า
แตกไฟล์ JAR ที่เพิ่งดาวน์โหลด
คอมไพล์และลิงก์ทรัพยากรของแอป
ใช้ AAPT2 เพื่อคอมไพล์ทรัพยากรของแอปด้วยคำสั่งต่อไปนี้
aapt2 compile \ project_root/module_root/src/main/res/drawable/Image1.png \ project_root/module_root/src/main/res/drawable/Image2.png \ -o compiled_resources/
ในระหว่างขั้นตอนการลิงก์ ซึ่ง AAPT2 จะลิงก์ทรัพยากรที่คอมไพล์แล้วต่างๆ ของคุณเป็น APK เดียว ให้สั่ง AAPT2 ให้แปลงไฟล์ Manifest และทรัพยากรที่คอมไพล์แล้วของแอปเป็นรูปแบบ Protobuf โดยใส่แฟล็ก --proto-format ดังที่แสดงในตัวอย่างต่อไปนี้
aapt2 link --proto-format -o output.apk \ -I android_sdk/platforms/android_version/android.jar \ --manifest project_root/module_root/src/main/AndroidManifest.xml \ -R compiled_resources/*.flat \ --auto-add-overlay
จากนั้นคุณจะดึงเนื้อหาจาก APK เอาต์พุตได้ เช่น AndroidManifest.xml, resources.pb และไฟล์ทรัพยากรอื่นๆ ของแอป ซึ่งตอนนี้อยู่ในรูปแบบ protobuf คุณต้องใช้ไฟล์เหล่านี้เมื่อเตรียมอินพุตที่ bundletool ต้องใช้เพื่อสร้าง App Bundle ตามที่อธิบายไว้ในส่วนต่อไปนี้
แพ็กเกจโค้ดและทรัพยากรที่คอมไพล์ไว้ล่วงหน้า
ก่อนที่จะใช้ bundletool เพื่อสร้าง App Bundle สำหรับแอป คุณต้องระบุไฟล์ ZIP ที่แต่ละไฟล์มีโค้ดและทรัพยากรที่คอมไพล์แล้วสำหรับโมดูลแอปที่กำหนด เนื้อหาและการจัดระเบียบไฟล์ ZIP ของแต่ละโมดูลจะคล้ายกับรูปแบบ Android App Bundle มาก
ตัวอย่างเช่น คุณควรสร้างไฟล์ base.zip สำหรับโมดูลพื้นฐานของแอปและจัดระเบียบเนื้อหาดังนี้
| ไฟล์หรือไดเรกทอรี | คำอธิบาย |
|---|---|
manifest/AndroidManifest.xml
|
ไฟล์ Manifest ของโมดูลในรูปแบบ protobuf |
dex/...
|
ไดเรกทอรีที่มีไฟล์ DEX ที่คอมไพล์แล้วของแอปอย่างน้อย 1 ไฟล์ ไฟล์เหล่านี้ควรตั้งชื่อดังนี้ classes.dex, classes2.dex, classes3.dex เป็นต้น
|
res/...
|
มีทรัพยากรของโมดูลในรูปแบบ protobuf สำหรับการกำหนดค่าอุปกรณ์ทั้งหมด ไดเรกทอรีย่อยและไฟล์ควรได้รับการจัดระเบียบคล้ายกับ APK ทั่วไป |
root/..., assets/... และ lib/...
|
ไดเรกทอรีเหล่านี้เหมือนกับไดเรกทอรีที่อธิบายไว้ในส่วนเกี่ยวกับรูปแบบ Android App Bundle |
resources.pb
|
ตารางทรัพยากรของแอปในรูปแบบ protobuf |
หลังจากเตรียมไฟล์ ZIP สำหรับแต่ละโมดูลของแอปแล้ว คุณสามารถส่งไฟล์เหล่านั้นไปยัง bundletool เพื่อสร้าง App Bundle ได้ตามที่อธิบายไว้ในส่วนต่อไปนี้
สร้าง App Bundle โดยใช้ Bundletool
หากต้องการสร้าง App Bundle ให้ใช้คำสั่ง bundletool build-bundle ดังที่แสดงในตัวอย่างต่อไปนี้
bundletool build-bundle --modules=base.zip --output=mybundle.aab
ตารางต่อไปนี้อธิบายแฟล็กสำหรับคำสั่ง build-bundle โดยละเอียด
| ธง | คำอธิบาย |
|---|---|
--modules=path-to-base.zip, path-to-module2.zip,path-to-module3.zip
|
ระบุรายการไฟล์ ZIP ของโมดูลที่ bundletool ควรใช้เพื่อสร้าง App Bundle
|
--output=path-to-output.aab
|
ระบุเส้นทางและชื่อไฟล์สำหรับไฟล์ *.aab เอาต์พุต
|
--config=path-to-BundleConfig.json
|
ระบุเส้นทางไปยังไฟล์การกำหนดค่าที่ไม่บังคับซึ่งคุณใช้เพื่อปรับแต่งกระบวนการบิลด์ได้ ดูข้อมูลเพิ่มเติมได้ในส่วนเกี่ยวกับการปรับแต่งการสร้าง APK ดาวน์สตรีม |
--metadata-file=target-bundle-path:local-file-path
|
สั่งให้ bundletool จัดแพ็กเกจไฟล์ข้อมูลเมตาที่ไม่บังคับภายใน App Bundle คุณสามารถใช้ไฟล์นี้เพื่อรวมข้อมูล เช่น การแมป ProGuard หรือรายการไฟล์ DEX ของแอปทั้งหมด ซึ่งอาจเป็นประโยชน์ต่อขั้นตอนอื่นๆ ใน Toolchain หรือ App Store
target-bundle-path ระบุเส้นทางที่สัมพันธ์กับรูทของ App Bundle ที่คุณต้องการให้แพ็กเกจไฟล์ข้อมูลเมตา และ local-file-path ระบุเส้นทางไปยังไฟล์ข้อมูลเมตาในเครื่อง |
ปรับแต่งการสร้าง APK ดาวน์สตรีม
App Bundle มีไฟล์ BundleConfig.pb ซึ่งให้ข้อมูลเมตาที่ App Store เช่น Google Play ต้องใช้เมื่อสร้าง APK จากแพ็กเกจ
แม้ว่า bundletool จะสร้างไฟล์นี้ให้คุณ แต่คุณสามารถกำหนดค่าบางแง่มุมของข้อมูลเมตาในไฟล์ BundleConfig.json และส่งไปยังคำสั่ง bundletool build-bundle ได้ โดย bundletool จะแปลงและรวมไฟล์นี้กับเวอร์ชัน protobuf ที่รวมอยู่ใน App Bundle แต่ละรายการในภายหลัง
เช่น คุณสามารถควบคุมหมวดหมู่ของ APK การกำหนดค่าที่จะเปิดหรือปิดใช้ได้ ตัวอย่างไฟล์ BundleConfig.json ต่อไปนี้จะปิดใช้ APK การกำหนดค่าที่กำหนดเป้าหมายเป็นภาษาที่แตกต่างกัน (นั่นคือ ทรัพยากรสำหรับทุกภาษาจะรวมอยู่ใน APK พื้นฐานหรือ APK ฟีเจอร์ที่เกี่ยวข้อง)
{
"optimizations": {
"splitsConfig": {
"splitDimension": [{
"value": "LANGUAGE",
"negate": true
}]
}
}
}
ในไฟล์ BundleConfig.json คุณยังระบุประเภทไฟล์ที่จะไม่บีบอัดเมื่อแพ็ก APK โดยใช้รูปแบบ Glob ได้ด้วย โดยทำดังนี้
{
"compression": {
"uncompressedGlob": ["res/raw/**", "assets/**.uncompressed"]
}
}
โปรดทราบว่าโดยค่าเริ่มต้น bundletool จะไม่บีบอัดไลบรารีแบบเนทีฟของแอป (ใน Android 6.0 ขึ้นไป) และตารางทรัพยากร (resources.arsc) หากต้องการดูคำอธิบายทั้งหมดเกี่ยวกับสิ่งที่คุณกำหนดค่าได้ใน BundleConfig.json ให้ตรวจสอบไฟล์ config.proto ของ bundletool ซึ่งเขียนขึ้นโดยใช้ไวยากรณ์ Proto3
ทำให้แอปใช้งานได้จาก App Bundle
หากคุณสร้างและรับรอง App Bundle แล้ว ให้ใช้ bundletool เพื่อสร้าง APK และทำให้ใช้งานได้ในอุปกรณ์
รับรองแอปจากบรรทัดคำสั่ง
คุณไม่จำเป็นต้องใช้ Android Studio เพื่อรับรองแอป แต่สามารถรับรองแอปจากบรรทัดคำสั่งโดยใช้ apksigner สำหรับ APK หรือ jarsigner สำหรับ App Bundle หรือกำหนดค่า Gradle ให้รับรองแอปให้คุณในระหว่างการสร้าง ไม่ว่าจะใช้วิธีใด คุณต้องสร้างคีย์ส่วนตัวก่อนโดยใช้ keytool ดังที่แสดงในตัวอย่างต่อไปนี้
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias
ตัวอย่างนี้จะแจ้งให้คุณป้อนรหัสผ่านสำหรับคีย์สโตร์และคีย์ และสำหรับช่อง "ชื่อที่จำแนกได้" สำหรับคีย์ของคุณ จากนั้นจะสร้าง Keystore เป็นไฟล์ชื่อ my-release-key.jks โดยบันทึกไว้ในไดเรกทอรีปัจจุบัน (คุณย้ายไฟล์ไปที่ใดก็ได้ตามต้องการ) Keystore มีคีย์เดียวที่ใช้ได้เป็นเวลา 10,000 วัน
ตอนนี้คุณสามารถลงนาม APK หรือ App Bundle ด้วยตนเอง หรือกำหนดค่า Gradle ให้ลงนามแอปในระหว่างกระบวนการบิลด์ได้ตามที่อธิบายไว้ในส่วนต่อไปนี้
รับรองแอปด้วยตนเองจากบรรทัดคำสั่ง
หากต้องการรับรอง App Bundle จากบรรทัดคำสั่ง คุณสามารถใช้ jarsigner ได้
หากต้องการลงชื่อ APK แทน คุณต้องใช้ zipalign และ apksigner ดังนี้
เปิดบรรทัดคำสั่งจาก Android Studio โดยเลือกดู > หน้าต่างเครื่องมือ > เทอร์มินัล แล้วไปที่ไดเรกทอรีที่มี APK ที่ยังไม่ได้รับการรับรองอยู่
จัดเรียง APK ที่ไม่ได้ทำ Signing โดยใช้
zipalign:zipalign -v -p 4 my-app-unsigned.apk my-app-unsigned-aligned.apk
zipalignช่วยให้มั่นใจว่าข้อมูลที่ไม่ได้บีบอัดทั้งหมดจะเริ่มต้นด้วยการจัดเรียงไบต์ที่เฉพาะเจาะจงซึ่งสัมพันธ์กับจุดเริ่มต้นของไฟล์ ซึ่งอาจลดปริมาณ RAM ที่แอปใช้ลงชื่อ APK ด้วยคีย์ส่วนตัวโดยใช้
apksignerดังนี้apksigner sign --ks my-release-key.jks --out my-app-release.apk my-app-unsigned-aligned.apk
ตัวอย่างนี้จะแสดงผล APK ที่รับรองแล้วที่
my-app-release.apkหลังจากรับรองด้วยคีย์ส่วนตัวและใบรับรองที่จัดเก็บไว้ในไฟล์ KeyStore ไฟล์เดียว:my-release-key.jksเครื่องมือ
apksignerรองรับตัวเลือกการรับรองอื่นๆ ซึ่งรวมถึงการรับรองไฟล์ APK โดยใช้คีย์ส่วนตัวและไฟล์ใบรับรองแยกต่างหาก และการรับรอง APK โดยใช้ผู้รับรองหลายราย ดูรายละเอียดเพิ่มเติมได้ที่ข้อมูลอ้างอิงapksignerยืนยันว่า APK มีการรับรองโดยทำดังนี้
apksigner verify my-app-release.apk
กำหนดค่า Gradle เพื่อรับรองแอป
เปิดไฟล์ build.gradle.kts ระดับโมดูล แล้วเพิ่มบล็อก signingConfigs {} ที่มีรายการสำหรับ storeFile, storePassword, keyAlias และ keyPassword จากนั้นส่งออบเจ็กต์นั้นไปยังพร็อพเพอร์ตี้ signingConfig ในประเภทบิลด์ เช่น
Kotlin
android { ... defaultConfig { ... } signingConfigs { create("release") { // You need to specify either an absolute path or include the // keystore file in the same directory as the build.gradle file. storeFile = file("my-release-key.jks") storePassword = "password" keyAlias = "my-alias" keyPassword = "password" } } buildTypes { getByName("release") { signingConfig = signingConfigs.getByName("release") ... } } }
ดึงดูด
android { ... defaultConfig { ... } signingConfigs { release { // You need to specify either an absolute path or include the // keystore file in the same directory as the build.gradle file. storeFile file("my-release-key.jks") storePassword "password" keyAlias "my-alias" keyPassword "password" } } buildTypes { release { signingConfig signingConfigs.release ... } } }
ตอนนี้เมื่อคุณสร้างแอปโดยเรียกใช้งาน Gradle แล้ว Gradle จะรับรองแอป (และเรียกใช้ zipalign) ให้คุณ
นอกจากนี้ เนื่องจากคุณได้กำหนดค่าบิลด์ที่เผยแพร่ด้วยคีย์ Signing แล้ว งาน "ติดตั้ง" จึงพร้อมใช้งานสำหรับบิลด์ประเภทนั้น คุณจึงสร้าง จัดแนว ลงชื่อ และติดตั้ง APK สำหรับเผยแพร่ในโปรแกรมจำลองหรืออุปกรณ์ได้ทั้งหมดด้วยงาน installRelease
แอปที่รับรองด้วยคีย์ส่วนตัวของคุณพร้อมสำหรับการเผยแพร่แล้ว แต่คุณควรอ่านข้อมูลเพิ่มเติมเกี่ยวกับวิธีเผยแพร่แอปและอ่านรายการตรวจสอบการเปิดตัวใน Google Play ก่อน