Android Studio가 필요합니다. 이 문서는 2.2 버전을 기반으로 설명합니다.

필요사항

시작하기 전에 Mac이나 Linux에서 Realm 오브젝트 서버를 실행해야 합니다.

만약 데모 앱을 macOS 번들에서 다운받지 않았다면, 다음 링크에서 다운받으세요. macOS 번들 다운로드

RealmTasks 열기

Android Studio를 열고 Open an existing Android Studio Project를 선택하세요.

Android Studio

번들의 압축을 푼 폴더로 가서 /realm-mobile-platform/demo/RealmTasks/RealmTasks Android를 엽니다.

Open RealmTasks in Android Studio

RealmTasks 빌드 및 실행

RealmTasks를 빌드하기 전에 애플리케이션을 정확한 IP 주소로 Realm 오브젝트 서버에 연결하도록 설정했는지 확인하세요.

RealmTasksApplication.java 파일 내의 빌드 설정 단계에서는 로컬 IP 주소를 기본값으로 사용합니다.

public class RealmTasksApplication extends Application {

    public static final String AUTH_URL = "http://" + BuildConfig.OBJECT_SERVER_IP + ":9080/auth";
    public static final String REALM_URL = "realm://" + BuildConfig.OBJECT_SERVER_IP + ":9080/~/realmtasks";

    ...
}

로컬에서 실행되는 Realm 오브젝트 서버가 있는 경우 그대로 빌드하고 실행하면 됩니다.

그러나 Realm 오브젝트 서버를 리눅스나 다른 컴퓨터에 설치한 경우, 기본 IP 주소를 실제 서버 주소에 맞게 수정해야 합니다.

정확한 IP 주소를 넣었다면 파일 메뉴에서 Run을 누르고, Run 'app'을 눌러서 안드로이드 에뮬레이터나 기기에서 빌드 및 실행을 합니다.

앱 사용

처음 실행한 경우라면 우상단의 Register를 누르고 사용자 이름과 비밀번호를 등록해야 합니다. 사용자 이름과 비밀번호를 입력한 후 Register를 눌러서 계속 진행하세요.

이제 애플리케이션의 기본 태스크 목록을 볼 수 있습니다.

새로운 태스크 목록 항목이 나타날 때까지 아래로 천천히 드래그하면 새 태스크를 입력할 수 있습니다. 새 항목을 만들면 즉시 Realm 오브젝트 서버에 의해 동기화되고 다른 디바이스나 macOS, iOS 버전의 앱에서 역시 나타납니다.

RealmTasks for Android

아이템을 왼쪽이나 오른쪽으로 스와이프하면 아이템이 삭제되거나 “done”으로 표시됩니다. 여기서도 마찬가지로 이런 변경 사항은 즉시 다른 버전의 애플리케이션에 반영됩니다.

Realm 브라우저로 Realm의 변경사항 관찰

The Realm Browser showing synced data

Mac을 사용하는 경우 Realm 브라우저를 통해 동기화된 Realm 데이터를 실시간으로 관찰하고 편집할 수 있습니다.

“realm-mobile-platform” 안의 “Realm Browser” macOS 앱을 엽니다.

앱이 열리면 초기 옵션을 설정하는 패널이 보입니다. “Connect to Object Server”를 클릭하세요.

Using the Realm Browser to connect to the Realm Object Server

“Connect to Object Server” 대화 상자에서 서버 URL로 realm://127.0.0.1:9080을 입력합니다.

관리자로 접속하기 위해서는 관리자 액세스 토큰이 필요합니다. 서버를 실행하는 터미널에서 Your admin access token is:로 시작하는 줄을 찾은 후 두 개의 등호(==)를 포함하는 긴 토큰 키 문자열을 복사하세요. 이것이 오브젝트 서버에 대한 관리자 액세스 토큰입니다.

만약 Linux에서 Realm 오브젝트 서버를 실행한다면, 관리자 토큰은 자동으로 생성되며 아래 명령어로 볼 수 있습니다.

cat /etc/realm/admin_token.base64

이제 서버의 모든 Reaml 목록을 보여주는 새 대화 상자가 열릴 겁니다. 유일한 등록 사용자라면 하나의 Realm만 존재합니다. 내용을 보려면 선택하세요.

RealmTasks 앱을 열어둔 상태에서 변경 사항을 브라우저에서 실시간으로 보면서 작업을 편집하고 순서를 변경해 볼 수 있습니다. 브라우저의 변경 사항은 앱에 즉시 반영됩니다.

다음 단계는?

공식 문서를 통해 Realm 플랫폼에 대해 더 알아보세요.