Install the SDK for iOS, macOS, tvOS, and watchOS

Add Package Dependency

In Xcode, select File > Add Packages....

Specify the Repository

Copy and paste the following into the search/input box.

https://github.com/realm/realm-swift.git

Specify Options

In the options for the realm-swift package, we recommend setting the Dependency Rule to Up to Next Major Version, and enter the current Realm Swift SDK version . Then, click Add Package.

Select the Package Products

Select either RealmSwift or Realm, then click Add Package.

• If you use Swift or Swift and Objective-C APIs, add RealmSwift.

• If you use only Objective-C APIs, add Realm.

(Optional) Build RealmSwift as a Dynamic Framework

To use the Privacy Manifest supplied by the SDK, build RealmSwift as a dynamic framework. If you build RealmSwift as a static framework, you must supply your own Privacy Manifest.

To build RealmSwift as a dynamic framework:

1. In your project Targets, select your build target.

2. Go to the General tab.

3. Expand the Frameworks and Libraries element.

4. For the RealmSwift framework, change the Embed option from "Do Not Embed" to "Embed & Sign."

Now, Xcode builds RealmSwift dynamically, and can provide the SDK-supplied Privacy Manifest.

Update the CocoaPods repositories

On the command line, run pod repo update to ensure CocoaPods can access the latest available Realm versions.

Initialize CocoaPods for Your Project

If you do not already have a Podfile for your project, run pod init in the root directory of your project to create a Podfile for your project. A Podfile allows you to specify project dependencies to CocoaPods.

Add the SDK as a Dependency in Your Podfile

# Uncomment the next line to define a global platform for your project
# platform :ios, '11.0'
target 'MyDeviceSDKProject' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
# Pods for MyDeviceSDKProject
pod 'Realm', '~>10'
target 'MyRealmProjectTests' do
   inherit! :search_paths
   # Pods for testing
   pod 'Realm', '~>10'
end
end

platform :ios, '12.0'
target 'MyDeviceSDKProject' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  # Pods for MyDeviceSDKProject
  pod 'RealmSwift', '~>10'
end

Install the Dependencies

From the command line, run pod install to fetch the dependencies.

Use the CocoaPods-Generated .xcworkspace File

CocoaPods generates an .xcworkspace file for you. This file has all of the dependencies configured. From now on, open this file -- not the .xcodeproj file -- to work on your project.

Add the SDK as a Dependency in Your Cartfile

Add the SDK as a dependency by appending the line github "realm/realm-swift" to your Cartfile.

You can create a Cartfile or append to an existing one by running the following command in your project directory:

echo 'github "realm/realm-swift"' >> Cartfile

Install the Dependencies

From the command line, run carthage update --use-xcframeworks to fetch the dependencies.

Add the Frameworks to Your Project

Carthage places the built dependencies in the Carthage/Build directory.

Open your project's xcodeproj file in Xcode. Go to the Project Navigator panel and click your application name to open the project settings editor. Select the General tab.

In Finder, open the Carthage/Build/ directory. Drag the RealmSwift.xcframework and Realm.xcframework files found in that directory to the Frameworks, Libraries, and Embedded Content section of your project's General settings.

click to enlarge

Download and Extract the Framework

Download the latest release of the Swift SDK and extract the zip.

Copy Framework(s) Into Your Project

Drag Realm.xcframework and RealmSwift.xcframework (if using) to the File Navigator of your Xcode project. Select the Copy items if needed checkbox and press Finish.