Unity
Usage Requirements
Supported Development Environment
- Android:
- Minimum version Android 9 (Pie)
- iOS:
- Minimum version iOS 14
- Minimum Xcode 15.3
- Unity:
- Unity 2022
- Gradle Version:
- The minimum required Gradle version for Unity projects depends on the Unity version you are using. Refer to the official Gradle for Android documentation and the Android environment setup page for details.
Third-Party Dependencies
The Noctua SDK already includes the following third-party libraries:
- Firebase Analytics
- Firebase Crashlytics
- Adjust SDK
- Facebook SDK
You do not need to install these plugins manually.
However, if your game also uses these SDKs for internal features, you can still include them — but you must match the same versions used by Noctua to avoid conflicts.
This version alignment is required only for iOS.
On Android, there are no conflicts even if you use different versions.
SDK Versions Used by Noctua (iOS)
SDK | Version |
---|---|
Adjust iOS Native SDK | 4.38.4 |
Firebase iOS Native SDK | 11.6.0 |
Facebook iOS Native SDK | 17.0.2 |
Please ensure you use the same versions above when integrating your own iOS dependencies to prevent symbol or linking conflicts.
Application.version
It is mandatory to set the Application.version
property with your game version to ensure proper functionality of the SDK. This property allows the SDK to identify the current version of your application, which is essential for features like version-specific configurations, analytics tracking, and compatibility checks.
To set the version number in Unity, go to Edit
> Project Settings
> Player
. Please use Semantic Versioning as your game version format.
Reference: https://semver.org/
PlayerPrefs
You must not remove any PlayerPrefs keys that begin with the Noctua
prefix and NativeGalleryPermission
. These keys are critical for the SDK's internal operations, such as storing configuration data, maintaining user state, and ensuring consistent functionality across game sessions. Deleting or altering these keys can result in unexpected behavior, data loss, or failures in essential SDK features.
If your game logic requires clearing persistent data within PlayerPrefs, please exclude all keys in this list below:
- NoctuaFirstOpen
- NoctuaWebContent.Announcement.LastShown
- NoctuaAccountContainer.UseFallback
- NoctuaAccountContainer
- NoctuaPendingPurchases
- NoctuaLocaleCountry
- NoctuaLocaleCurrency
- NoctuaLocaleUserPrefsLanguage
- NativeGalleryPermission
- NoctuaUnpairedOrders
- NoctuaPurchaseHistory
- NoctuaEvents