Swift용 Atlas Device SDK

Atlas Device SDK는 더 이상 사용되지 않습니다. 자세한 내용은 지원 중단 페이지 를 참조하세요.

Swift용 Atlas Device SDK를 사용하여 Swift 및 오브젝티브-C로 iOS, macOS, watchOS 및 tvOS 앱을 개발할 수 있습니다.

학습 경로

Swift SDK 시작하기

빠른 시작

Swift SDK로 작업하는 방법에 대한 최소한의 설명이 포함된 코드 예시입니다.기기 데이터베이스에 쓰고 다른 기기와 동기화합니다.

코드 예시 보기

작동 예시 앱

예시를 통해 Swift SDK를 사용해 실제 작동하는 SwiftUI 클라이언트 앱을 분석하여 알아보세요.

예시 앱 살펴보기

가이드 튜토리얼

안내된 튜토리얼을 따라 예시 앱을 조정하여 실제로 작동하는 나만의 앱을 만드는 방법을 알아보세요.

튜토리얼 따라하기

가능한 작업들

SDK로 앱 개발

SDK의 오픈 소스 데이터베이스인 Realm을 기기의 객체 저장소로 사용합니다.Device Sync를 사용하여 MongoDB Atlas 클러스터 및 다른 클라이언트와 데이터를 동기화할 수 있습니다.

Swift SDK 설치

Swift Package Manager, CocoaPods 또는 Carthage를 사용하여 프로젝트에 iOS, macOS, tvOS 및 watchOS용 SDK를 설치합니다.

시작하려면 프로젝트 파일에서 RealmSwift 를 가져옵니다.

객체 스키마 정의

Swift를 사용하여 객체 스키마를 관용적으로 정의합니다.

데이터베이스 열기

SDK의 데이터베이스인 Realm은 기기의 파일에 객체를 저장합니다. 또는 파일을 생성하지 않는 메모리 내 데이터베이스를 열 수도 있습니다. 데이터베이스를 구성하고 열어 데이터베이스 파일에 대한 옵션을 지정합니다.

데이터 읽기 및 쓰기

기기 데이터베이스에서 객체를 생성, 읽기, 업데이트, 삭제합니다. SDK의 형식 안정 .where 구문을 사용하여 데이터를 필터링하거나 NSPredicate를 구성합니다.

변경 사항에 대한 반응

라이브 객체는 데이터가 항상 최신 상태임을 의미합니다. 알림 핸들러를 등록하여 변경 사항을 관찰하고 UI 업데이트와 같은 일부 로직을 수행할 수 있습니다. 또는 SwiftUI에서 Swift 속성 래퍼(wrapper)를 사용하여 데이터가 변경될 때 보기를 업데이트합니다.

Atlas App Services 앱에 연결하기

App Services App에서 Device Sync를 구성합니다. 데이터 액세스 규칙을 정의합니다. 개발 모드를 사용하여 Swift 또는 Objective-C 데이터 모델에서 스키마를 추론합니다.

그런 다음 클라이언트 에서 백엔드 에 연결합니다 .

사용자 인증

인증 제공자 중 하나를 사용 하여 사용자를 인증합니다. App Services 는 Apple, Google 또는 Facebook 과 같은 널리 사용되는 인증 제공자에 대한 액세스 를 제공합니다. 내장 이메일/비밀번호 제공자 를 사용하여 타사 없이 사용자를 관리 하거나 사용자 지정 JSON web token 인증 을 사용하여 다른 인증 제공자와 통합할 수 있습니다. 익명 인증 은 로그인이나 사용자 데이터 지속 없이 액세스 있는 기능을 제공합니다.

동기화된 데이터베이스 열기

동기화된 데이터베이스 를 구성하고 엽니다. 쿼리 를 구독하여 동기화된 데이터베이스 에서 읽고 쓰기 (write) 수 있는 데이터를 확인합니다.

동기화된 데이터 읽기 및 쓰기

데이터를 읽고 쓰기 (write) API는 동기화된 데이터베이스를 사용하든 동기화되지 않은 데이터베이스 를 사용하든 동일합니다. 기기에 읽고 쓰기 (write) 데이터는 Atlas cluster 및 다른 클라이언트와 자동으로 동기화 됩니다. 앱은 오프라인에서 계속 작동하며 네트워크 연결이 가능할 때마다 변경 사항을 결정적으로 동기화 합니다.

Swift SDK는 SwiftUI로 더 쉽게 작업할 수 있도록 설계된 속성 래퍼 및 편의 기능을 제공합니다. 예를 들어 일반적인 SwiftUI 패턴을 보여주는 코드 보기는 SwiftUI 문서를 확인하세요.

SwiftUI 속성 래퍼가 제공하는 Realm/ SwiftUI 통합

struct SearchableDogsView: View {
    @ObservedResults(Dog.self) var dogs
    @State private var searchFilter = ""
    
    var body: some View {
        NavigationView {
            // The list shows the dogs in the realm.
            List {
                ForEach(dogs) { dog in
                    DogRow(dog: dog)
                }
            }
            .searchable(text: $searchFilter,
                        collection: $dogs,
                        keyPath: \.name) {
                ForEach(dogs) { dogsFiltered in
                    Text(dogsFiltered.name).searchCompletion(dogsFiltered.name)
                }
            }
        }
    }
}