iOS Native

Getting started

Welcome to the Noctua SDK for iOS Native(Swift)!
This guide will walk you through integrating our SDK into your iOS game project.
Follow these steps to set up the SDK, configure your project, and initialize Noctua features in your app.

Preparation

Before starting the integration, ensure you have all the required configuration files for the Noctua SDK.

Get SDK Configuration Files

To use the Noctua SDK, you must have the main configuration file named noctuagg.json.
Depending on your publishing setup, you may also need the GoogleService-Info.plist file from Firebase.

Configuration Parameters

  • offlineFirstEnabled (boolean) – Set to true if your game supports offline-first behavior.

Place your configuration files in your Xcode project directory, usually under Project/.

Important

If you haven't received your SDK configuration files yet, please contact our team at [email protected] to get started.


Installation

You can install the Noctua SDK via CocoaPods.

Add the following to your Podfile:

pod 'NoctuaSDK'

Then run:

pod install

Initialization

To initialize the SDK, call Noctua.initNoctua() in your App during application launch:

@main
struct NoctuaSDKExampleApp: App {
    
    init() {
        try! Noctua.initNoctua()
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
Previous
Tracking revenue