[React Native] Window에서 Android 환경 설정 시작하기

Android Studio를 사용하여 프로젝트를 실행할 수 있도록 환경을 설정하는 방법을 배웁니다. Android 에뮬레이터로 개발하고, 로컬에서 앱을 빌드하는 등의 작업을 할 수 있습니다.

환경 설정이 필요한 이유

프레임워크를 사용하는 경우 환경 설정이 필요하지 않습니다. android studio 또는 xcode를 설정할 필요가 없습니다. 프레임워크가 기본 앱 구축을 처리해주기 때문입니다. 프레임워크를 사용하지 못하게 하는 제약조건이 있거나 자체 프레임워크를 작성하려는 경우 로컬 환경을 설정하는 것이 필요합니다.

의존성 설치

Node, React Native CLI, JDK, Android Studio가 필요합니다. 앱 개발에는 원하는 편집기를 사용할 수 있지만, Android용 React Native 앱을 빌드하기 위한 도구 설정을 위해 Android Studio를 설치해야 합니다.

Node, JDK

Node를 설치하는 방법으로는 Windows에서 인기 있는 패키지 관리자 Chocolatey를 사용하는 것이 좋습니다. Node의 LTS 버전을 사용하는 것이 좋습니다. 다양한 버전 간에 전환할 수 있도록 nvm-windows라는 Windows용 node 버전 관리자를 통해 Node를 설치할 수 있습니다. react native는 또한 Java SE 개발 키트(JDK)가 필요합니다. 이것 역시 Chocolatey를 통해 설치할 수 있습니다.

관리자 권한으로 명령 프롬프트를 열고 다음 명령을 실행하세요

choco install -y nodejs-lts microsoft-openjdk17

이미 시스템에 Node가 설치되어 있다면 Node 18 이상의 버전인지 확인하세요 이미 시스템에 JDK가 설치되어 있다면 JDK17을 사용하는 것이 좋습니다. 높은 버전의 JDK를 사용할 경우 문제가 발생할 수 있습니다.

최신 버전의 JDK를 사용하는 경우 프로젝트의 Gradle 버전을 변경하여 JDK를 인식할 수 있도록 해야합니다. 이를 위해 project\android\gradle\wrapper\gradle-wrapper.properties로 이동하여 distributionUrl 값을 변경하여 Gradle 버전을 업그레이드할 수 있습니다.

Android 개발 환경

Android 개발에 익숙하지 않은 경우 개발 환경을 설정하는 것이 다소 번거로울 수 있습니다. 이미 Android 개발에 익숙한 경우 몇 가지 설정이 필요할 수 있습니다.

1. Android Studio 설치

Android Studio를 다운로드하고 설치하세요. Android Studio 설치 마법사에서 다음 항목 옆의 상자가 모두 선택되어 있는지 확인하세요

• Android SDK
• Android SDK Platform
• Android Virtual Device
• Hyper-V를 사용하지 않는 경우

그런 다음 Next를 클릭하여 이 모든 구성 요소를 설치하세요

2. Android SDK 설치

Android Studio는 기본적으로 최신 Android SDK를 설치합니다. 그러나 네이티브 코드로 react native 앱을 빌드하려면 android 14 SDK가 필요합니다. 추가 Android SDK는 Android studio의 SDK Manager를 통해 설치할 수 있습니다.

SDK Manager 내의 SDK Platforms 탭을 선택한 다음 오른쪽 하단의 Show Package Details 옆의 상자를 선택하세요 Android 14 항목을 찾아 확장한 다음 항목이 선택되어 있는지 확인하세요

• Android SDK Platform 34
• Intel x86 Atom_64 System Image 또는 Google APIs Intel x86 Atom System Image

그런 다음 SDK Tools탭을 선택하고 여기서도 Show Package Details 옆의 상자를 선택하세요 Android SDK Build-Tools 항목을 찾아 확장한 다음 34.0.0이 선택되어 있는지 확인하세요

마지막으로 Apply를 클릭하여 Android SDK와 관련 빌드 도구를 다운로드하고 설치하세요

3.ANDROID_HOME 환경 변수 구성

react native 도구는 네이티브 코드로 앱을 빌드하기 위해 일부 환경 변수를 설정해야 합니다.

window 환경 변수에서 새 ANDROID_HOME 사용자 변수를 만들어 Android SDK 경로를 가리키도록 합니다. 기본적으로 SDK는 다음 위치에 설치됩니다.

%LOCALAPPDATA%\Android\Sdk

안드로이드 스튜디오 settings 대화 상자의 Languages & Frameworks에서 Android SDK에서 SDK의 실제 위치를 찾을 수 있습니다.

새로운 명령 프롬프트 창을 열어 새 환경 변수가 로드되었는지 확인합니다.

4.platform-tools를 Path에 추가

window 환경변수에서 Path를 선택한 후 편집에 들어가서 새로 만들기를 클릭하고 platform-tools 경로를 목록에 추가합니다. 기본 위치는 다음과 같습니다.

%LOCALAPPDATA%\Android\Sdk\platform-tools

안드로이드 장치 준비

react native android 앱을 실행하려면 android 장치가 필요합니다. 이는 실제 장치일 수도 있고 가상 장치인 AVD를 사용할 수 있습니다.

실제 장치 사용

실제 장치에 USB 케이블을 사용하여 컴퓨터에 연결하고 사용 가능합니다.

가상 장치 사용

Android Studio를 사용하여 .\AwesomeProject\android를 열면 Android Studio 내에서 AVD Manager를 열어 사용 가능한 AVD 목록을 볼 수 있습니다. create virtual device를 선택한 다음 목록에서 임의의 전화를 선택하고 next를 클릭한 다음 api 34 이미지를 선택하세요 HAXM이 설치되지 않은 경우 install HAXM을 클릭하고 AVD를 만듭니다.