iOS
使用 CocoaPods¶
本节介绍如何使用 CocoaPods 安装 Hive SDK iOS。
添加 Hive SDK 仓库¶
在生成的 Podfile 中将 Hive SDK 仓库添加为源。
将 SDK 添加到 Xcode 项目¶
修改 Xcode 项目目录中的 Podfile,以添加 Hive SDK。
source 'https://github.com/CocoaPods/Specs.git'
# 添加 SDK 仓库为源
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' # 所使用 SDK 支持的最低 iOS 版本(请参阅所用 SDK 版本的发布说明)
platform :ios, $IOS_DEPLOYMENT_TARGET_VERSION
use_frameworks!
inhibit_all_warnings!
project 'HIVE_SDK_Sample_App.xcodeproj'
target 'HIVE_SDK_Sample_App' do
# 在此处添加要使用的框架。至少需要一个框架。
# 示例:在认证中使用 Google IdP 登录时添加以下框架
pod 'HiveAuthV4ProviderGoogle', $HIVE_SDK_VERSION # 使用 Google IdP 登录进行认证 (AuthV4) 时
end
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
# 如果各框架的 iOS 目标版本低于 15,则将其更改为 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
# 处理 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)¶
本节介绍如何使用 Swift Package Manager (SPM) 安装 iOS SDK。
-
在 Xcode 项目中选择添加包菜单。
Unity
如果您在 Unity 环境中安装 Hive SDK 后构建了 Xcode 项目,且
pod install已自动执行,则必须先运行pod deintegrate。 -
查找 Hive SDK 包仓库并指定版本。
-
在 1 中输入以下地址。
-
在 2 中选择
Exact Version并输入要应用的 SDK 版本。 -
点击 3。
-
-
包加载完成并显示产品列表后,将所需的 Hive SDK 产品(认证、计费、分析等)应用到应用目标。
Warning
以下不支持 SPM 的 Hive SDK 产品必须使用 CocoaPods 添加。
- HerculesSwift
- HiveAuthV4ProviderQQ
- HiveAuthV4ProviderLine
- HiveAuthV4ProviderWechat
- HiveAnalyticsProviderAirbridge
在 Podfile 中为这些产品编写 pod 语句,然后运行
pod install。此时,不应包含已通过 SPM 应用的 Hive SDK 产品。如果还有其他依赖项需要添加,同样可以使用 CocoaPods 添加。Unity
如果您在 Unity 环境中安装 Hive SDK 后生成了 Xcode 项目,请将 Hive SDK 产品应用到
UnityFramework目标而非应用目标。但是,Hive_AuthV4ProviderFacebook和Hive_AnalyticsProviderAdjust产品也必须添加到主应用目标 (Unity-iPhone)。 -
在主应用目标的 Build Settings 中,依次将以下两个值添加到 Other Linker Flags (
OTHER_LDFLAGS)。-Xlinker-all_load

