コンテンツにスキップ

iOS

このガイドでは、CocoaPodsを使用してHive SDKをiOSにインストールする方法を説明します。

CocoaPodsを利用する

Hive SDKリポジトリを追加

生成されたPodfileにHive SDKリポジトリをソースとして追加します。

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

XcodeプロジェクトにSDKを追加

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
  # ここに使用するフレームワークを追加します。最低1つ以上のフレームワークが必要です。
  # 例:認証で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)で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. 2Exact 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プロジェクトを出力した場合、アプリターゲットではなくUnityFrameworkターゲットにHive SDK製品を適用します。ただし、Hive_AuthV4ProviderFacebookHive_AnalyticsProviderAdjust製品はメインアプリターゲット(Unity-iPhone)にも追加する必要があります。

  4. メインアプリターゲットのBuild SettingsでOther Linker Flags(OTHER_LDFLAGS)に以下の2つの値を順番に追加します。

    • -Xlinker
    • -all_load