Hive กระบวนการพัฒนา SDK¶

สรุปของกระบวนการทั้งหมดตั้งแต่การติดตั้ง SDK ของแบรนด์ Hive ไปจนถึงการแจกจ่ายแอปมีดังนี้

1. การติดตั้ง
2. การกำหนดค่า
3. การพัฒนา
4. การสร้าง
5. การปรับใช้

1. การติดตั้ง¶

ในการนำฟีเจอร์เช่นการตรวจสอบสิทธิ์และการชำระเงินไปใช้ในแอปของคุณโดยใช้ SDK ของ Hive ให้ลงทะเบียนสำหรับคอนโซล Hive และสร้าง AppID ก่อน หลังจากนั้นติดตั้ง SDK ของ Hive ที่เหมาะสมกับสภาพแวดล้อมการพัฒนาของคุณ

การเตรียมตัวก่อนการติดตั้ง¶

ฟีเจอร์ส่วนใหญ่ของ SDK Hive ต้องการข้อมูลที่ป้อนในคอนโซล Hive ดังนั้นเพื่อใช้ SDK คุณต้องลงทะเบียนสำหรับ คอนโซล Hive และสร้าง AppID ก่อน

การติดตั้ง SDK¶

หลังจากสร้าง AppID ในคอนโซลแล้ว ให้ติดตั้ง SDK SDK ของ Hive อาจมีวิธีการ ติดตั้ง ที่แตกต่างกันขึ้นอยู่กับเอนจินการพัฒนา (Unity, Unreal Engine, ฯลฯ) และ OS (Android, iOS) ตัวอย่างเช่น หากคุณกำลังพัฒนาแอปด้วยเอนจิน Unity คุณสามารถติดตั้งเวอร์ชัน SDK ล่าสุดได้อย่างสะดวกโดยใช้ SDK Manager แต่หากคุณกำลังพัฒนาแอปในสภาพแวดล้อม Native Android คุณจะต้องติดตั้ง SDK โดยใช้ Gradle

ติดตั้งฟีเจอร์¶

หลังจากที่คุณติดตั้ง Hive SDK เสร็จแล้ว คุณต้อง ติดตั้งฟีเจอร์ SDK ที่คุณจะใช้ SDK มีฟีเจอร์ที่หลากหลาย เช่น การตรวจสอบสิทธิ์ การชำระเงิน การแจ้งเตือนแบบพุช โปรโมชั่น และการจับคู่ แนะนำให้ใช้ ฟีเจอร์การตรวจสอบสิทธิ์และการชำระเงินเป็นฟีเจอร์ที่จำเป็น และ ฟีเจอร์ที่เหลือเป็นฟีเจอร์เสริม

2. การตั้งค่าสภาพแวดล้อม¶

หากการติดตั้ง SDK เสร็จสมบูรณ์ คุณจะต้องกำหนดค่าบริการ SDK มีการตั้งค่าที่จำเป็นและการตั้งค่าเพิ่มเติม

(จำเป็น) การตั้งค่าพื้นฐาน: hive_config.xml<¶

hive_config.xml เป็นไฟล์ที่มีค่าคอนฟิกที่จำเป็นสำหรับ SDK ในการทำงานและถูกรวมอยู่ในแอปบิลด์ เพื่อใช้ SDK คุณต้องป้อน AppID ที่สร้างในคอนโซล Hive และ IdP ที่คุณจะใช้ในไฟล์นี้ SDK จะรวม hive_config.xml ในแอปบิลด์ในขณะ initialization.

เช่นเดียวกับการติดตั้ง SDK วิธีการกำหนดค่าของ hive_config.xml อาจแตกต่างกันไปขึ้นอยู่กับเอนจินการพัฒนา (เช่น Unity, Unreal Engine) และระบบปฏิบัติการ (Android, iOS) ตัวอย่างเช่น เมื่อพัฒนาแอปด้วยเอนจิน Unity คุณสามารถสร้าง hive_config.xml โดยใช้ Unity Hive Config Editor โดยไม่ต้องป้อนค่าการกำหนดค่าโดยตรงใน hive_config.xml ในขณะที่ในสภาพแวดล้อม Native คุณต้องสร้างไฟล์นี้ด้วยตนเองและป้อนค่าโดยตรงลงไปในนั้น

