ก่อนเริ่มต้น
คู่มือนักพัฒนาซอฟต์แวร์นี้จะแสดงวิธีคอมไพล์และเรียกใช้เกม C++ บน Android ที่ใช้ Google Play API ของบริการเกม ก่อนที่จะเริ่มต้น ให้ดาวน์โหลดและกำหนดค่าข้อกำหนดต่อไปนี้
- Android NDK, Revision 14 ขึ้นไป
- Android SDK v10 ขึ้นไปและ Eclipse ADT เวอร์ชันล่าสุด
- อุปกรณ์ต้องใช้ Android 4.0 (API ระดับ 14) ขึ้นไป
- SDK บริการ Google Play เวอร์ชันล่าสุด
คู่มือนักพัฒนาซอฟต์แวร์นี้ใช้ Android Native Development Kit (NDK) หากคุณไม่คุ้นเคยกับ NDK โปรดดูเอกสารและตัวอย่าง NDK ก่อนดำเนินการต่อ
ขั้นตอนที่ 1: ตั้งค่าสภาพแวดล้อม
- ดาวน์โหลด Android SDK และ Android NDK แล้วดึงข้อมูลลงในเครื่อง ใน
ตั้งค่า
SDK_ROOT
ไปยังตำแหน่งของโฟลเดอร์ Android SDK และNDK_ROOT
เป็น ของโฟลเดอร์ Android NDK - ดาวน์โหลดเกมตัวอย่าง C++ ช่วงเวลานี้
คู่มือนักพัฒนาซอฟต์แวร์ระบุตำแหน่งของตัวอย่างในคอมพิวเตอร์ของคุณว่า
SAMPLES_DIR
- ดาวน์โหลด SDK สำหรับ C++ ของบริการเกมของ Google Play ดึงข้อมูล
SDK ลงในเครื่องพัฒนา ในสภาพแวดล้อมของคุณ ให้ตั้งค่าตัวแปร
NDK_MODULE_PATH
เป็น ชี้ไปที่ไดเรกทอรีเหนือไดเรกทอรีgpg-cpp-sdk
คุณควรมีสิ่งต่อไปนี้ โครงสร้างไดเรกทอรีNDK_MODULE_PATH/ gpg-cpp-sdk/
- เปิด Eclipse หากยังไม่ได้ติดตั้ง ให้แจ้ง Eclipse ว่าคุณติดตั้ง NDK ไว้ที่ใดโดย คลิก ค่ากำหนด > Android > NDK
นำเข้าโปรเจ็กต์ไลบรารีบริการ Google Play ไปยังพื้นที่ทำงาน Eclipse
- ใน Eclipse ให้คลิก ไฟล์ > นำเข้า > Android > โค้ด Android ที่มีอยู่ไปยัง Workspace
- เลือก
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
โดยที่SDK_ROOT
คือตำแหน่งที่ตั้งของ Android SDK ของคุณ - คลิกเสร็จสิ้น
นำเข้าโปรเจ็กต์ตัวอย่างสไตล์มินิมอลไปยังพื้นที่ทำงาน Eclipse
- ใน Eclipse ให้คลิก ไฟล์ > นำเข้า > Android > โค้ด Android ที่มีอยู่ไปยัง Workspace
- เลือก
SAMPLES_DIR/samples-android/minimalist
- คลิกเสร็จสิ้น
คลิกขวาที่โปรเจ็กต์ MinimalistActivity แล้วคลิกพร็อพเพอร์ตี้ ในส่วน Android ให้เลื่อน ไปที่ส่วน Library และตรวจสอบว่าโปรเจ็กต์ google-play-services_lib ถูกต้อง มีการอ้างอิงถึง หากไม่ ให้นำข้อมูลอ้างอิงออกและเพิ่มอีกครั้งจากพื้นที่ทำงาน
Eclipse จะรวบรวมแหล่งที่มาของ Java และ Android ของโปรเจ็กต์โดยอัตโนมัติ อย่างไรก็ตาม
ต้องคอมไพล์โค้ดแบบเนทีฟในโฟลเดอร์ jni
แยกกัน หากต้องการดำเนินการด้วยตนเอง ให้ไปที่
โฟลเดอร์ jni
และเรียกใช้ ndk-build
อย่าลืมดำเนินการนี้หลังจากที่คุณทำการเปลี่ยนแปลงใดๆ ใน
โฟลเดอร์ jni
ขณะนี้โปรเจ็กต์ของคุณควรคอมไพล์แล้ว แต่โปรเจ็กต์จะยังใช้งานไม่ได้ คุณต้องกำหนดค่าเกมก่อน ใน Google Play Console
ขั้นตอนที่ 2: ตั้งค่าเกมใน Google Play Console
สร้างรายการเกมของคุณใน Google Play Console การดำเนินการนี้จะเปิดใช้บริการเกมสำหรับ และสร้างรหัสไคลเอ็นต์ OAuth 2.0 หากคุณยังไม่มี
- สร้างรายการสำหรับเกมของคุณโดยทำตามขั้นตอนที่อธิบายไว้ใน ตั้งค่าบริการเกมของ Google Play
- ใน
AndroidManifest.xml
ให้เปลี่ยนแอตทริบิวต์package
ของแท็ก<manifest>
เป็น ชื่อแพ็กเกจที่คุณเลือกเมื่อตั้งค่า Google Play Console คุณอาจต้องแก้ไขข้อมูลอ้างอิงบางรายการ ตลอดทั้งโปรเจ็กต์หลังจากทำการเปลี่ยนแปลงนี้ (โดยเฉพาะอย่างยิ่งคลาสR
ที่สร้างขึ้น) - เปิด
res/values/ids.xml
แล้ววางรหัสแอปไว้ที่นั่น โปรดทราบว่ารหัสแอปไม่เหมือนกับ รหัสไคลเอ็นต์ หมายเลขนี้จะเป็นหมายเลขที่อยู่ถัดจากชื่อเกมของคุณในหน้ารายละเอียดเกมของ Google Play Console
ขั้นตอนที่ 3: เรียกใช้ตัวอย่าง
เพื่อเรียกใช้ตัวอย่าง คุณจะต้องมีอุปกรณ์ Android จริงหรือโปรแกรมจำลองที่มี บริการ Google Play ที่ติดตั้ง:
- เรียกใช้
ndk-build
เพื่อคอมไพล์โค้ดแบบเนทีฟ - ใน Eclipse ให้คลิก Run > เรียกใช้เป็น > แอปพลิเคชัน Android และเรียกใช้ตัวอย่างในอุปกรณ์
- เมื่อตัวอย่างเปิดขึ้น ให้แตะที่ใดก็ได้บนหน้าจอ คุณจะเห็นโลโก้ Google Play Games ปรากฏขึ้น หากคุณได้กำหนดค่าแอปอย่างถูกต้องแล้ว ระบบจะแจ้งให้คุณลงชื่อเข้าใช้
ไม่บังคับ: การสร้างโดยอัตโนมัติด้วย Eclipse
ขั้นตอนต่อไปนี้แสดงวิธีกำหนดค่า Eclipse ให้เรียกใช้ ndk-build
โดยอัตโนมัติเมื่อคุณ
แก้ไขไฟล์ในโฟลเดอร์ jni
- คลิกขวาที่โปรเจ็กต์ MinimalistActivity แล้วคลิกพร็อพเพอร์ตี้ ในหน้าต่าง "คุณสมบัติ" เลือกแผงเครื่องมือสร้าง
- คลิกใหม่เพื่อเพิ่มเครื่องมือสร้างใหม่ และเลือกโปรแกรม แล้วคลิกตกลง
- ป้อน "NDK Builder" ในช่องชื่อ
- ในตำแหน่ง ให้คลิกเรียกดูระบบไฟล์ แล้วไปที่ไดเรกทอรี
NDK_ROOT
และ เลือกคำสั่งndk-build
- ในส่วน Working Directory ให้คลิก Browse Workspace แล้วเลือก MinimalistActivity โฟลเดอร์โปรเจ็กต์
- คลิกแท็บรีเฟรช ตรวจสอบว่าได้เลือกช่องรีเฟรชทรัพยากรเมื่อเสร็จสิ้นแล้ว
- เลือกปุ่มตัวเลือกทรัพยากรเฉพาะแล้วคลิกระบุทรัพยากร ใน
ที่ปรากฏขึ้น ให้เลือกโฟลเดอร์
jni
ในส่วน MinimalActivity - คลิกใช้ แล้วคลิกตกลงเพื่อสร้างเครื่องมือสร้างให้เสร็จสิ้น
ทุกครั้งที่คุณแก้ไขไฟล์ในโฟลเดอร์ jni
Eclipse จะเรียกใช้ ndk-build
และพิมพ์
ไปยัง Eclipse Console