Upgrade Guide – Developer guides

4.21.1 ⇨ 4.22.0

The change of Hive SDK release policy and product categorization

As from Hive SDK 4.22.0, the release policy of Hive SDK and categorization is changed as below.

Before Hive SDK 4.22.0: All supported game engines (Unity, Unreal, Android, iOS, Cocos2d-x) were released with the same SDK version. Refer to the examples below.
- Hive SDK 4.21.1 Unity/Unreal/Android/iOS/Cocos2d-x
- Hive SDK 4.16.4 Unity/Unreal/Android/iOS/Cocos2d-x
Hive SDK 4.22.0 and After: Each version will be released following the supported game engines (Unity, Unreal, Android, iOS, Cocos2d-x) and the supported OS (Windows, Android, iOS). Refer to the categorization examples below.
- Hive SDK v4 Unity iOS 22.0
- Hive SDK v4 Unity Android 22.0
- Hive SDK v4 Unity Windows 22.0 (Crossplay)
- Hive SDK v4 Unreal iOS 22.0
- Hive SDK v4 Unreal Android 22.0
- Hive SDK v4 Unreal Windows 22.0 (Crossplay)
- Hive SDK v4 Cocos2d-x iOS 22.0
- Hive SDK v4 Cocos2d-x Android 22.0
- Hive SDK v4 Android (Native) 22.0
- Hive SDK v4 iOS (Native) 22.0

Update of Applying iOS Framework

The dependency of the third party framework, Podfile file example, and the framework list that should be added to the project main target are updated. Refer to the guide below for the frameworks and the Podfile file example used in 4.21.1.

Dependencies of 3rd party frameworks

HiveProviderAppsFlyer (4.16.3)
- AppsFlyerFramework (6.9.1)
HiveProviderFacebook (4.16.3)
- FBSDKCoreKit (the latest version compatible with iOS minimum supported version as written in Podfile)
- FBSDKLoginKit (the latest version compatible with iOS minimum supported version as written in Podfile)
- FBSDKShareKit (the latest version compatible with iOS minimum supported version as written in Podfile)
HiveProviderFacebook/Facebook12 (4.16.3)
- Facebook 12 version verified compatibility with Hive SDK. iOS minimum supported version 10 or higher
- FBSDKCoreKit (12.3.0)
- FBSDKLoginKit (12.3.0)
- FBSDKShareKit (12.3.0)
HiveProviderFacebook/Facebook13 (4.16.3)
- Facebook 13 version verified compatibility with Hive SDK. iOS minimum supported version 11 or higher
- FBSDKCoreKit (13.2.0)
- FBSDKLoginKit (13.2.0)
- FBSDKShareKit (13.2.0)
HiveProviderFacebook/Facebook15 (4.16.3)
- Facebook 15 version verified compatibility with Hive SDK. iOS minimum supported version 12 or higher
- FBSDKCoreKit (15.0.0)
- FBSDKLoginKit (15.0.0)
- FBSDKShareKit (15.0.0)
HiveProviderFirebase (4.16.3)
- FirebaseCore (10.4.0)
- FirebaseAnalytics (10.4.0)
HiveProviderAdjust (4.16.3)
- Adjust (4.33.3)
HiveProviderSingular (4.16.3)
- Singular–SDK (12.0.1)
HiveProviderGoogle (4.16.3)
- GoogleUtilities (7.8.0)

The following is an Podfile file example.


    source 'https://github.com/CocoaPods/Specs.git'
    # Add Hive SDK repository using source command.
    source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'
    # 11.0 when using Facebook 13, 12.0 for Facebook 15
    platform :ios, '11.0'
    use_frameworks!
    inhibit_all_warnings!
      
    workspace 'HIVE_GAME'
    project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
        
      # The main target for the project
    target 'HIVE_GAME_COOL' do
      project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
      pod 'HiveAppTrackingTransparency', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderAdjust', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderAppsFlyer', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderFacebook', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderFirebase', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderGoogle', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderLine', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderQQ', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderSingular', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderVK', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderWechat', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderWeverse', '${HIVE_SDK_VERSION}'
      pod 'HiveResource', '${HIVE_SDK_VERSION}'
      pod 'HiveSDK', '${HIVE_SDK_VERSION}'
      pod 'HiveSDKUnityPlugin', '${HIVE_SDK_VERSION}'
      pod 'HiveExtensions', '${HIVE_SDK_VERSION}'
      pod 'Hercules', '${HIVE_SDK_VERSION}'
      pod 'HiveResource', '${HIVE_SDK_VERSION}'
    end
      
    # Add the App Extension target to use Push Extension feature in Hive
    target 'HIVE_GAME_COOL_EXTENSION' do
      project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
      pod 'HiveExtensions', '${HIVE_SDK_VERSION}'
    end
        
    post_install do |installer|
      installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
          # fix for dyld issue in pods when using Project
          # required change pod project configuration when using LineSDKSwift
          if ["LineSDKSwift"].include? target.name
            config.build_settings["BUILD_LIBRARY_FOR_DISTRIBUTION"] = "YES"
          # Addressing the Code signing compile error issue for the CocoaPods bundle target in Xcode 14.
          elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'
            config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
          end
          # Add the App Extension target to use Push Extension feature in Hive
          config.build_settings["APPLICATION_EXTENSION_API_ONLY"] = "NO"
        end
      end
    end

