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.
Supported Platforms
You can use the Realm Flutter SDK on the following platforms:
iOS
Android
macOS
Windows
Linux running on 64-bit architecture
You cannot use the Realm Flutter SDK on the following platforms:
Web
Linux running on ARM64 or 32-bit architectures
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>
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.
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>
Update Package Version
To change the version of the Flutter SDK or Dart Standalone SDK in your project, follow these steps.