Install Realm - Flutter SDK
On this page
Prerequisites
Install Flutter in your development environment. To use the latest version of the Realm SDK, you must use Flutter version 3.0.3 or later and Dart version 2.17.5 or later.
Warning
Incompatible with Dart 2.17.3
The Realm Flutter SDK and Realm Dart Standalone SDK are not compatible with Dart 2.17.3 due to an issue with the Dart virtual machine in this version. You may use Dart 2.17.5 version or later with Realm.
Installation
Follow these steps to add the Realm Flutter SDK to your Flutter project.
Note
Use Realm with Only Dart
In addition to using Realm with Flutter, you can also use Realm only with Dart, like a CLI application or web server.
The usage for Realm with Dart is the same as the Flutter SDK, except you must install and set up a separate package.
Create a Flutter Project
Create a Flutter project. Follow the instructions in the Flutter documentation.
flutter create <app_name> cd <app_name>
Add Realm to the Project
To add the Realm Flutter SDK to your project, run the command:
flutter pub add realm
This downloads the realm package and adds it to your project.
In your pubspec.yaml file, you should see:
dependencies: realm: <latest_version>
Import Realm Package
To use the Realm Flutter SDK within your app, import the package into files where you will use it:
import 'package:realm/realm.dart';
Note
Using Networking in your macOS App
If you are developing with the Realm Flutter SDK in the macOS App Sandbox, network requests do not work by default due to built-in macOS security settings. To fix this, you must change the Flutter app's macOS network entitlements.
To learn how to do this, refer to Use Realm with the macOS App Sandbox.
Dart Standalone Installation
To use Realm with Dart but not Flutter, there is a separate
Dart SDK package with its own installation process.
The Dart SDK can be used for CLI applications or when running Dart in a server environment.
The Dart standalone package realm_dart has the same usage as the Flutter package
except where otherwise noted.
Create a Dart Project
Create a Dart project.
Note
Using Dart without Flutter
The official Dart docs have helpful getting started material for using Dart without Flutter for CLI and server use cases.
Add Realm to the Project
To add the Realm Dart SDK to your project, run the command:
dart pub add realm_dart
This downloads the realm_dart package and adds it to your project.
In your pubspec.yaml file, you should see:
dependencies: realm_dart: <latest_version>
Install Realm into Application
Install the realm_dart package into the application.
This downloads and copies the required native binaries to the app directory.
dart run realm_dart install
Import Realm Package
To use the Realm Dart SDK within your app, import the package into files where you will use it:
import 'package:realm_dart/realm.dart';
Update Package Version
To change the version of the Flutter SDK or Dart Standalone SDK in your project, follow these steps.