iOS, macOS, tvOS 및 watchOS용 SDK 설치

이 페이지의 내용

개요

전제 조건
설치
SDK 가져오기
앱 다운로드 파일 크기
문제 해결
OS 지원
스위프트 동시성 지원
Apple 개인정보 취급방침

Realm은 Atlas Device SDK로 변경되었습니다. – 자세히 알아보기

개요

Swift용 Atlas Device SDK를 통해 Swift 또는 오브젝티브-C 프로그래밍 언어를 사용하여 iOS, macOS, tvOS 및 watchOS 애플리케이션을 구축할 수 있습니다. 이 페이지에서는 프로젝트에 SDK를 설치하고 시작하는 방법을 자세히 설명합니다.

전제 조건

시작하기 전에 개발 환경이 다음 전제 조건을 충족하는지 확인하세요.

iOS 11.0 이상, macOS 10.13 이상, tvOS 11.0 이상 또는 watchOS 4.0 이상을 대상으로 하는 Xcode 14.1-14.3.1.
프로젝트에 리플렉션이 활성화되어 있습니다. Swift SDK는 리플렉션을 사용하여 모델의 속성을 결정합니다. 프로젝트는 SWIFT_REFLECTION_METADATA_LEVEL = none을(를) 설정하면 안 됩니다. 그렇지 않으면 SDK가 모델의 속성을 볼 수 없습니다. 리플렉션은 프로젝트가 이 세팅에 대한 레벨을 구체적으로 설정하지 않는 경우 기본적으로 활성화됩니다.

버전 10.40.0에서 변경됨

Swift SDK 버전 10.40.0은 Xcode 13에 대한 지원을 중단합니다. v10.39.01 이전 버전에는 다음 Xcode 13 요구 사항이 적용됩니다.

Xcode 버전 13 1. 이상입니다.
Xcode 13을 사용하는 경우 iOS 9.0 이상, macOS 10.9 이상, tvOS 9.0 이상 또는 watchOS 2.0 이상을 대상으로 합니다.
Xcode 13과 함께 Swift 패키지 관리자를 사용하는 경우 iOS 11 이상 또는 macOS 10.10 이상의 타겟이 필요합니다.

참고

tvOS와 함께 SDK를 사용할 때는 특별히 고려해야 할 사항이 있습니다. 자세한 내용은 tvOS용 빌드를 참조하세요.

설치

SwiftPM, CocoaPods 또는 Carthage을(를) 사용하여 프로젝트에 Swift SDK를 추가할 수 있습니다.

팁

Atlas Device SDK 및 Realm

SDK는 기기 데이터 지속성을 위해 Realm Core 데이터베이스를 사용합니다. Node.js SDK를 설치하면 패키지 이름에 Realm 이름이 반영됩니다.

SDK 가져오기

팁

Atlas Device SDK 및 Realm

SDK는 기기 데이터 지속성을 위해 Realm Core 데이터베이스를 사용합니다. Swift SDK를 임포트할 때 패키지 이름은 Realm 이름을 반영합니다.

SDK를 사용하려면 소스 파일 상단에 다음 줄을 추가하세요.

앱 다운로드 파일 크기

SDK는 앱 다운로드 크기에 약 5~8 MB만 추가해야 합니다. 당사가 배포하는 릴리스는 iOS, watchOS 및 tvOS 시뮬레이터, 일부 디버그 기호 및 비트코드에 대한 지원을 포함하기 때문에 훨씬 더 크며, 이 모든 것은 앱이 다운로드될 때 App Store에서 자동으로 제거됩니다.

문제 해결

이러한 방법 중 하나를 사용하여 SDK를 설치한 후 빌드 문제가 발생하는 경우 문제 해결 가이드라인에서 해당 문제를 해결하는 방법에 대한 정보를 확인하세요.

OS 지원

중요

tvOS와 함께 SDK를 사용할 때는 특별히 고려해야 할 사항이 있습니다. 자세한 내용은 tvOS용 빌드를 참조하세요.

Xcode 14

지원되는 OS	Realm	Atlas App Services
iOS 11.0+	X	X
macOS 10.13+	X	X
tvOS 11.0+	X	X
watchOS 4.0+	X

Xcode 15

버전 10.40.1의 새로운 기능

지원되는 OS	Realm	Atlas App Services
iOS 12.0+	X	X
macOS 10.13+	X	X
tvOS 11.0+	X	X
watchOS 4.0+	X
visionOS 1.0+	X	X

스위프트 동시성 지원

Swift SDK는 Swift의 동시성 관련 언어 기능을 지원합니다. Swift SDK의 동시성 기능 사용에 대한 모범 사례는 아래 문서를 참조하세요.

비동기/대기 지원

Realm Swift SDK 버전 10.15.0 및 10.16.0부터 많은 Realm API가 Swift async/await 구문을 지원합니다. 프로젝트는 다음 요구 사항을 충족해야 합니다.

Swift SDK 버전	Swift 버전 요구 사항	지원되는 OS
10.25.0	Swift 5.6	iOS 13.x
10.15.0 또는 10.16.0	Swift 5.5	iOS 15.x

앱이 async/await 컨텍스트에서 Realm에 액세스하는 경우 코드를 @MainActor(으)로 표시하여 스레드 관련 충돌을 방지합니다.

Swift SDK의 비동기/대기 지원에 대한 자세한 내용은 Swift 동시성: 비동기/대기 API를 참조하세요.

행위자 지원

Swift SDK는 행위자 격리 영역 인스턴스를 지원합니다. 자세한 내용은 행위자와 함께 Realm 사용 - Swift SDK를 참조하세요.

Apple 개인정보 취급방침

Spring 2024 부터 Apple은 RealmSwift 새 앱이나 앱 업데이트를 App Store에 제출할 때 SDK의 데이터 수집 및 사용 관행에 대한 세부 정보를 제공하기 위해 를 사용하는 앱을 요구합니다. Apple의 요구 사항에 대한 자세한 내용은 예정된 타사 SDK 요구 사항 을 참조하세요. Apple 개발자 웹사이트에서 확인할 수 있습니다.

Swift SDK 버전 10 부터 시작됩니다.46.0 부터 SDK는 Realm 및 RealmSwift 에 대한 개인정보 취급방침과 함께 제공됩니다. 각 패키지에는 Apple의 필수 API 공개와 해당 API를 사용하는 이유가 포함된 자체 개인정보 보호 매니페스트가 포함되어 있습니다.

각 패키지 또는 realm-swift GitHub 리포지토리에서 개인정보처리방침을 볼 수 있습니다.

Swift SDK는 App Store용 빌드에 분석 코드를 포함하지 않습니다. SDK는 자체적으로 Atlas에 로그인하지 않습니다.

앱 클라이언트 초기화 등 앱 서비스 기능을 사용하는 앱을 작성하는 경우

이러한 API를 사용할 때 앱의 개인정보 처리방침에 데이터 수집 및 사용 관행을 자세히 설명하는 추가 공개가 필요할 수도 있습니다.

자세한 내용은 Apple의 개인정보처리방침 파일 문서를 참조하세요.

← Swift용 Atlas Device SDK

퀵 스타트 - Swift SDK →