เรียกใช้แอปเดโม

หน้านี้อธิบายวิธีทำการทดสอบในภาพรวมโดยใช้แอปเดโมและ Google Play Console

จำนวนก้าว

หากต้องการดาวน์โหลด SDK ให้เรียกใช้แอปเดโม ยืนยันว่าแอปทำงานได้อย่างถูกต้อง และ ดูข้อมูลการจับเวลาเฟรมจากแอปใน Google Play Console ดังต่อไปนี้:

1. ดาวน์โหลดไฟล์ .zip ของ SDK และแตกไฟล์
2. สร้างและเรียกใช้แอปเดโม
3. เรียกใช้แอปตรวจสอบ
4. สร้างบิลด์ของรุ่น
5. เรียกใช้บิลด์รุ่น
6. ดูกราฟใน Google Play Console

สร้างและเรียกใช้แอปเดโม

เรียกใช้แอปเดโมข้อมูลเชิงลึก APT ใน Android Studio เพื่อตรวจสอบว่า สร้างได้อย่างถูกต้อง โปรเจ็กต์นี้ใช้ CMake สำหรับการสร้างโค้ดแบบเนทีฟและแสดงวิธี เพื่อใช้ไฟล์ gamesdk.cmake ซึ่งเป็นวิธีเริ่มต้นใช้งานที่ง่ายที่สุด

หากต้องการเรียกใช้แอปเดโม ให้ทำตามขั้นตอนต่อไปนี้

1. แตกเนื้อหาของไฟล์ .zip ไปยังโฟลเดอร์
2. เปิด Android Studio
3. คลิกไฟล์ > เปิดและเลือก gamesdk/samples/tuningfork/insightsdemo/build.gradle
4. รอให้ Android Studio ซิงค์โปรเจ็กต์
5. เชื่อมต่ออุปกรณ์ (หรือสร้างอุปกรณ์เสมือน) สำหรับเรียกใช้ตัวอย่าง เปิดใช้ ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์และการแก้ไขข้อบกพร่อง USB เปิดอยู่ อุปกรณ์

6. เลือกอุปกรณ์เป้าหมายแล้วคลิกเรียกใช้ ดูข้อมูลเพิ่มเติมได้ที่สร้างและเรียกใช้แอป

   วันที่

   รูปที่ 1 แอปทดสอบทำงานเสร็จสมบูรณ์

7. APK ตัวอย่างควรสร้างและติดตั้งในอุปกรณ์เป้าหมาย หากคุณ พบข้อผิดพลาด โปรดตรวจสอบสิ่งต่อไปนี้

   • คุณมี Android เวอร์ชันที่รองรับ SDK ดูช่อง compileSdkVersion ในโมดูลแอป build.gradle เพื่อดูข้อมูลเพิ่มเติม คุณสามารถ อัปเดตเวอร์ชัน SDK จาก แท็บแพลตฟอร์ม SDK ใน SDK Manager
   • คุณมี Android เวอร์ชันที่รองรับ NDK ดูช่อง ndkVersion ในไฟล์โมดูลแอป build.gradle เพื่อดูข้อมูลเพิ่มเติม คุณสามารถ ติดตั้ง NDK เวอร์ชันที่เจาะจง จากแท็บเครื่องมือ SDK ใน SDK Manager
   • ไฟล์ local.properties ในโปรเจ็กต์ไม่มีรายการสำหรับ ndk.dir ตำแหน่งนี้ระบุโดย Android Studio และใช้ NDK เวอร์ชันจากด้านบน หากคุณมีรายการนี้ ให้ล้างทั้งบรรทัด
   • หลังจากเปลี่ยนแปลงการตั้งค่าบิลด์ ให้ทำความสะอาดโปรเจ็กต์ (บิลด์ > ล้าง” โปรเจ็กต์) และรีเฟรชโปรเจ็กต์ C++ ที่ลิงก์ (สร้าง > รีเฟรชโปรเจ็กต์ที่ลิงก์ C++ โปรเจ็กต์)

