Flutter SDK 설치
Atlas Device SDK Flutter 프로젝트 또는 독립형 Dart 프로젝트에서 Flutter용 를 사용할 수 있습니다. 이 가이드에서는 두 유형의 프로젝트에 SDK를 설치하기 위한 지침을 제공합니다.
전제 조건
Flutter용 Atlas Device SDK를 시작하려면 개발 중인 앱 유형에 따라 다음을 설치해야 합니다.
Flutter 또는 Dart 앱의 경우 개발 환경에 Dart 와 함께 Flutter를 설치하세요. Flutter 설치에는 Dart 가 포함됩니다. 방법을 학습 보려면 공식 Flutter 설치 가이드를 참조하세요.
독립형 Dart 앱의 경우 Flutter 없이 개발 환경에 Dart 를 설치할 수 있습니다. 방법을 알아보려면 공식 설치 Dart 가이드를 참조하세요.
최신 버전의 Flutter SDK를 사용하려면 다음과 같은 최소 버전이 필요합니다.
Flutter 버전 3.19.0 이상.
Dart 버전 3.3.0 이상.
지원 플랫폼
Flutter SDK는 다음 플랫폼을 지원합니다.
iOS
Android
macOS
64비트 아키텍처에서 실행되는 Windows
64비트 아키텍처에서 실행되는 Linux
중요
지원되지 않는 플랫폼
Flutter SDK는 다음 플랫폼을 지원하지 않습니다 :
Web
ARM64 또는 32비트 아키텍처에서 실행되는 Windows
ARM64 또는 32비트 아키텍처에서 실행되는 Linux
SDK 설치하기
Flutter용 Atlas Device SDK 에는 Flutter 또는 Dart 독립형 앱을 개발하는지 여부에 따라 설치할 수 있는 두 가지 패키지가 있습니다.
realm: Flutter 애플리케이션에서 사용하기 위한 Flutter SDK 패키지입니다.realm_dart:Dart 앱과 같은 Dart CLI Dart 애플리케이션 또는 서버 환경에서 를 실행하기 위한 독립형 SDK 패키지입니다.
독립형 Dart 패키지는 별도로 명시된 경우를 제외하고 Flutter 패키지와 사용법이 동일합니다.
팁
Atlas Device SDK 및 Realm
Flutter SDK는 기기 데이터 지속성을 위해 Realm Core 데이터베이스를 사용합니다. Flutter SDK를 설치하면 패키지 이름에 Realm 이름이 반영됩니다.
프로젝트 생성
Flutter 프로젝트를 만들려면 다음 명령을 실행하세요.
flutter create <app_name> cd <app_name>
자세한 내용은 Flutter의 시작 가이드를 참조하세요.
Dart 프로젝트 를 생성하려면 다음 명령어를 실행 하세요.
dart create <app_name> cd <app_name>
자세한 내용은 Dart 의 시작하기 가이드 를 Dart 참조하세요. 독립형 명령줄 및 서버 애플리케이션용입니다.
프로젝트에 SDK 추가하기
프로젝트에 Flutter SDK를 추가하려면 다음 명령을 실행하세요.
flutter pub add realm
그러면 Realm 이 다운로드됩니다. 패키지를 만들고 프로젝트에 추가합니다.
pubspec.yaml 파일에서 다음을 확인할 수 있습니다.
dependencies: realm: <latest_version>
참고
macOS 앱에서 네트워킹 사용
macOS 앱 샌드박스에서 Flutter SDK를 사용하여 개발하고 있고 네트워크 액세스가 필요한 경우, 앱에서 네트워크 자격을 활성화해야 합니다. 기본적으로 내장된 macOS 보안 설정으로 인해 네트워크 요청은 허용되지 않습니다.
macOS 앱에서 네트워킹을 사용하려면 앱의 macOS 네트워크 권한을 변경해야 합니다. 방법을 알아보려면 macOS 앱 Sandbox와 함께 Realm 사용하기를 참조하세요.
프로젝트 에 SDK를 추가하려면 다음 명령을 실행 합니다.
dart pub add realm_dart
그러면 realm_dart 가 다운로드됩니다. 패키지 로 지정하여 프로젝트 에 추가합니다.
pubspec.yaml 파일에서 다음을 확인할 수 있습니다.
dependencies: realm_dart: <latest_version>
패키지 를 추가한 후 다음 명령을 실행 하여 패키지를 설치합니다.
dart run realm_dart install
이 작업은 필요한 네이티브 바이너리를 다운로드하여 앱 디렉토리에 복사합니다.
패키지 버전 업데이트
프로젝트에서 SDK 버전을 변경하려면 realm 또는 realm_dart 패키지를 사용하는지 여부에 따라 다음 단계를 수행합니다.
객체 모델 재생성
dart run realm generate
dart run realm_dart generate
중요
Flutter SDK v2.0.0 생성된 파일에 대한 단절적 변경
Flutter SDK 버전 2.0.0 파일 생성 방식에 영향을 미치는 빌더 업데이트를 도입합니다. v2.0.0 이상에서는 생성된 모든 파일이 .g.dart 대신 .realm.dart 명명 규칙을 사용합니다.
이는 기존 앱에 대한 호환성이 손상되는 변경 입니다. 기존 앱 을 이전 SDK 버전에서 v2.0.0 이상으로 업그레이드 하는 방법에 대한 자세한 내용은 Flutter SDK v2.0.0 로 업그레이드를 참조하세요.
문제 해결
애플리케이션에서 업데이트된 SDK 버전을 사용하는 데 문제가 있는 경우 SDK에서 생성된 .realm 데이터베이스 파일을 삭제하고 애플리케이션을 다시 시작할 수 있습니다. .realm 파일을 삭제하면 해당 클라이언트의 데이터베이스에 저장된 모든 데이터도 삭제됩니다.
Apple 개인정보 취급방침
버전 2.2.0에 추가 되었습니다.
Apple은 필수 이유 API 를 사용하는 모든 앱 또는 타사 SDK가 개인정보 취급방침을 제공하도록 요구합니다. 매니페스트에는 앱 또는 SDK의 데이터 수집 및 사용 관행에 대한 세부 정보가 포함되어 있으며, 새 앱이나 앱 업데이트를 Apple App Store에 제출할 때 포함해야 합니다. 이러한 요구 사항에 대한 자세한 내용은 예정된 타사 SDK 요구 사항 을 참조하세요. Apple 개발자 웹사이트에서 확인할 수 있습니다.
Flutter SDK 버전 2.2.0 부터 SDK는 iOS 및 macOS 환경에 대한 개인정보 취급방침과 함께 제공되며, realm 패키지에 포함되어 있습니다. 두 개인정보처리방침에는 Apple의 필수 API 공개와 해당 API를 사용하는 이유가 포함되어 있습니다.
이러한 개인정보보호 매니페스트는 SDK 패키지 또는 realm-dart Github 리포지토리에서 직접 볼 수 있습니다.
iOS: https://github.com/realm/realm-dart/blob/main/packages/realm/ios/Resources/PrivacyInfo.xcprivacymacOS: https://github.com/realm/realm-dart/lob/main/packages/realm/macos/Resources/PrivacyInfo.xcprivacy
Flutter SDK는 다음을 수행하지 않습니다.
App Store용 빌드에 분석 코드를 포함합니다.
Atlas에 자동으로 로그인합니다.
중요
Atlas App Services에 추가 공개가 필요할 수 있음
Flutter SDK 개인정보처리방침에는 Atlas App Services API에 대한 공개가 포함되어 있지 않습니다 .
앱에서 사용자 인증 또는 Device Sync와 같은 Atlas App Services 기능을 사용하는 경우 이러한 API를 사용할 때 데이터 수집 및 사용 관행을 자세히 설명하는 추가 공개를 제공해야 할 수 있습니다. 예를 들어 앱이 다음과 같이 앱 클라이언트를 초기화하는 경우입니다.
자세한 내용은 Apple의 개인정보처리방침 파일 을 참조하세요. 문서화.