Docs Menu
Docs Home
/ /
Atlas Device SDKs
/

Platform and Framework Compatibility - .NET SDK

On this page

  • Compatibility
  • Development Environments
  • Android Deployment
  • Limitations

The following table shows which .NET version(s) you can use with Realm on your target platforms:

Target Platform
Supported Version(s)
Debian 8 or later
RHEL 7.1 or later
Ubuntu 16.04 or later
.NET Core 2.0 or later (.NET Framework 5.0 or later)
Windows 8.1 or later
.NET Core 2.0 or later (.NET 5.0 Framework or later)
.NET Framework 4.6.1 or later
MAUI requires Windows 11 and Windows 10 version 1809 or higher, using Windows UI Library (WinUI) 3.
Universal Windows Platform (UWP)
.NET Standard 2.0 or later (Fall Creators Update)
macOS
.NET Core 2.0 or later (.NET 5.0 Framework or later)
Xamarin.Mac for macOS 10.11 or later.
MAUI requires macOS 10.15 or later, using Mac Catalyst.
iOS
Xamarin.iOS for iOS 9 or later.
MAUI requires iOS 11 or later.
Android
Xamarin.Android for Android 4.1 (API level 16) or later.
MAUI requires Android 5.0 (API level 21) or later.
tvOS
Xamarin and Unity for tvOS 9.0 or later.
For more information on developing for tvOS, see Build for tvOS.

You can use the following development environments to build Realm apps with the .NET SDK:

  • Visual Studio 2015 Update 2 or higher for Windows

  • Visual Studio for Mac 7.0 or higher

  • Unity 2020.3.12f1 (LTS)

Note

The Realm .NET SDK may be compatible with other versions of Unity, but 2020.3.12f1 (LTS) is the version that the Realm team uses for testing and development. We recommend using this version to ensure your project works with Realm and that the install steps match the Integrate Realm with Unity documentation steps because Unity's UI often changes between versions.

Due to some instruction set limitations, Realm does not support deploying Android apps to the armeabi ABI. Because default templates often have different ABI settings for Debug and Release modes, your app may throw a System.TypeInitializationException exception in Release mode but not when it was running in Debug mode.

To avoid this, verify the ABI settings for both Debug and Release modes. To check and change the settings, follow the steps in the Visual Studio CPU Architectures page.

Unless you have a good reason to avoid linking other ABIs, we recommend checking all of the settings other than armeabi.

Realm has limits imposed to balance flexibility with performance. The SDK throws an exception during app initialization if the following limits are exceeded:

  • Class names can't exceed 57 bytes in length.

  • Property names can't exceed 63 bytes in length.

In addition, for iOS apps, the total size of all open Realm files cannot be larger than the amount of memory your application is allowed to map in iOS. This varies per device, and depends on how fragmented the memory space on the device is. If you need to store more data than is allowed, you can split your data into multiple Realm files, open a realm only when needed, and close it when it is no longer needed.

For more information, see Open Radar 17119975.

← Logging - .NET SDK