เรียกใช้แอปตรวจสอบ

ด้วยบิลด์การแก้ไขข้อบกพร่องของแอปเดโม หรือแอปที่เปิดใช้ Tuning Fork อื่นๆ คุณสามารถกำหนดค่าแอปให้ส่งและรับข้อมูลจากอุปกรณ์ปลายทางในเครื่อง มากกว่าเซิร์ฟเวอร์ Google Play โดยตั้งค่า endpoint_uri_override ใน การตั้งค่า Tuning Fork ดังนี้

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

คุณต้องรวมสิทธิ์ต่อไปนี้ใน AndroidManifest.xml ด้วย ไฟล์:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

แอปเดโมมีการเปลี่ยนแปลงเหล่านี้อยู่แล้ว (ดู insightsdemo.cpp)

คุณสามารถใช้ฟีเจอร์นี้เพื่อยืนยันว่าแอปกำลังส่งและรับ ข้อมูลที่เหมาะสม ซึ่งสามารถตรวจสอบได้โดยเรียกใช้แอปเดโมและแอป Tuning Fork Monitor ที่ ในเวลาเดียวกัน แอปตรวจสอบนี้จะทำหน้าที่เป็นเซิร์ฟเวอร์ภายในและแสดงข้อมูล ที่แอปที่เปิดใช้ Tuning Fork สร้างขึ้น

หากต้องการเรียกใช้แอปการตรวจสอบและแอปสาธิตพร้อมกัน เพื่อยืนยันว่า แอปทำงานอย่างถูกต้อง ให้ทำดังนี้

1. ติดตั้ง APK ของแอป Tuning Fork Monitor ในอุปกรณ์เป้าหมายโดยใช้ adb:

   adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
   

2. เปิดแอปการตรวจสอบ
3. กดปุ่มหน้าแรกของ Android เพื่อส่งแอป Tuning Fork Monitor ไปยัง บนอุปกรณ์
4. เรียกใช้แอปเดโมอีกครั้งในเบื้องหน้าเป็นเวลาประมาณ 30 วินาที
5. เปลี่ยนกลับไปใช้แอป Tuning Fork Monitor
6. แอปเดโมจะปรากฏในส่วนแอปพลิเคชันที่ใช้จริงเป็น com.tuningfork.insightsdemo 16 แตะรายการนี้เพื่อดูรายละเอียดและเผยแพร่แอป การตรวจวัดระยะไกล

วันที่

รูปที่ 2 แอปตรวจสอบจะตรวจหาแอปเดโม

วันที่

รูปที่ 3 แอปตรวจสอบแสดงข้อมูลจากแอปเดโม

สร้างบิลด์ของรุ่น

สร้างบิลด์ที่เผยแพร่ของแอปเดโมใน Android Studio คุณอัปโหลดบิลด์นี้ ลงใน Google Play Console เพื่อเปิดใช้กราฟเวลาที่ใช้ในการแสดงผลเฟรมใน Android Vitals

1. เปิดใช้ Android Performance Parameters API ใน Google Cloud Console API นี้ทำให้แอปสามารถสื่อสารกับ Google Play คุณไม่จำเป็นต้องจำกัดคีย์ API สำหรับแอปเดโม

2. ตรวจสอบว่าได้คัดลอกคีย์ API จากขั้นตอนก่อนหน้าไปยัง api_key แล้ว ฟิลด์ใน gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt

3. รหัสแอปพลิเคชันของแอปเดโมถูกสงวนไว้ จึงไม่สามารถอัปโหลด APK ที่ใช้ ได้ เปลี่ยนรหัสนี้ในไฟล์ build.gradle ของแอป

   applicationId "com.tuningfork.your-unique-identifier"
   

4. ทำความสะอาดโปรเจ็กต์ (สร้าง > ล้างโปรเจ็กต์) และรีเฟรช C++ ที่ลิงก์ไว้ โปรเจ็กต์ (สร้าง > รีเฟรชโปรเจ็กต์ C++ ที่ลิงก์)

