Skip to content

Add SohaGame SDK to Xcode project

Prerequisites

  • Install the following: Xcode 26 or later
  • Make sure that your project meets these requirements:
    • iOS 14
  • Set up a physical Apple device run your app.

Warning

All third-party frameworks used by this SDK are static and must be set to Do Not Embed. The only exception is Clarity, which is a dynamic framework and must be set to Embed & Sign.
In Xcode, go to TargetGeneralFrameworks, Libraries, and Embedded Content and apply the following:

Framework Setting
Clarity.xcframework Embed & Sign
All others Do Not Embed

Download and install the SDK

Step 1: Download

The SDK is distributed as a static framework, so you need to manually download the SDK and 3rd party dependency frameworks, then add it to your Xcode project.

Download SohaSDK

The SDK requires the following 3rd party dependency frameworks:

  • Firebase
  • Facebook
  • Google SignIn
  • Adjust
  • Clarity
  • TikTokBusinessSDK

Download all 3rd party dependency frameworks

Step 2: Unzip

Unzip all the .zip files you just downloaded.

Step 3: Import in project

  1. Drag the SohaSDK.xcframework and all folder of dependent frameworks, drop it into your Xcode project. In the dialog box that appears, make sure the target you want the framework to be added to has a checkmark next to it, and that you've selected "Copy items if needed".

  2. Add the -ObjC flag to Other Linker Settings:

    a. In your project settings, open the Settings panel for your target.

    b. Go to the Build Settings tab and find the Other Linker Flags setting in the Linking section.

    c. Double-click the setting, click the '+' button, then add -ObjC Add the -ObjC flag