iOS

ติดตั้งด้วย CocoaPods¶

คู่มือนี้อธิบายวิธีการติดตั้ง Hive SDK iOS โดยใช้ CocoaPods

เพิ่ม Hive SDK repository¶

เพิ่ม Hive SDK repository เป็น source ในไฟล์ Podfile ที่สร้างขึ้น

source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'

เพิ่ม Hive SDK ในโปรเจค Xcode¶

แก้ไขไฟล์ Podfile ในไดเรกทอรีโปรเจค Xcode เพื่อเพิ่ม Hive SDK

source 'https://github.com/CocoaPods/Specs.git'
# เพิ่ม SDK repository เป็น source
source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'

$HIVE_SDK_VERSION = '26.1.0'                    # เวอร์ชัน SDK ที่จะใช้
$IOS_DEPLOYMENT_TARGET_VERSION = '13.0'         # เวอร์ชัน iOS ขั้นต่ำที่เกมรองรับ
$IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION = '13.0' # เวอร์ชัน iOS ขั้นต่ำที่ SDK รองรับ (ดู release notes ของ SDK เวอร์ชันที่ใช้)

platform :ios, $IOS_DEPLOYMENT_TARGET_VERSION
use_frameworks!
inhibit_all_warnings!

project 'HIVE_SDK_Sample_App.xcodeproj'

target 'HIVE_SDK_Sample_App' do
  # เพิ่ม frameworks ที่จะใช้ที่นี่ ต้องมีอย่างน้อย 1 framework
  # ตัวอย่าง: เพิ่ม framework ต่อไปนี้เมื่อใช้ Google IdP login ในการ authentication
  pod 'HiveAuthV4ProviderGoogle', $HIVE_SDK_VERSION # เมื่อใช้ Google IdP login ใน authentication (AuthV4)
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
     target.build_configurations.each do |config|
     # เปลี่ยนเป็น 15 หาก iOS target ของแต่ละ framework น้อยกว่า 15
     if config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'].to_f < $IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION.to_f
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = $IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION.to_f
     end
     # แก้ไขปัญหา compilation error เกี่ยวกับ Xcode 15 TOOLCHAIN_DIR
     xcconfig_path = config.base_configuration_reference.real_path
     xcconfig = File.read(xcconfig_path)
     xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
     File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
     end
  end
end

ติดตั้งด้วย Swift Package Manager (Beta)¶

คู่มือนี้อธิบายวิธีการติดตั้ง Hive SDK iOS โดยใช้ Swift Package Manager (SPM)

เพิ่ม SDK package ในโปรเจค Unity¶

ในสภาพแวดล้อม Unity ค่าเริ่มต้นสำหรับการใช้ SPM คือ true ดังนั้น Hive SDK ที่รองรับ SPM จะติดตั้งด้วย SPM เป็นค่าเริ่มต้น และ Hive SDK ที่ไม่รองรับ SPM จะติดตั้งด้วย CocoaPods

ในสภาพแวดล้อม Unity คุณสามารถเพิ่ม Hive SDK iOS package ได้อย่างสะดวกยิ่งขึ้นโดยใช้ฟีเจอร์ PostProcess ที่ Hive SDK จัดเตรียมไว้ ซึ่งจะเพิ่ม package dependencies โดยอัตโนมัติ

เพิ่ม SDK package ในโปรเจคที่ไม่ใช่ Unity¶

เพิ่ม Hive SDK iOS package ในโปรเจค Xcode ตามลำดับต่อไปนี้:

1. คลิก File > Add Package Dependencies...

2. ลงทะเบียน Hive SDK iOS package ตามลำดับต่อไปนี้:

   2.1. ใส่ที่อยู่ที่สอดคล้องกับ Hive SDK iOS package repository ดังนี้:

   https://github.com/Com2uSPlatformCorp/HiveSDK-iOS-SPM
   

   2.2. เลือก Exact Version ใน Dependency Rule และใส่เวอร์ชัน SDK ที่ต้องการนำไปใช้

   2.3. คลิก Add Package

3. เมื่อการโหลด package เสร็จสมบูรณ์ รายการฟีเจอร์ที่ Hive SDK iOS จัดเตรียมไว้ (authentication, billing, analytics เป็นต้น) จะแสดงขึ้น คุณสามารถเพิ่มฟีเจอร์ที่ต้องการนำไปใช้ใน app target ได้

   Warning

   ฟีเจอร์ Hive SDK ต่อไปนี้ที่ไม่รองรับ SPM ต้องเพิ่มโดยใช้ CocoaPods:

   • HerculesSwift
   • HiveAuthV4ProviderQQ
   • HiveAuthV4ProviderLine
   • HiveAuthV4ProviderWechat
   • HiveAnalyticsProviderAirbridge

   เขียน dependencies สำหรับแต่ละฟีเจอร์ในไฟล์ Podfile โดยใช้ pod syntax แล้วรัน pod install
   นอกจากนั้น หากมี dependencies อื่นที่ต้องการเพิ่ม คุณสามารถเพิ่มได้โดยใช้ CocoaPods ในลักษณะเดียวกัน ในกรณีนี้ ห้ามรวมฟีเจอร์ Hive SDK ที่เพิ่มผ่าน SPM แล้ว

4. ใน Build Settings ของ main app target เพิ่มค่าทั้งสองต่อไปนี้ใน Other Linker Flags (OTHER_LDFLAGS) ตามลำดับ:

   • -Xlinker
   • -all_load