Instale o React Native SDK

Criar um projeto React Native

Crie seu projeto React Native com o seguinte comando:

npx react-native init MyApp

Altere para o diretório de projeto que o comando anterior acabou de criar:

cd MyApp

Instalar o SDK com npm

No seu diretório de projeto React Native, adicione o SDK ao seu projeto com o seguinte comando:

npm install realm

Enable Hermes

O SDK oferece suporte para o mecanismo JavaScript otimizado para dispositivos móveis do React Native, o Hermes. Como padrão, novos aplicativos criados com o React Native CLI já vêm com o Hermes ativado.

Recomendamos que você use Hermes com o SDK. No entanto, o SDK também suporta o mecanismo JavaScriptCore (JSC) se seu aplicativo exigir.

Aplicativos existentes que usam o JSC podem ativar o Hermes separadamente para Android e iOS. Para saber como, consulte o Como usar o Hermes guia nos React Native Docs.

Resolver dependências de CocoaPods

Para o aplicativo para iOS, busque as dependências do CocoaPods com os seguintes comandos do diretório de projeto do React Native:

cd ios && pod install && cd ..

Isso baixa as bibliotecas do SDK e gera novamente o arquivo de projeto .xcworkspace com o qual você pode trabalhar no Xcode para executar seu aplicação.

Estenda a configuração Proguard para o Android

Talvez seja necessário estender sua configuração do Proguard para usá-la com um aplicativo para Android. Na configuração do Proguard, adicione o seguinte:

-keep class io.realm.react.**

Habilitar TypeScript (recomendado, mas opcional)

TypeScript é um superconjunto do JavaScript que adiciona verificação de tipo estático e outros recursos destinados a tornar o desenvolvimento em escala de aplicativos mais robusto. Se você quiser usar o TypeScript em seu projeto, siga os guias oficiais TypeScript e React Native da equipe React Native. O SDK oferece suporte para o TypeScript de forma nativa e se integra facilmente a um projeto TypeScript.

Instalar a biblioteca @domínio/react

@realm/reagir é um pacote npm que simplifica operações comuns do SDK, como consultar, gravar em um banco de dados e escutar notificações de alteração de objeto. Isso reduz os códigos padrão, como a criação de seus próprios ouvintes e gerenciamento de estado.

@realm/react fornece acesso ao SDK por meio de um conjunto de provedores que têm vários hooks. Os hooks atualizam o estado do React quando os dados mudam. Isso significa que os componentes que usam esses hooks são renderizados novamente em qualquer alteração nos dados no banco de dados.

No diretório do projeto React Native, adicione @realm/react ao seu projeto com o seguinte comando:

npm install @realm/react

Execute o aplicativo

O React Native permite o desenvolvimento simultâneo de um aplicativo para iOS e Android que tenha a mesma base de código do React. Você pode editar os arquivos de origem de .js ou .ts no diretório do projeto para desenvolver seu aplicativo.

Em desenvolvimento, os aplicativos leem o código-fonte do React como um pacote de um servidor de pacotes local. Para executar o servidor de pacotes, use o seguinte comando em seu diretório de projeto do React Native:

npm start

Com o servidor de pacotes em execução, agora você pode iniciar os aplicativos Android e iOS:

• Para executar o aplicativo para Android, use o Android Studio para abrir o diretório android no diretório do projeto e clique em Run.

• Para executar o aplicativo iOS, use o Xcode para abrir o arquivo .xcworkspace no diretório ios. Se você não usou o CocoaPods durante a configuração, abra o arquivo .xcodeproj no diretório ios. Após abrir o projeto, clique em Run.

Criar um projeto React Native

Crie seu projeto React Native com o seguinte comando:

react-native init MyApp

Altere para o diretório de projeto que o comando anterior acabou de criar:

cd MyApp

Instalar o SDK usando o NPM

No seu diretório de projeto React Native, adicione o SDK ao seu projeto com o seguinte comando:

npm install realm

Vincular o módulo nativo do SDK

No seu diretório de projeto React Native , vincule o módulo nativo do SDK ao seu projeto com o seguinte comando:

react-native link realm

Confirmar a etapa do link (Android)

Para desenvolvimento para Android, confirme se a etapa do link adicionou corretamente o módulo SDK aos arquivos de configuração do Gradle. Em algumas versões, sabe-se que o React Native não vincula o SDK corretamente. Se isso acontecer, você poderá vincular o SDK manualmente adicionando as linhas ausentes abaixo aos arquivos correspondentes.

Primeiro, certifique-se de que o arquivo android/settings.gradle inclua o SDK e especifique o diretório de projeto do SDK:

rootProject.name = 'MyApp'
include ':realm'
project(':realm').projectDir = new File(rootProject.projectDir, '../node_modules/realm/android')
apply from: file("../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesSettingsGradle(settings)
include ':app'

Em segundo lugar, verifique se a seção android/app/build.gradle do arquivo dependencies declara o SDK como uma dependência:

dependencies {
    implementation project(':realm')
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation "com.facebook.react:react-native:+"  // From node_modules
    // ...
}

Por fim, certifique-se de que o arquivo MainApplication.java importe o RealmReactPackage e o instancie em sua lista de pacotes.

import io.realm.react.RealmReactPackage; // Add this import.
public class MainApplication extends Application implements ReactApplication {
    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            new RealmReactPackage() // Add this line.
        );
    }
    // ...
}

Habilitar TypeScript (opcional)

TypeScript é um superconjunto do JavaScript que adiciona verificação de tipo estático e outros recursos destinados a tornar o desenvolvimento em escala de aplicativos mais robusto. Se você quiser usar o TypeScript em seu projeto, siga os guias oficiais TypeScript e React Native da equipe React Native. O SDK oferece suporte para o TypeScript de forma nativa e se integra facilmente a um projeto TypeScript.

Execute o aplicativo

O React Native permite o desenvolvimento simultâneo de um aplicativo para iOS e Android que tenha a mesma base de código do React. Você pode editar os arquivos de origem de .js ou .ts no diretório do projeto para desenvolver seu aplicativo.

Em desenvolvimento, os aplicativos leem o código-fonte do React como um pacote de um servidor de pacotes local. Para executar o servidor de pacotes, use o seguinte comando em seu diretório de projeto do React Native:

npm start

Com o servidor de pacotes em execução, agora você pode iniciar os aplicativos Android e iOS:

• Para executar o aplicativo para Android, use o Android Studio para abrir o diretório android no diretório do projeto e clique em Run.

• Para executar o aplicativo iOS, use o Xcode para abrir o arquivo .xcworkspace no diretório ios. Se você não usou o CocoaPods durante a configuração, abra o arquivo .xcodeproj no diretório ios. Após abrir o projeto, clique em Run.