iOS
使用 CocoaPods 安装¶
本指南介绍如何使用 CocoaPods 安装 Hive SDK iOS。
添加 Hive SDK 仓库¶
在生成的 Podfile 中将 Hive SDK 仓库添加为 source。
向 Xcode 项目添加 Hive SDK¶
编辑 Xcode 项目目录中的 Podfile 以添加 Hive SDK。
source 'https://github.com/CocoaPods/Specs.git'
# 添加 SDK 仓库作为 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' # 使用的 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 # 在身份验证 (AuthV4) 中使用 Google IdP 登录时
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) 安装 Hive SDK iOS。
向 Unity 项目添加 SDK 包¶
在 Unity 环境中,SPM 使用的默认值为 true。因此,支持 SPM 的 Hive SDK 默认使用 SPM 安装,不支持 SPM 的 Hive SDK 使用 CocoaPods 安装。
在 Unity 环境中,您可以通过使用 Hive SDK 提供的 PostProcess 功能更便捷地添加 Hive SDK iOS 包,该功能会自动添加包依赖项。
Note
即使是支持 SPM 的 Hive SDK,如果您想使用 CocoaPods 而不是 SPM 进行安装,请在 Unity Editor 的 Assets > External Dependency Manager > iOS Resolver > Settings 路径下取消选择 iOS Resolver Settings > Swift Package Manager Integration。 
向非 Unity 项目添加 SDK 包¶
按以下顺序向您的 Xcode 项目添加 Hive SDK iOS 包:
-
2.1. 输入对应 Hive SDK iOS 包仓库的地址,如下所示:
2.2. 在 Dependency Rule 中选择 Exact Version 并输入您要应用的 SDK 版本。
2.3. 点击 Add Package。
-
包加载完成后,会显示 Hive SDK iOS 提供的功能列表(身份验证、计费、分析等)。您可以将要应用的功能添加到应用目标中。
Warning
以下不支持 SPM 的 Hive SDK 功能必须使用 CocoaPods 添加:
- HerculesSwift
- HiveAuthV4ProviderQQ
- HiveAuthV4ProviderLine
- HiveAuthV4ProviderWechat
- HiveAnalyticsProviderAirbridge
在 Podfile 中使用 pod 语法 为每个功能编写依赖项,然后运行
pod install。
此外,如果需要应用更多依赖项,您可以使用 CocoaPods 以同样的方式添加。在这种情况下,请勿包含已通过 SPM 添加的 Hive SDK 功能。 -
在主应用目标的 Build Settings 中,按顺序将以下两个值添加到 Other Linker Flags (
OTHER_LDFLAGS) 中:-Xlinker-all_load

