macOS 번들 설치하기

macOS를 위한 Realm 오브젝트 서버는 미리 만들어진 데모 애플리케이션인 RealmTasks와 함께 제공됩니다. (프로덕션 환경에서 자체 호스팅 Linux나 클라우드 배포를 사용할 수도 있지만, macOS 번들을 사용해서 Realm 모바일 플랫폼의 기능을 빠르게 경험해보시는 것을 추천합니다.)

macOS 번들 다운로드

Realm 오브젝트 서버, Cocoa SDK, 데모 앱

Realm 오브젝트 서버 시작

다운로드 폴더로 가서 “realm-mobile-platform” 폴더를 엽니다.

start-object-server.command 파일을 더블클릭해서 Realm 오브젝트 서버를 시작합니다. 터미널 창이 열리고 Realm 오브젝트 서버가 시작됩니다.

Registering the Realm Browser

서버를 시작하면 자동으로 Realm 대시보드가 열립니다. (만약 열리지 않는다면 http://localhost:9080으로 이동하세요).

이메일과 비밀번호를 입력해서 관리자를 생성합니다. 등록한 이후 이 정보로 로그인할 수 있습니다.

Realm 대시보드는 Realm 오브젝트 서버와 현재 활동 상태를 보여주며 사용자 관리도 할 수 있습니다.

RealmTasks 실행

The macOS version of RealmTasks

RealmTasks는 Realm 모바일 플랫폼에서 제공하는 간단한 태스크 매니저 앱으로 Realmac Software의 Clear에서 영감을 받았습니다. iOS, macOS, Android에서 사용할 수 있으며, 전체 소스 코드는 GitHub에서 볼 수 있습니다.

“realm-mobile-platform” 안의 “Demo” 폴더를 연 후 “RealmTasks” 폴더를 엽니다. 폴더 내부의 RealmTasks를 실행합니다. macOS에서 실행할 수 있습니다.

앱이 실행되면 기존 사용자로 로그인하거나 새 사용자를 등록할 수 있습니다. 앱을 처용 사용하는 분은 “Register”를 누르고 사용자 이름과 비밀번호를 입력하세요. (로컬 데모이므로 아무 것이나 입력해도 됩니다.)

로그인했다면 앱을 사용할 준비가 끝났습니다!

테스트 방법

  1. ”+” 버튼을 누르고 태스크를 추가합니다.
  2. 태스크를 삭제하려면 왼쪽으로 스와이프합니다.
  3. 태스크를 “done”으로 표시하려면 오른쪽으로 스와이프합니다.
  4. 태스크의 순서를 바꾸려면 탭해서 원하는 위치로 드래그합니다.

이들 태스크는 오브젝트 서버와 자동으로 동기화되는 동안 자동으로 앱 내부의 로컬 Realm에 추가됩니다.

이전에 RealmTasks를 실행한 적이 있다면 상태를 재설정해야 합니다. 앱을 닫고 아래 명령어를 입력하세요.

rm -rf ~/Library/Containers/io.realm.realmtasks.macos

Realm 브라우저

The Realm Browser showing synced data

서버에서 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:로 시작하는 줄을 찾은 후 두 개의 등호(==)를 포함하는 긴 토큰 키 문자열을 복사하세요. 이것이 오브젝트 서버에 대한 관리자 액세스 토큰입니다.

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

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

다음 단계는?

이제부터는 RealmTasks와 유사한 iOS 앱 만들기 튜토리얼을 통해 처음부터 앱을 만들거나, Realm 오브젝트 서버 문서를 참고해서 이미 Realm 모바일 데이터베이스를 사용하고 있는 앱을 통합할 수 있습니다.

기존에 Realm을 사용해왔다면, 플랫폼을 고르고 문서를 확인할 수도 있습니다. 이 문서에서는 라이브 오브젝트나 자동 업데이트되는 쿼리, ORM으로부터의 해방 등 Realm 데이터베이스의 특장점을 확인할 수 있습니다.