Docs Menu
Docs Home
/
MongoDB Atlas
/
Atlas Device SDK

Realm 설치하기 - Java SDK

이 페이지의 내용

  • 개요
  • 전제 조건
  • 설치
  • 프로젝트 Gradle 구성
  • 애플리케이션 모듈 Gradle 구성
  • Atlas Device Sync 활성화
  • 지원 플랫폼

참고

유지 관리 모드의 Java SDK

Java SDK는 최선형 유지 관리 모드이며 새로운 개발이나 중요하지 않은 버그 수정을 더 이상 받지 않습니다. 새 기능으로 앱을 개발하려면 코틀린 SDK(Kotlin SDK)를 사용하세요. 동일한 프로젝트에서 Java SDK를 코틀린 SDK(Kotlin SDK)와 함께 사용할 수 있습니다.

Java SDK에서 Kotlin SDK로 마이그레이션하는 방법 자세히 알아보세요.

참고

새 Java SDK 앱은 RealmAny를 사용할 수 없습니다.

새로운 App Services 앱 은 데이터 모델을 RealmAny 유형의 속성과 동기화할 수 없습니다.

개요

이 페이지에서는 Java SDK를 사용하여 프로젝트에 Realm을 설치하고 시작하는 방법을 자세히 설명합니다.

프로젝트에서 여러 SDK를 사용할 수 있습니다. Java SDK는 더 이상 새로운 개발을 받지 않으므로 앱의 새로운 기능을 사용하려는 경우에 유용합니다. 예를 들어, Kotlin SDK를 사용하여 Atlas Device Sync의 데이터 수집 기능을 앱에 추가하는 동시에 다른 모든 기능에는 Java를 계속 사용할 수 있습니다.

전제 조건

설치

Realm은 Gradle 빌드 시스템만 지원합니다. 이 단계에 따라 Realm Java SDK를 프로젝트에 추가하세요.

참고

ProGuard

Realm은 Realm 라이브러리의 일부로 ProGuard 구성을 제공합니다. 따라서 사용자는 ProGuard 구성에 Realm별 규칙을 추가할 필요가 없습니다.

프로젝트 Gradle 구성

애플리케이션에 로컬 전용 Realm을 추가하려면 프로젝트 레벨 Gradle 빌드 파일(대개 <project>/build.gradle에 있음)을 다음과 같이 변경하세요.

팁

Java SDK는 아직 Gradle 플러그인 구문을 지원하지 않습니다. 다행히도 여전히 이 구문을 사용하는 프로젝트에 SDK를 추가할 수 있습니다.

  • repositories 블록과 dependencies 블록을 포함하는 buildscript 블록을 추가합니다.

  • buildscript.repositories 블록에 mavenCentral() 리포지토리를 추가합니다.

  • buildscript.dependencies 블록에 io.realm:realm-gradle-plugin 종속성을 추가합니다.

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:10.18.0"
    }
}
plugins {
    id 'com.android.application' version '7.1.2' apply false
    id 'com.android.library' version '7.1.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.6.10' apply false
    id "org.jetbrains.kotlin.kapt" version "1.6.20" apply false
}
task clean(type: Delete) {
    delete rootProject.buildDir
}

  • buildscript.dependencies 블록에 io.realm:realm-gradle-plugin 종속성을 추가합니다.

  • allprojects.repositories 블록에 mavenCentral() 리포지토리를 추가합니다.

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:3.5.1"
        classpath "io.realm:realm-gradle-plugin:10.18.0"
    }
}
allprojects {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
    }
}
task clean(type: Delete) {
    delete rootProject.buildDir
}

애플리케이션 모듈 Gradle 구성

그런 다음 애플리케이션 레벨 Gradle 빌드 파일(대개 <project>/app/build.gradle에 있음)을 다음과 같이 변경하세요.

  • 애플리케이션이 Kotlin을 사용하는 경우 kotlin-kapt 플러그인을 적용합니다.

  • plugins 블록 아래에 realm-android 플러그인을 적용합니다.

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'org.jetbrains.kotlin.kapt'
}
apply plugin: "realm-android"
android {
    compileSdk 31
    defaultConfig {
        applicationId "com.mongodb.example-realm-application"
        minSdk 28
        targetSdk 31
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_11
        targetCompatibility JavaVersion.VERSION_11
    }
    kotlinOptions {
        jvmTarget = '11'
    }
}
dependencies {
    implementation 'io.realm:realm-gradle-plugin:10.10.1'
    implementation 'androidx.core:core-ktx:1.7.0'
    implementation 'androidx.appcompat:appcompat:1.4.1'
    implementation 'com.google.android.material:material:1.5.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

  • 애플리케이션이 Kotlin을 사용하는 경우 kotlin-kapt 플러그인을 적용합니다.

  • realm-android 플러그인 적용

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt'
apply plugin: 'realm-android'
android {
    compileSdkVersion 31
    buildToolsVersion "29.0.2"
    defaultConfig {
        applicationId "com.mongodb.example-realm-application"
        minSdkVersion 28
        targetSdkVersion 31
    }
    compileOptions {
        sourceCompatibility 1.11
        targetCompatibility 1.11
    }
    kotlinOptions {
        jvmTarget = '11'
    }
}
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation "androidx.appcompat:appcompat:1.1.0"
    implementation "androidx.core:core-ktx:1.2.0"
}

build.gradle 파일을 업데이트한 후 File > Sync Project with Gradle Files 를 클릭하여 종속성을 해결합니다.

Atlas Device Sync 활성화

애플리케이션에서 Atlas Device Sync를 사용하려면 애플리케이션 모듈 build.gradle에서 realm 블록을 생성하세요. 이 블록 내에서 syncEnabled을(를) true(으)로 설정하세요.

realm {
    syncEnabled = true
}

지원 플랫폼

Realm의 Java SDK를 사용하면 다음 플랫폼에 맞는 앱을 빌드할 수 있습니다.

  • Android

  • Wear OS

  • Android Automotive OS

  • Android TV

  • Android Things

다음

Atlas Device SDK Docs에 오신 것을 환영합니다