source 'https://github.com/CocoaPods/Specs.git'

# Add Hive SDK repository using source command.

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

# 11.0 when using Facebook 13, 12.0 for Facebook 15

platform :ios, '11.0'

use_frameworks!

inhibit_all_warnings!

workspace 'HIVE_GAME'

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

# The main target for the project

target 'HIVE_GAME_COOL' do

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

pod 'HiveAppTrackingTransparency', '${HIVE_SDK_VERSION}'

pod 'HiveProviderAdjust', '${HIVE_SDK_VERSION}'

pod 'HiveProviderAppsFlyer', '${HIVE_SDK_VERSION}'

pod 'HiveProviderFacebook', '${HIVE_SDK_VERSION}'

pod 'HiveProviderFirebase', '${HIVE_SDK_VERSION}'

pod 'HiveProviderGoogle', '${HIVE_SDK_VERSION}'

pod 'HiveProviderLine', '${HIVE_SDK_VERSION}'

pod 'HiveProviderQQ', '${HIVE_SDK_VERSION}'

pod 'HiveProviderSingular', '${HIVE_SDK_VERSION}'

pod 'HiveProviderVK', '${HIVE_SDK_VERSION}'

pod 'HiveProviderWechat', '${HIVE_SDK_VERSION}'

pod 'HiveProviderWeverse', '${HIVE_SDK_VERSION}'

pod 'HiveResource', '${HIVE_SDK_VERSION}'

pod 'HiveSDK', '${HIVE_SDK_VERSION}'

pod 'HiveSDKUnityPlugin', '${HIVE_SDK_VERSION}'

pod 'HiveExtensions', '${HIVE_SDK_VERSION}'

pod 'Hercules', '${HIVE_SDK_VERSION}'

pod 'HiveResource', '${HIVE_SDK_VERSION}'

end

# Add the App Extension target to use Push Extension feature in Hive

target 'HIVE_GAME_COOL_EXTENSION' do

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

pod 'HiveExtensions', '${HIVE_SDK_VERSION}'

end

post_install do |installer|

installer.pods_project.targets.each do |target|

target.build_configurations.each do |config|

# fix for dyld issue in pods when using Project

# required change pod project configuration when using LineSDKSwift

if ["LineSDKSwift"].include? target.name

config.build_settings["BUILD_LIBRARY_FOR_DISTRIBUTION"] = "YES"

# Addressing the Code signing compile error issue for the CocoaPods bundle target in Xcode 14.

elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'

config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'

end

# Add the App Extension target to use Push Extension feature in Hive

config.build_settings["APPLICATION_EXTENSION_API_ONLY"] = "NO"

end

The required frameworks for basic operation of Hive SDKoptional frameworks

HiveSDK
- The required framework for Hive SDK
HiveAppTrackingTransparency
- The framework needed to get the right to tracking app on the device with iOS 14 or higher version
HiveResource
- UI resource bundle (.bundle) provided by Hive SDK. It must be added in the main target of the project.

HiveExtensions
- The framework for extended feature of the Hive push notification
HiveProviderAdjust
- Adjust marketing tracking framework
HiveProviderAppsFlyer
- AppsFlyer marketing tracking framework
HiveProviderFacebook
- The framework for Facebook login and other social network features
HiveProviderFirebase
- Firebase marketing tracking framework
HiveProviderGoogle
- The framework for Google login
HiveProviderLine
- The framework for Line login
HiveProviderQQ
- The framework for QQ login
HiveProviderSingular
- Singular marketing tracking framework
HiveProviderVK
- The framework for VK login
HiveProviderWechat
- The framework for Wechat login
HiveProviderWeverse
- The framework for Weverse login
HiveSDKPlugin
- Hive SDK C++ interface plugin framework
HiveSDKUnityPlugin
- Hive SDK C# interface plugin framework
Hercules
- The security module framework

Update of Android module level build.gradle file update

Added AppsFlyer library configuration.

4.21.1 ⇨ 4.22.0

The change of Hive SDK release policy and product categorization

Update of Applying iOS Framework

Update of Android module level build.gradle file update

Getting Started

Console Guide

Download

API Document

Support