Modificar esquema em um Realm Studio

Visão geral

O Realm Studio oferece ferramentas para fazer alteração não interruptiva no esquema. Você pode:

• Adicionar classes ao esquema

• Adicionar propriedades às classes

Depois de fazer alterações no esquema, você pode adicionar valores às novas propriedades e classes de dentro do Realm Studio. Você também pode criar novos objetos com base em suas novas classes e propriedades. Isso fornece a você uma ferramenta de interface gráfica do usuário (GUI) para experimentar alterações no esquema até obter o modelo de objetos de que precisa.

Quando concluir suas alterações, você poderá exportar suas definições de modelo do Realm Studio. Isso fornece novas definições de classe no idioma de sua escolha, que você pode incluir no código.

Você também pode salvar uma versão atualizada do arquivo realm para usar em seu aplicativo. Ao salvar um arquivo de domínio com um esquema atualizado, você deve realizar uma migração para usá-lo em seu aplicativo.

Adicionar uma classe ao esquema

Para adicionar uma nova classe ao seu esquema:

• Pressione o botão + ao lado do cabeçalho Classes no canto superior esquerdo da janela do Realm Studio

• Dê um nome à sua nova turma

• Designar uma chave primária (opcional)

• Pressione o botão Add class

Agora você verá uma nova turma na lista de turmas exibida na barra lateral esquerda.

Adicionar uma propriedade à classe

Para adicionar propriedades a uma classe:

• Selecione a classe onde você deseja adicionar propriedades na barra lateral esquerda

• Pressione o botão + abaixo do botão Create {Class Name} no canto superior direito da janela do Realm Studio

• Dê um nome à sua nova propriedade

• Selecione um tipo para sua nova propriedade no seletor suspenso

• Clique nas caixas de seleção para selecionar Make this a list of strings e Optional: Allow a null value , se necessário

• Pressione o botão Add property

Você verá sua nova propriedade exibida ao lado das outras propriedades da classe.

Se você já tiver objetos em sua classe, poderá adicionar valores para esta propriedade clicando no campo da propriedade para cada valor. Se esta for uma nova classe sem objetos, você poderá criar novos objetos na classe.

Salvar definições do modelo

Depois de fazer alterações em seu esquema, você poderá exportar seu novo esquema como definições de classe.

Para exportar definições de classe atualizadas:

• Vá para File > Save model definitionse selecione a linguagem preferida. Linguagens suportadas incluem: Swift, JavaScript, TypeScript, Java, Kotlin e C#.

• Especifique um nome e um destino para suas novas definições de classe. Pressione o botão Save.

Se o seu diretório de destino ainda não existe, o Realm Studio cria-o. Dentro, você encontrará um arquivo que contém uma lista completa de classes e propriedades, incluindo novas adições.

Esta é uma ótima ferramenta para iterar em seu esquema. Você também pode exportar definições de classe em vários idiomas para desenvolvimento de plataforma cruzada.

Executar uma migração

Depois de fazer alterações em seu esquema, você pode adicionar valores a novas propriedades e até mesmo criar novos objetos. Se você quiser usar esse Arquivo de Realm atualizado em seu aplicativo, poderá salvar os dados. No entanto, antes de usá-lo em seu aplicativo cliente, você precisará realizar uma migração.

O Realm exige que você incremente a versão monotonicamente quando alterar o esquema. Se você tentar abrir um Realm com um esquema de objetos atualizado sem migrar, seu cliente lançará um erro.

Para obter instruções sobre como concluir essa migração, consulte o guia de migração do seu SDK.