(ตัวเลือก) การตั้งค่าเฉพาะตลาด¶

หากคุณต้องการใช้ตลาดแอปเฉพาะ เช่น Google Play Games บน PC, Amazon, Steam (Windows) จะต้องมีการกำหนดค่าที่เพิ่มเติม การตั้งค่าเพิ่มเติม จะต้องใช้

(ไม่บังคับ) การตั้งค่าเวลาทำงาน¶

การตั้งค่า SDK บางอย่าง ควรทำในระหว่างการทำงานของแอป (runtime) แทนที่จะทำในระหว่างการเริ่มต้น SDK (build time). อย่างไรก็ตาม การเปลี่ยนแปลงค่าการกำหนดค่าขณะทำงานในระหว่างการให้บริการจริงไม่แนะนำ.

3. การพัฒนา¶

หลังจากเสร็จสิ้นการตั้งค่าบันทึกและ การเตรียมการพัฒนา ให้ดำเนินการฟีเจอร์ที่ต้องการ ในแอป คุณต้องส่งผ่านเหตุการณ์ที่เกิดขึ้นตามวงจรชีวิตของแอปไปยัง Hive SDK ตลอดทั้งรหัสแหล่งของแอปและเรียกใช้วิธีการของ SDK ที่รับเหตุการณ์เหล่านี้ ด้านล่างนี้คือรายการสำคัญที่ต้องทราบเมื่อพัฒนา SDK

การเริ่มต้น SDK¶

SDK Initialization เป็นขั้นตอนการเตรียมการแรกในการดำเนินการฟังก์ชันของ SDK ในการไหลของโค้ด SDK การเริ่มต้นจะถูกดำเนินการก่อน และหลังจากการเริ่มต้นเสร็จสิ้น ฟังก์ชัน SDK แต่ละตัว เช่น การตรวจสอบสิทธิ์ การชำระเงิน และการส่งเสริมการขาย สามารถใช้งานได้

SDK จะแสดงหน้าจอการยินยอมเงื่อนไขและข้อกำหนด (เช่น การเก็บข้อมูลการระบุอุปกรณ์, ป๊อปอัปการยินยอมการเก็บข้อมูลส่วนบุคคลที่แสดงเมื่อผู้ใช้แอปเปิดแอป) ในระหว่างกระบวนการเริ่มต้น หนึ่งในข้อดีหลักของ SDK คือมันช่วยให้การดำเนินการตามคำขอการยินยอมเงื่อนไขและข้อกำหนดเป็นไปอย่างง่ายดายและสะดวกสบาย

เมื่อการเริ่มต้นเสร็จสมบูรณ์ คุณสามารถตรวจสอบข้อมูลการระบุอุปกรณ์และรายการของ IdP ที่รองรับในระหว่างการเข้าสู่ระบบในคอนโซล Hive

เข้าสู่ระบบ¶

เมื่อผู้ใช้แอปเข้าสู่ระบบด้วย IdP ที่ตั้งค่าไว้ก่อนหน้านี้ SDK จะได้รับข้อมูลการระบุผู้ใช้ คุณสามารถใช้ข้อมูลนี้เพื่อระบุผู้ใช้และให้บริการ

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

หากผู้ใช้แอปเข้าสู่ระบบสำเร็จ โทเค็นการเข้าสู่ระบบจะต้องได้รับการตรวจสอบ SDK จะออกโทเค็นที่สามารถตรวจสอบได้เพื่อกำหนดว่าผู้ใช้นั้นไม่เหมาะสมหรือไม่ และ โทเค็นนี้สามารถตรวจสอบได้ เพื่อยืนยันว่าโทเค็นนั้นไม่ได้ถูกปลอมแปลง

