SohaGame SDK iOS Release Notes¶

Version 1.3.2.6 - 02/11/2026¶

Changes¶

Breaking changes:¶

Raised the minimum supported version to iOS 15. Update your app target's deployment target before upgrading.
Removed SohaKit application:continueUserActivity:. Remove calls to this API from your integration.
Removed TikTok login support.
Added Rate App Method.

Update third-party SDK:¶

Updated Facebook SDK to version 19.0.0.
Updated Firebase SDK to version 12.19.0.
Updated Adjust SDK to version 5.8.0.
Updated Google SignIn SDK to version 9.2.0.
Added MobileIdSdk.xcframework.

Info.plist configuration:¶

Remove the following TikTok configuration:

The TikTokClientKey key and its value.
The TikTok URL scheme from the CFBundleURLSchemes array under CFBundleURLTypes. Keep the Google, Facebook, and Soha URL schemes.
The tiktokopensdk, tiktoksharesdk, snssdk1180, and snssdk1233 entries from LSApplicationQueriesSchemes.

Update LSApplicationQueriesSchemes to the following values:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>fbauth2</string>
    <string>fbapi</string>
    <string>fb-messenger-share-api</string>
</array>

See Configure Info.

Added¶

Added SceneDelegate integration support through SohaKit openURLContexts:. See SceneDelegate for scene setup and migration. Forward URL callbacks from SceneDelegate to the SDK:

SceneDelegate.m

- (void)scene:(UIScene *)scene
    openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    [SohaKit openURLContexts:URLContexts];
}

Added SohaKit requestReview to request an in-app App Store rating or review.

Version 1.3.2.5 - 06/08/2026¶

Changes¶

Fixed bugs and improved performance.

Version 1.3.2.4 - 08/07/2026¶

Changes¶

Update third-party SDK:¶

Update Adjust to version 5.7.0
Update FacebookSDK to version 18.1.0

Added:¶

Added NSMicrophoneUsageDescription and NSCameraUsageDescription to the required Info.plist configuration. Please update your project according to the Configure Info.plist file guide.

Removed:¶

Removed Clarity framework.
Removed TikTokBusiness SDK.

Warning

You must remove Clarity.xcframework and TikTokBusinessSDK.xcframework from your project. These frameworks are no longer used by the SDK and should not be included in the app.

Version 1.3.2.3 - 05/05/2026¶

Changes¶

Breaking Change:¶

Renamed core class from SohaSDK to SohaKit.

// Before
[SohaSDK startWithDelegate:self
                application:[UIApplication sharedApplication]
                launchOptions:launchOptions
                loginManually:YES
                language:@"vi"];

// Now (Version 1.3.2.3)
[SohaKit startWithDelegate:self
                application:[UIApplication sharedApplication]
                launchOptions:launchOptions
                language:@"vi"];

Warning

This is a breaking change. Your code will not compile until the rename is applied.

Update third-party SDK:¶

Added Clarity framework (requires Embed & Sign in Xcode project settings)
Update Adjust to version 5.6.2
Update Google SignIn to version 9.1.0

Added:¶

Added SohaCDNDownloadStartEvent and SohaCDNDownloadCompleteEvent to track CDN resource downloading events. These two events must be integrated manually in your implementation

// Logs a start event immediately,
// then logs a complete event after the CDN download is complete.
[SohaKit logCustomEvent:SohaCDNDownloadStartEvent];

// Simulate the actual CDN download process
[SohaKit logCustomEvent:SohaCDNDownloadCompleteEvent];

Version 1.3.2.2 - 20/01/2026¶

Changes¶

Update third-party SDK:¶

Update Adjust to version 5.5.1
Removed TikTokOpenSDK.xcframework. Please ensure this file is deleted if previously added.
The TiktokAppID key in Info.plist has been replaced by TikTokClientKey. Please update your configuration accordingly.

Added¶

Added SohaSDK:application:continueUserActivity method.
Added Associated Domains (applinks) requirement.
Please add applinks:account.sohagame.vn to the Associated Domains capability in Xcode.

Removed¶

Removed TikTokOpenSDK.xcframework. Please ensure this file is deleted if previously added.

Version 1.3.2.1 - 11/11/2025¶

Changes¶

Breaking change:¶

