Unity 快速入门 - .NET SDK

将 NPM 添加为限定范围的注册表

在下载并在 Unity 项目中使用 Realm 之前，必须将 NPM 添加为限定范围的注册表。将 NPM 添加为限定范围的注册表可将 Unity 配置为与 NPM 通信，从而允许您安装软件包，例如 Realm。

打开 Unity包管理器 Window单击Unity菜单顶部的 标签页。单击Package Manager中的Window dropdown 。 然后，单击右上角的齿轮图标。 从下拉列表中选择Advanced Project Settings选项。

使用以下详细信息填写限定范围的注册表单，然后单击“保存”按钮。

name = NPM
URL = https://registry.npmjs.org
Scope(s) = io.realm.unity

将 Realm 添加到项目清单

现在 Unity 可以从 NPM 安装 Realm .NET SDK 了，您需要将 Realm 作为依赖项添加到项目的清单文件中。在 Visual Studio 或其他文本编辑器中打开“Packages/manifest.json”文件。在依赖对象的底部，添加字段“io.realm.unity”及其值，即要用引号括起来的 Realm .NET 版本号。

"io.realm.unity": "<version-number>"

请记住将上面的 <version-number> 替换为实际版本号。您可以在 realm-dotnet GitHub 存储库 中找到最新版本 。您的完整清单文件应如下所示：

{
 "dependencies": {
   ...
   "io.realm.unity": "10.21.0"
 },
 "scopedRegistries": [
   {
     "name": "NPM",
     "url": "https://registry.npmjs.org/",
     "scopes": [
       "io.realm.unity"
     ]
   }
 ]
}

保存此文件时，Unity 会从 NPM 注册表下载指定版本的 Realm .NET SDK 包。

验证 Realm 依赖关系并查看更新

要验证是否已从 NPM 下载 Realm 包，请通过单击 Unity 菜单顶部的 Window 标签页打开 Unity 包管理器。单击 Window 下拉列表中的 Package Manager。你应该在 "Packages: In Project" 标签页上看到 Realm。

如果您在 Realm 包的版本号旁看到绿色的复选图标，则表示此包是最新的。但是，如果您看到向上箭头图标，则表明此包有新版本可用。单击此图标，您就可以选择升级到最新版本。

下载最新版 Realm .NET SDK

在Unity项目中开始使用Realm之前，您必须下载Realm .NET SDK。

导航到 realm-dotnet存储库版本 页面，然后向下滚动到要在项目中使用的发布。如果不确定使用哪个发布，可以使用左行标有“最新版本”的版本。

向下滚动到版本的 “资产” 下拉列表，然后单击标有 “io.realm.unity-<version-number> .tgz” 的链接以下载 SDK。

将 Tarball 添加至您的项目包管理器

将下载的Realm .NET SDK tarball 移至项目中。 为此，您可以将文件拖放到项目的文件夹中。 将 tarball 复制到项目文件夹并将其提交给版本控制，可确保处理该项目的其他开发者只需克隆存储库并进行构建，而无需手动下载Realm依赖项。

接下来，您必须使用 Unity包管理器 将 tarball 加载到项目中 。

要打开包管理器，请单击Unity菜单顶部的Window标签页。 单击Package Manager中的Window dropdown 。 包管理器模型打开后，单击模型左上角的+图标。 选择Add package from tarball...选项。

选择“域.unity-bundled-<version-number>.tgz” 文件以开始导入项目。