跳转至

iOS

使用 CocoaPods

本节介绍如何使用 CocoaPods 安装 Hive SDK iOS。

添加 Hive SDK 仓库

在生成的 Podfile 中将 Hive SDK 仓库添加为源。

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

将 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。

  1. 在 Xcode 项目中选择添加包菜单。

    Unity

    如果您在 Unity 环境中安装 Hive SDK 后构建了 Xcode 项目,且 pod install 已自动执行,则必须先运行 pod deintegrate

  2. 查找 Hive SDK 包仓库并指定版本。

    1. 1 中输入以下地址。

      https://github.com/Com2uSPlatformCorp/HiveSDK-iOS-SPM
      
    2. 2 中选择 Exact Version 并输入要应用的 SDK 版本。

    3. 点击 3

  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_AuthV4ProviderFacebookHive_AnalyticsProviderAdjust 产品也必须添加到主应用目标 (Unity-iPhone)。

  4. 在主应用目标的 Build Settings 中,依次将以下两个值添加到 Other Linker Flags (OTHER_LDFLAGS)。

    • -Xlinker
    • -all_load