Overview
Realm Studio te ofrece herramientas para realizar cambios permanentes en tu esquema. Puedes:
Importante
Si realiza cambios en su esquema en Realm Studio, deberá migrar el archivo de reino cuando lo use en su aplicación cliente.
Tras realizar cambios en el esquema, puede agregar valores a las nuevas propiedades y clases desde Realm Studio. También puede crear nuevos objetos basados en sus nuevas clases y propiedades. Esto le proporciona una interfaz gráfica de usuario (GUI) para experimentar con cambios en su esquema hasta obtener el modelo de objetos que necesita.
Una vez completados los cambios, puedes exportar las definiciones de tus modelos desde Realm Studio. Esto te proporcionará nuevas definiciones de clase en el lenguaje que prefieras, que puedes incorporar a tu código.
También puedes guardar una versión actualizada del archivo realm para usarla en tu aplicación. Al guardar un archivo realm con un esquema actualizado, debes realizar una migración para usarlo en tu aplicación.
Agregar una clase al esquema
Para agregar una nueva clase a su esquema:
Presione el + botón junto al encabezado Classes en la esquina superior izquierda de la ventana de Realm Studio
Nombra tu nueva clase
Designar una clave principal (opcional)
Presione el botón Add class
Ahora verás una nueva clase en la lista de clases que se muestra en la barra lateral izquierda.
Agregar una propiedad a la clase
Para agregar propiedades a una clase:
Seleccione la clase donde desea agregar propiedades en la barra lateral izquierda
Presione el botón + debajo del botón Create {Class Name} en la esquina superior derecha de la ventana de Realm Studio
Ponle nombre a tu nueva propiedad
Seleccione un tipo para su nueva propiedad desde el selector desplegable
Haga clic en las casillas de verificación para seleccionar Make this a list of strings y Optional: Allow a null value si es necesario
Presione el botón Add property
Verá su nueva propiedad mostrada junto con las demás propiedades de la clase.
Si ya tiene objetos en su clase, puede agregar valores a esta propiedad haciendo clic en el campo correspondiente a cada valor. Si se trata de una clase nueva sin objetos, puede crear nuevos objetos en ella.
Guardar definiciones de modelos
Después de realizar cambios en su esquema, puede exportar su nuevo esquema como definiciones de clase.
Para exportar definiciones de clases actualizadas:
Vaya a File > Save model definitions y seleccione su idioma preferido. Los idiomas compatibles son: Swift, JavaScript, TypeScript, Java, Kotlin y C#.
Especifique un nombre y un destino para las nuevas definiciones de clase. Pulse el botón Save.
Si tu directorio de destino aún no existe, Realm Studio lo crea. Dentro, encontrarás un archivo con una lista completa de clases y propiedades, incluyendo las nuevas incorporaciones.
Esta es una excelente herramienta para iterar en tu esquema. También puedes exportar definiciones de clases en varios idiomas para el desarrollo multiplataforma.
Realizar una migración
Después de realizar cambios en el esquema, puede agregar valores a nuevas propiedades e incluso crear nuevos objetos. Si desea usar este archivo de dominio actualizado en su aplicación, puede guardar los datos. Sin embargo, antes de usarlo en su aplicación cliente, deberá realizar una migración.
Realm requiere que incrementes la versión monótonamente al cambiar el esquema. Si intentas abrir un reino con un esquema de objeto actualizado sin migrar, tu cliente generará un error.
Para obtener instrucciones sobre cómo completar esta migración, consulte la guía de migración de su SDK.