RTT4U 설치 방법
Real Time Testing for Unity(이하 RTT4U)를 사용하려면 아래와 같이 준비해야 합니다.
1. 개발 환경 구성
RTT4U를 사용하려면 아래 개발 환경을 구성해야 합니다.
- Windows 10 또는 macOS 14.3 이상
- Unity Editor 2021 이상 (macOS: Apple Silicon Unity Editors)
- Android SDK Command-line Tools 6.0
- Android Target SDK 33
- OpenJDK 11.0.18
- Hive SDK v4 Unity 24.3.0 이상
RTT4U는 현재 Android만 이용 가능합니다. 따라서 File > Build Settings에서 Android 타겟으로 플랫폼을 변경 후 사용하세요.
2. RTT4U 다운로드와 불러오기
RTT4U를 다운로드한 후 Unity 프로젝트로 불러옵니다.
3. Unity Android Build Support 설치
Unity 설치 시 Android Build Support 구성 요소를 모두 체크하고 설치합니다.
4. Android Studio 설치 및 명령줄 도구 설치 (Windows)
Windows 개발 환경에서는 Unity 설치 시 생성된 Android SDK 폴더 내에서 관리자 권한 문제로 시스템 이미지를 생성할 수 없습니다. 따라서, 아래 안내를 따라 Android Studio를 설치하고 명령줄 도구를 설치합니다.
Android Studio 설치
Android Studio를 다운로드합니다. Android SDK 설치 경로는 \Users\사용자 계정\AppData\Local\Android\sdk입니다.
Android 명령줄 도구 설치
Android Studio 설치 후 빈 프로젝트를 생성합니다. Android Studio 프로젝트 화면에서 SDK Manager를 누른 후, SDK Tools > Android SDK Command-line Tools (latest)에서 Android SDK Command-line Tools 6.0을 설치합니다.
5. 환경 변수 확인
Java 환경 변수가 설정되어 있는지 확인합니다. 터미널에서 java -version을 입력하여 Java 버전이 출력되면 올바르게 설정된 것입니다.
6. Android SDK Path 입력
Android SDK Path에 Android SDK가 설치된 경로를 입력합니다.
7. Android 시스템 이미지 설치
Unity 실행 후 상단 메뉴에서 Hive > RTT4U > RTT Player Settings를 클릭합니다.
RTT Player Settings 팝업에서 Download Android System-Image를 눌러 에뮬레이터 시스템 이미지를 설치합니다.
시스템 이미지는 개발 환경에 따라 아래 경로에 설치됩니다. 정확한 경로에 설치되어야만 RTT4U가 정상 동작하므로 설치 결과를 확인해야 합니다.
- Windows: Android SDK 경로/system-images/android-XX/google_apis_playstore/x86_64
- MacOS: Android SDK 경로/system-images/android-XX/google_apis_playstore/arm64-v8a
8. RTT Player 생성
에뮬레이터 시스템 이미지를 설치했다면 Create RTT Player를 눌러 RTT Player를 생성합니다. RTT Player는 Hive SDK 기능을 테스트하기 위한 에뮬레이터입니다.
9. Start Scene 입력
Start Scene에 앱을 시작하는 Scene을 입력합니다. 앱을 시작하는 Scene이란 Hive SDK Unity Plugin 초기화(HIVEUnityPlugin.InitPlugin)가 실행되는 Scene입니다. 입력 후 Save settings를 눌러 설정을 저장합니다.
10. RTT Player 실행 테스트
RTT Player를 생성한 후 Run the RTT Player를 눌러 에뮬레이터가 잘 동작하는지 확인합니다.
RTT Player 안내
RTT Player 설정과 버튼 동작을 안내합니다.
설정
설정 후에는 Save settings를 눌러 설정을 저장해야 합니다.
- Print RTTLogger.Log to Console: Unity Console에 RTT Player 로그를 출력
- RTT Player Quick Boot: 가능한 경우 RTT Player를 빠르게 부팅 (단, RTT Player 종료 시 상태를 저장하지 않음)
- Android SDK Path: Android SDK가 설치된 경로를 입력
- Start Scene: Hive SDK Unity Plugin 초기화(
HIVEUnityPlugin.InitPlugin)가 실행되는 Scene을 입력
버튼
- Download Android System-Image: RTT Player를 생성하기 위한 Android 시스템 이미지를 다운로드
- Create RTT Player: RTT Player를 생성
- Run the RTT Player: RTT Player를 실행
- Quit the RTT Player: RTT Player를 종료
- Process Kill: RTT Player가 정상 종료되지 않을 경우 프로세스를 강제 종료
- Save settings: 현재 설정된 정보를 파일로 저장