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...选项。

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