SohaSDK's minimum supported version has been updated to iOS 14.

Update method¶

Danger

You no longer need to call the requestTrackingAuthorizationWithCompletionHandler method. The SDK now handles this flow automatically. Calling this method manually with the new SDK may result in unexpected errors.

Updated startWithDelegate method: removed the loginManually parameter.

// Before
[SohaSDK startWithDelegate:self
                application:[UIApplication sharedApplication]
                launchOptions:launchOptions
                loginManually:YES
                language:@"vi"];

// Now
[SohaSDK startWithDelegate:self
                application:[UIApplication sharedApplication]
                launchOptions:launchOptions
                language:@"vi"];

Renamed method logSetRoleEventWithRoleName to mapUserGame.
Renamed method logCreateCharacterEventWithRoleName to logCreateCharacterWithName.
Renamed method changeLanguage to setLanguage.

Update third-party SDK:¶

Add TikTokBusiness SDK
Add Adjust SDK
Update Firebase SDK to version 11.14.0

Removed¶

Appsflyer integration is no longer supported and has been removed from the SDK.
The setWindow method has been removed.
The setBaseURL method has been removed.
The getListProduct method has been removed.
The payProductShowLoadingWithID: ext: method is removed. Now, use the payProductWithID: ext: method instead, which will show the loading screen by default.

Version 1.3.2.0 - 22/09/2025¶

This version is deprecated. Please use version 1.3.2.1 instead.

Version 1.3.1.2 - 22/05/2025¶

Changes¶

Language Parameter Now Requires ISO 639-1 Code:¶

The language value is no longer accepted as an enum. You must now provide a language code following the ISO 639-1 standard (e.g., “en” for English, etc.).

[SohaSDK startWithDelegate:self
               application:[UIApplication sharedApplication]
             launchOptions:launchOptions
             loginManually:YES
                  language:@"en"];

[SohaSDK changeLanguage:@"en"];

Update third-party SDK:¶

Update Facebook SDK to version 18.0.0
Update Firebase SDK to version 11.12.0
Update AppsFlyer to version 6.17.0

Version 1.3.1.1 - 10/01/2025¶

Changes¶

Update third-party SDK:¶

Update Firebase SDK to version 11.6.0
Update AppsFlyer to version 6.15.2

Added¶

Added GoogleService-Info.plist file. See more.

Version 1.3.1.0 - 26/09/2024¶

Changes¶

Breaking change:¶

SohaSDK's minimum supported version has been updated to iOS 13.

Update third-party SDK:¶

Update Facebook SDK to version 17.1.0
Update Firebase SDK to version 11.2.0
Update AppsFlyer to version 6.15.0
Update GoogleSignin to version 8.0.0

Removed¶

Breaking change: The SohaSDK.bundle file has been removed.

Version 1.3.0.4 - 11/09/2024¶

Added¶

Added openDashboard.

Version 1.3.0.3 - 23/04/2024¶

Changes¶

Update third-party SDK¶

Update Facebook SDK to version 17.0.0
Update Firebase SDK to version 10.23.0
Update AppsFlyer to version 6.14.0

Version 1.3.0.2 - 15/11/2023¶

Changes¶

In version 1.3.0.2, when making in-app purchases, you must call the payProductWithID:ext or payProductShowLoadingWithID:ext methods.

Update third-party SDK¶

Update Facebook SDK to verison 16.2.1
Update Firebase SDK to version 10.17.0
Update Google SignIn to version 7.0.0
Update AppsFlyer to version 6.12.2

Added¶

Add PrivacyInfo.xcprivacy file.
Added sohaDidStartSuccess delegate.
Added sohaDidLoginSuccess:(SohaUser *)user delegate.

Removed¶

The payProductShowLoadingWithID method is removed.
The payProductWithID method is removed.

Version 1.3.0.1 - 03/07/2023¶

Starting from version 1.3.0.1, SohaGame SDK will not automatically display popup requesting tracking authorization (for iOS versions 14.5 and above). You need to request tracking authorization manually. The SDK also provides a requestTracking method to present App Tracking Transparency authorization request.

Changes¶

Added requestTracking method
Upgrade Appsflyer 6.12.0

Removed¶

The enableTrackingPreAlertScreen method is removed.