Docs 菜单

Docs 主页开发应用程序Atlas Device SDKs

平台和框架兼容性 - .NET SDK

在此页面上

  • 兼容性
  • 开发环境
  • Android 部署
  • 限制

下表显示了可在目标平台上结合使用 Realm 的 .NET 版本:

目标平台
支持的版本
Debian 8 或更高版本
RHEL 7.1 或更高版本
Ubuntu 16.04 或更高版本
.NET Core 2.0 或更高版本(.NET 框架 5.0 或更高版本)
Windows 8.1 或更高版本
.NET Core 2.0 或更高版本(.NET 5.0 Framework 或更高版本)
.NET Framework 4.6.1 或更高版本
Maui 需要 Windows 11 和 Windows 10 版本 1809 或更高版本,并使用 Windows 用户界面 库 (WinUI) 3。
通用 Windows 平台 (UWP)
.NET Standard 2.0 或更高版本(秋季创意者更新)
macOS
.NET Core 2.0 或更高版本(.NET 5.0 Framework 或更高版本)
Xamarin.Mac(适用于 macOS 10.11 或更高版本)。
MAUI 需要使用 Mac Catalyst 的 macOS 10.15 或更高版本。
iOS 版
适用于 iOS 9 或更高版本的 Xamarin.iOS。
MAUI 需要 iOS 11 或更高版本。
Android 版
适用于 Android 4.1(API 级别 16)或更高版本的 Xamarin.Android。
MAUI 需要 Android 5.0(API 级别 21)或更高版本。
tvOS
适用于 tvOS 9.0 或更高版本的 Xamarin 和 Unity。
有关针对 tvOS 进行开发的更多信息,请参阅针对 tvOS 进行构建

您可以使用以下开发环境通过 .NET SDK 构建 Realm 应用:

  • 适用于 Windows 的 Visual Studio 2015 更新 2 或更高版本

  • Visual Studio for Mac 7.0 或更高版本

  • Unity2020 。3 。12 f1 (LTS)

注意

Realm .NET SDK可能与其他版本的 Unity 兼容,但 2020.3.12f1 (LTS)是 Realm 团队用于测试和开发的版本。 我们建议使用此版本,以确保您的项目可与 Realm 配合使用,并且安装步骤与将 Realm 与 Unity 集成文档步骤相匹配,因为 Unity 的用户界面经常在版本之间发生变化。

由于某些指令集限制,Realm 不支持将 Android 应用部署到armeabi ABI。 由于默认模板通常针对“调试”和“发布”模式具有不同的 ABI 设置,因此您的应用可能会在“发布”模式下引发System.TypeInitializationException异常,但在“调试”模式下运行时不会引发异常。

为避免这种情况,请验证“调试”和“发布”模式的 ABI 设置。要检查和更改设置,请按照 Visual Studio CPU 架构 页面。

除非您有充分的理由避免链接其他 ABI,否则我们建议检查除armeabi之外的所有设置。

Realm 为了平衡灵活性和性能而施加了一些限制。 如果超出以下限制,SDK 会在应用程序初始化期间引发异常:

  • 类名的长度不能超过 57 个字节。

  • 属性名称的长度不能超过 63 个字节。

此外,对于 iOS 应用程序,所有打开的 Realm 文件的总大小不能大于 iOS 中允许应用程序映射的内存量。 这因设备而异,并且取决于设备上内存空间的碎片化程度。 如果您需要存储的数据超过允许的数量,您可以将数据分割为多个 Realm 文件,仅在需要时打开 Realm,并在不再需要时将其关闭。

有关详细信息,请参阅 开放式 Radar17119975

← 日志记录 - .NET SDK