Quick Start for Unity - .NET SDK

Agregar NPM como un registro con alcance

Before you can download and use Realm within your Unity project, you must add NPM as a scoped registry. Adding NPM as a scoped registry configures Unity to communicate with NPM, allowing you to install packages, such as Realm.

Abra el administrador de paquetes de Unity haciendo clic en el icono Window Pestaña en la parte superior del menú de Unity. Haga clic en Package Manager en Window dropdown. Luego, haga clic en el icono del engranaje en la esquina derecha. Seleccione la opción Advanced Project Settings en el menú desplegable.

Rellena el formulario de registro específico con los detalles a continuación y haz clic en el botón guardar.

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

Agregar Realm al manifiesto del proyecto

Now that Unity can install the Realm .NET SDK from NPM, you need to add Realm as a dependency in your project's manifest file. Open "Packages/manifest.json" file in Visual Studio or another text editor. At the bottom of the dependency's object, add the field, "io.realm.unity" and its value, the Realm .NET version number you want to use in quotes.

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

Recuerda reemplazar el <version-number> anterior con el número de versión. Puedes encontrar la última versión en el repositorio de GitHub realm-dotnet. Tu archivo de manifiesto completo debería ser similar a lo siguiente:

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

When you save this file, Unity downloads the specified version of the Realm .NET SDK package from the NPM registry.

Verify the Realm Dependency and Check for Updates

To verify that the Realm package has been downloaded from NPM, open your Unity package manager by clicking the Window tab on the top of the Unity menu. Click Package Manager from the Window dropdown. You should see Realm on the "Packages: In Project" tab.

Si ves un icono de marca de verificación verde junto al número de versión del paquete Realm, significa que tu paquete está actualizado. Sin embargo, si ves el icono de flecha hacia arriba, significa que hay una nueva versión del paquete disponible. Al hacer clic, te da la opción de actualizar a la versión más reciente.

Download the Latest Realm .NET SDK Release

Antes de comenzar a usar Realm dentro de tu proyecto de Unity, debes descargar el SDK de Realm .NET.

Navigate to the realm-dotnet repository releases page, and scroll down to the release you want to use in your project. If you are unsure of which release to use, you can use the one labeled "latest release" on the left row.

Desplázate hasta <version-number> el menú desplegable"Activos" de la versión y haz clic en el enlace etiquetado como"io.realm.unity-<versión-número>.tgz" para descargar el SDK.

Add the Tarball to Your Projects Package Manager

Move your downloaded Realm .NET SDK tarball inside of your project. You can do this by dragging and dropping the file into your project's folder. Copying the tarball to your project folder and committing it to version control ensures other developers working on the project can just clone the repository and build without manually downloading the Realm dependency.

Next, you must load the tarball into your project using the Unity package manager.

To open the package manager, click the Window tab on the top of the Unity menu. Click Package Manager from the Window dropdown. Once the package manager model opens, click the + icon in the top left corner of the model. Select the Add package from tarball... option.

Select your "io.realm.unity-bundled-<version-number>.tgz" file to begin importing your project.