5. สร้างการกำหนดค่าการรับรองสำหรับบิลด์รุ่น

   1. เลือก ไฟล์ > โครงสร้างโปรเจ็กต์ > โมดูล
   2. เลือกแท็บการกำหนดค่าการลงชื่อเข้าใช้
   3. เพิ่มการกำหนดค่าใหม่ชื่อ release
   4. สร้างคีย์สโตร์สำหรับ การกำหนดค่า

6. เชื่อมโยงการกำหนดค่าการรับรองรุ่นกับตัวแปรบิลด์ที่เผยแพร่

   1. เลือก ไฟล์ > โครงสร้างโปรเจ็กต์ > สร้างตัวแปร
   2. เลือกแท็บประเภทบิลด์
   3. เลือกประเภทบิลด์ที่ชื่อ release
   4. เลือกการกำหนดค่ารุ่นในช่องการกำหนดค่าการลงชื่อเข้าใช้ ตัวแปร

7. ในหน้าต่างโปรเจ็กต์ Android Studio ให้เลือกไดเรกทอรีแอป ( จะเป็นการเปิดใช้การเลือกเมนูในขั้นตอนถัดไป)

8. เปลี่ยนตัวแปรบิลด์ที่ใช้งานอยู่เป็น release (บิลด์ > เลือกบิลด์ ตัวแปร)

9. เลือก Build > สร้างแพ็กเกจ/APK > สร้าง APK เมื่อสร้าง เมื่อดำเนินการเสร็จแล้ว ให้คลิกลิงก์ค้นหาเพื่อค้นหา APK ที่เผยแพร่

10. สร้างแอปพลิเคชันใหม่สำหรับแอปเดโมใน Google Play Console สำหรับ ข้อมูลเพิ่มเติม โปรดดู อัปโหลดแอป

11. อัปโหลด APK ของรุ่นไปยังแทร็กการทดสอบภายใน สำหรับข้อมูลเพิ่มเติม ดู เตรียมพร้อมและ เปิดตัวรุ่นต่างๆ

    หมายเหตุ: คุณต้องอัปโหลด APK ไปยังแทร็กทดสอบภายในบน Google Play ถ้า ตัวกรองความเป็นส่วนตัวจะบล็อกกราฟที่เกี่ยวข้องไม่ให้แสดง

เรียกใช้บิลด์ของรุ่น

เลือกอุปกรณ์เป้าหมายแล้วคลิกเรียกใช้ คุณต้องใช้ APK รุ่นเดียวกับที่คุณอัปโหลดไปยัง Google Play Console

ปล่อยให้แอปเดโมทำงานต่อไปสักระยะหนึ่ง ซึ่งอาจใช้เวลาถึง 30 นาทีเพื่อให้ Google Play Console เพื่อเริ่มแสดงข้อมูล ยืนยันว่ากำลังอัปโหลดข้อมูลไปยัง โดยเลือกระดับการบันทึก Info ในหน้าต่าง Logcat หากคุณเห็น ในบันทึก โปรดดู แก้ไขข้อผิดพลาดที่พบบ่อย

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}

หมายเหตุ: ตรวจสอบว่าได้เรียกใช้ตัวแปรของบิลด์รุ่น มิเช่นนั้นระบบจะไม่อัปโหลดข้อมูลไปยัง Google Play Console

ดูกราฟใน Google Play Console

เปิด Google Play Console แล้วเลือกแอปพลิเคชันทดสอบ เลือก Android Vitals > ประสิทธิภาพ > ข้อมูลเชิงลึกเพื่อดูกราฟเวลาที่ใช้ในการแสดงผลเฟรม

รูปที่ 4 กราฟ Android Vitals

คุณทำการทดสอบแบบครบวงจรด้วย Tuning Fork เรียบร้อยแล้ว ไลบรารี คุณลบโปรเจ็กต์แอปทดสอบได้ใน Google Play Console เนื่องจาก ที่ไม่จำเป็นอีกต่อไป