การชำระเงิน¶

Billing เป็นฟีเจอร์ที่แสดงรายการผลิตภัณฑ์ที่ขายในแอปให้กับผู้ใช้แอปและอนุญาตให้พวกเขาซื้อผลิตภัณฑ์เหล่านี้ หากคุณสร้างร้านค้าในแอปและขายผลิตภัณฑ์ในแอป คุณจะเปิดเผยรายการผลิตภัณฑ์และให้ข้อมูลผลิตภัณฑ์ที่แตกต่างกันตามประเทศ ประเภทสกุลเงิน และภาษา ผลิตภัณฑ์แต่ละรายการมีรหัสการระบุผลิตภัณฑ์ซึ่งแยกแยะข้อมูลของแต่ละผลิตภัณฑ์

เมื่อคุณ ขายสินค้า ในร้านค้าในแอป SDK จะออกใบเสร็จ แอปของคุณต้องรับข้อมูลใบเสร็จนี้และเรียกใช้ API การตรวจสอบใบเสร็จ เพื่อตรวจสอบใบเสร็จ หากใบเสร็จถูกต้อง แอปจะมอบสินค้าให้กับผู้ใช้ที่ซื้อสินค้า เมื่อสินค้าได้รับการมอบให้แล้ว SDK จะประกาศสิ้นสุดการทำธุรกรรมการชำระเงิน

เมื่อการยกเลิกการทำธุรกรรมการชำระเงินถูกประกาศ ใบเสร็จสำหรับการซื้อไม่สามารถใช้สำหรับ การกู้คืนผลิตภัณฑ์ ได้ หากผู้ใช้แอปได้ทำการซื้อผลิตภัณฑ์จากร้านค้าในแอป แต่ผลิตภัณฑ์ยังไม่ได้ถูกส่งมอบให้กับผู้ใช้ด้วยเหตุผลใดก็ตาม ใบเสร็จที่ออกให้สามารถใช้เพื่อพยายามส่งมอบผลิตภัณฑ์อีกครั้งได้

การดีบัก¶

การเปิดใช้งาน logging ช่วยให้คุณตรวจสอบปัญหาการพัฒนาและทำการดีบัก หากเอนจินการพัฒนาเป็น Unity จะรองรับการดีบักแบบเรียลไทม์ด้วย RTT4U

4. สร้าง¶

รายการที่ต้องตรวจสอบก่อนการสร้าง ขึ้นอยู่กับเครื่องมือพัฒนา ระบบปฏิบัติการ หรือท่อสร้าง ตัวอย่างเช่น ในสภาพแวดล้อม Android (Native Android และ Unity Android) สิทธิ์จะถูกรวมโดยอัตโนมัติใน SDK ดังนั้นจึงไม่ต้องมีการกำหนดค่าแยกต่างหาก ในทางกลับกัน ในสภาพแวดล้อม Native iOS สิทธิ์จะต้องถูกประกาศตามฟีเจอร์ที่คุณต้องการใช้ในแอปก่อนการสร้าง ในสภาพแวดล้อม Unity iOS สิทธิ์ที่จำเป็นเท่านั้นที่สามารถเพิ่มโดยอัตโนมัติได้โดยใช้ HivePostProcess Editor

5. การปรับใช้¶

ก่อนที่จะเผยแพร่แอปไปยังตลาดแอป (Google Play Store, App Store, ฯลฯ) คุณต้องมั่นใจว่าแอปนั้นถูกพัฒนาขึ้นอย่างเหมาะสมตาม Hive แพลตฟอร์ม นโยบาย และคุณต้องส่ง ประเภทของข้อมูลส่วนบุคคลที่เก็บรวบรวมและวัตถุประสงค์ของข้อมูลไปยังตลาดแอป โปรดดูคู่มือข้อมูลส่วนบุคคลที่ใช้โดย Hive SDK หรือไลบรารีของบุคคลที่สามสำหรับการส่งข้อมูล