안드로이드 스튜디오 설치 가이드

React Native 개발의 시작, 안드로이드 스튜디오 환경을 완벽하게 세팅하고 싶다면 이 글을 주목하세요.

안드로이드 스튜디오는 React Native 개발 시 안드로이드 에뮬레이터(AVD) 관리와 빌드, 디버깅을 위한 핵심 도구입니다. 이 가이드에서는 기본적인 설치부터 AVD 최적화, 그리고 효율적인 디버깅 설정까지, 권퓨터만의 노하우를 담아 상세히 알려드립니다.

목차

01React Native 개발을 위한 안드로이드 스튜디오 설치

02안드로이드 SDK와 환경 변수 설정

03AVD (Android Virtual Device) 생성 및 최적화

04React Native 프로젝트에서 AVD 실행 및 연결

05효율적인 디버깅 환경 설정과 팁

06자주 발생하는 문제와 해결 방안

React Native 개발을 위한 안드로이드 스튜디오 설치

React Native 앱을 안드로이드 기기나 에뮬레이터에서 실행하고 디버깅하려면 안드로이드 스튜디오 설치가 필수적입니다. 안드로이드 스튜디오는 단순히 IDE를 넘어, 필요한 SDK 컴포넌트와 빌드 도구를 통합 관리하는 허브 역할을 합니다. 2026년 현재 최신 버전의 안드로이드 스튜디오를 설치하는 것이 개발 생산성 측면에서 가장 유리합니다.

가장 먼저 안드로이드 스튜디오 공식 웹사이트에서 최신 버전을 다운로드하세요.

설치 전 시스템 요구 사항 확인

원활한 개발 환경을 위해 시스템 요구 사항을 사전에 확인하는 것이 중요합니다. 특히 React Native 개발 시에는 여러 개발 도구가 동시에 실행되므로, 충분한 RAM과 디스크 공간이 필요합니다.

권장 사양은 다음과 같습니다:

• 운영체제: Windows 10 (64비트), macOS 11 이상, Linux (64비트)
• RAM: 8GB 이상 (16GB 권장)
• 디스크 공간: 8GB 이상 (SSD 권장, 넉넉하게 20GB 이상 확보)
• CPU: Intel Core i5 8세대 이상 또는 AMD Ryzen 5 2세대 이상 (AVD 가상화 지원 필수)

특히 AVD를 원활하게 구동하려면 CPU의 가상화 기술(Intel VT-x, AMD-V)이 활성화되어 있어야 합니다. BIOS/UEFI 설정에서 이 옵션을 확인하고 활성화해주세요.

안드로이드 스튜디오 설치 과정

다운로드한 설치 파일을 실행하면 설치 마법사가 나타납니다. 다음 단계를 따라 진행하세요.

1. 설치 시작: 다운로드한 .exe (Windows), .dmg (macOS) 또는 .zip (Linux) 파일을 실행합니다.
2. 컴포넌트 선택: 설치 유형을 묻는 화면에서 ‘Standard’를 선택하는 것이 일반적입니다. ‘Android Virtual Device’ 옵션은 반드시 선택되어 있어야 합니다. 이 옵션이 선택되어야 나중에 에뮬레이터를 사용할 수 있습니다.
3. 설치 경로: 기본 설치 경로를 유지하는 것을 권장합니다. 사용자 지정 경로를 선택할 경우, 경로에 공백이나 특수 문자가 포함되지 않도록 주의하세요. 이는 나중에 환경 변수 설정 시 문제를 일으킬 수 있습니다.
4. SDK 다운로드: 설치가 완료되면 안드로이드 스튜디오가 실행되고, 필요한 SDK 컴포넌트를 다운로드하기 시작합니다. 이때 안정적인 인터넷 연결이 필요하며, 다운로드 시간은 네트워크 환경에 따라 달라질 수 있습니다.
5. 설치 완료: 모든 컴포넌트 다운로드 및 설치가 완료되면, 안드로이드 스튜디오의 시작 화면을 볼 수 있습니다.

설치 중 오류가 발생하면, 대부분 방화벽 또는 네트워크 문제이거나, 이전에 설치된 자바 개발 키트(JDK)와 충돌하는 경우입니다. JDK는 안드로이드 스튜디오에 내장된 것을 사용하는 것이 가장 안정적입니다.

안드로이드 SDK와 환경 변수 설정

안드로이드 스튜디오 설치 후에는 React Native가 안드로이드 SDK를 제대로 인식하도록 환경 변수를 설정해야 합니다. 이 과정은 React Native CLI가 안드로이드 빌드 도구를 찾아 앱을 빌드하고 실행하는 데 필수적입니다.

필수 SDK 컴포넌트 설치

안드로이드 스튜디오를 실행한 후, Tools > SDK Manager로 이동하여 필요한 SDK 컴포넌트들을 설치합니다.

• SDK Platforms: 최신 안드로이드 버전(예: Android 14.0 ‘Upside Down Cake’, API 34)과 함께, React Native가 권장하는 최소 버전(보통 API 30 이상)을 설치합니다.
• SDK Tools:
  • Android SDK Build-Tools (최신 버전)
  • Android SDK Platform-Tools (최신 버전)
  • Android Emulator (최신 버전)
  • Intel x86 Emulator Accelerator (HAXM installer) 또는 Android Emulator Hypervisor Driver for AMD Processors (최신 버전)
  • Google Play services

HAXM 또는 Hypervisor Driver는 에뮬레이터의 성능을 비약적으로 향상시키므로 반드시 설치해야 합니다. 설치 후에는 해당 드라이버가 시스템에 올바르게 설치되었는지 확인하는 것이 좋습니다.

ANDROID_HOME 환경 변수 설정

React Native CLI는 ANDROID_HOME 환경 변수를 사용하여 안드로이드 SDK의 위치를 찾습니다. 각 운영체제별 설정 방법은 다음과 같습니다.

Windows:

• ‘시스템’ 또는 ‘내 PC’ 우클릭 > ‘속성’ > ‘고급 시스템 설정’ > ‘환경 변수’.
• ‘시스템 변수’ 섹션에서 ‘새로 만들기’를 클릭합니다.
• 변수 이름: ANDROID_HOME
• 변수 값: %LOCALAPPDATA%\Android\Sdk (기본 경로) 또는 직접 설치한 SDK 경로.
• ‘Path’ 변수를 찾아 %ANDROID_HOME%\platform-tools를 추가합니다.

macOS/Linux:

터미널을 열고 다음 명령어를 실행하여 .bash_profile, .zshrc 또는 .profile 파일에 추가합니다.

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

변경 사항을 적용하려면 터미널을 다시 시작하거나 source ~/.bash_profile (또는 해당 쉘 설정 파일) 명령어를 실행해야 합니다.

AVD (Android Virtual Device) 생성 및 최적화

AVD는 실제 안드로이드 기기 없이도 앱을 테스트할 수 있게 해주는 가상 장치입니다. React Native 개발 시 빌드 속도와 테스트 효율성을 위해 AVD를 최적화하는 것이 매우 중요합니다.

새로운 AVD 생성 단계

안드로이드 스튜디오에서 Tools > Device Manager (또는 AVD Manager)로 이동하여 새로운 가상 장치를 생성합니다.

1. Create device: ‘Create device’ 버튼을 클릭합니다.
2. 하드웨어 프로필 선택: ‘Phone’ 카테고리에서 Pixel 6 또는 Pixel 7과 같이 최신 기종을 선택하는 것이 좋습니다. Google Play 스토어 아이콘이 있는 기종을 선택하면 테스트 시 유용합니다.
3. 시스템 이미지 선택: 권장되는 시스템 이미지는 최신 안드로이드 버전(예: API 34)의 x86-64 이미지입니다. Google APIs 또는 Google Play가 포함된 이미지를 선택하세요.
4. AVD 설정 검토: ‘AVD Name’을 설정하고, ‘Show Advanced Settings’를 클릭하여 추가 설정을 확인합니다.
5. Finish: 설정 검토 후 ‘Finish’를 클릭하면 AVD 생성이 완료됩니다.

AVD 이름은 나중에 여러 에뮬레이터를 관리할 때 혼동을 줄 수 있으므로, 프로젝트 또는 목적에 맞게 명확하게 지정하는 것이 좋습니다.

AVD 성능 최적화 팁

AVD 성능은 개발 속도에 직접적인 영향을 미칩니다. 다음 설정들을 통해 AVD를 최적화할 수 있습니다.

• RAM 설정: ‘Show Advanced Settings’에서 ‘Memory and Storage’ 섹션을 찾습니다. AVD의 RAM은 2048MB (2GB) 이상으로 설정하는 것이 좋습니다. 시스템 RAM이 충분하다면 4096MB (4GB)까지 설정하여 더욱 쾌적한 환경을 만들 수 있습니다.
• 그래픽 설정: ‘Graphics’ 옵션을 ‘Hardware – GLES 2.0’ 또는 ‘Hardware – GLES 3.1’로 설정하여 GPU 가속을 활용합니다. 이는 UI 렌더링 성능에 큰 영향을 줍니다.
• 내장 메모리: ‘Internal Storage’는 최소 8GB 이상으로 설정하여 앱 설치 및 캐시 공간을 충분히 확보합니다.
• HAXM/Hypervisor 활성화: 앞서 설치한 Intel HAXM 또는 AMD Hypervisor Driver가 제대로 작동하는지 확인합니다. 이는 가상화 성능의 핵심입니다.

AVD의 성능은 시스템 리소스를 얼마나 효율적으로 할당하느냐에 달려 있습니다.

React Native 프로젝트에서 AVD 실행 및 연결

AVD를 생성하고 최적화했다면, 이제 React Native 프로젝트에서 이 에뮬레이터를 실행하고 앱을 배포하는 방법을 알아볼 차례입니다. 이 과정은 React Native 개발의 핵심 루틴 중 하나입니다.

AVD 실행 방법

AVD는 안드로이드 스튜디오의 Device Manager에서 직접 실행하거나, 터미널 명령어를 통해 실행할 수 있습니다.

• 안드로이드 스튜디오에서 실행: Device Manager 목록에서 원하는 AVD 옆의 ‘Play’ 버튼을 클릭합니다.
• 터미널에서 실행:
  • 먼저, emulator -list-avds 명령어로 생성된 AVD 목록을 확인합니다.
  • 원하는 AVD 이름(예: Pixel_6_API_34)을 사용하여 emulator -avd [AVD_NAME] 명령어를 실행합니다.

터미널에서 실행하는 방법은 CI/CD 환경이나 자동화 스크립트에서 유용하게 사용될 수 있습니다.

React Native 앱 실행

AVD가 실행된 상태에서 React Native 프로젝트 폴더로 이동하여 다음 명령어를 실행합니다.

npx react-native run-android

이 명령어는 React Native 앱을 빌드하고, 현재 실행 중인 AVD에 앱을 설치한 후 실행합니다. 첫 빌드는 시간이 다소 걸릴 수 있지만, 이후에는 Fast Refresh 기능 덕분에 코드 변경 사항이 빠르게 반영됩니다.

만약 여러 AVD가 실행 중이거나 실제 기기가 연결되어 있다면, adb devices 명령어로 장치 목록을 확인하고, npx react-native run-android --deviceId <device_id> 명령어를 사용하여 특정 장치에 앱을 배포할 수 있습니다.

효율적인 디버깅 환경 설정과 팁

React Native 개발에서 효율적인 디버깅은 생산성을 크게 좌우합니다. 안드로이드 스튜디오와 React Native의 디버깅 도구를 활용하여 문제 해결 시간을 단축할 수 있습니다.

React Native Debugger 활용

React Native Debugger는 Chrome 개발자 도구와 React DevTools, Redux DevTools를 통합한 독립형 앱으로, React Native 앱 디버깅의 필수 도구입니다.

• 설치: GitHub 릴리즈 페이지에서 최신 버전을 다운로드하여 설치합니다.
• 사용법: 앱이 실행 중인 상태에서 AVD에서 Ctrl + M (Windows/Linux) 또는 Cmd + M (macOS)을 눌러 개발자 메뉴를 엽니다. ‘Debug Remote JS’를 선택하면 React Native Debugger에 연결됩니다.

React Native Debugger를 사용하면 컴포넌트 계층 구조, 상태, 네트워크 요청 등을 한눈에 확인할 수 있습니다.

안드로이드 스튜디오의 Logcat 활용

네이티브 모듈 관련 문제나 앱 크래시 발생 시, 안드로이드 스튜디오의 Logcat은 매우 유용한 디버깅 도구입니다. Logcat은 앱이 생성하는 모든 시스템 메시지, 오류, 로그를 실시간으로 보여줍니다.

• 접근: 안드로이드 스튜디오 하단의 ‘Logcat’ 탭을 클릭합니다.
• 필터링: 메시지가 너무 많을 경우, 검색창에 ReactNative, JS, Error 등의 키워드를 입력하여 관련 로그만 볼 수 있습니다.
• 수준 설정: 로그 수준(Verbose, Debug, Info, Warn, Error, Assert)을 조절하여 필요한 정보만 표시할 수 있습니다.

Logcat은 네이티브 코드의 예외나 AndroidManifest.xml 설정 오류와 같은 문제를 진단하는 데 특히 강력합니다.

자주 발생하는 문제와 해결 방안

React Native 개발 환경 설정 중에는 다양한 문제가 발생할 수 있습니다. 다음은 권퓨터가 자주 접하는 문제와 그 해결 방안입니다.

‘SDK location not found’ 오류

이 오류는 ANDROID_HOME 환경 변수가 제대로 설정되지 않았거나, SDK 경로가 잘못 지정되었을 때 발생합니다.

• 해결: ANDROID_HOME 환경 변수 경로가 안드로이드 스튜디오의 SDK Manager에 표시된 ‘Android SDK Location’과 일치하는지 확인하고 수정합니다. 환경 변수 변경 후에는 터미널을 다시 시작하거나 시스템을 재부팅해야 합니다.

AVD가 시작되지 않거나 느리게 실행됨

AVD 성능 문제는 주로 가상화 기술 미활성화, 시스템 리소스 부족, 또는 그래픽 설정 오류로 인해 발생합니다.

• 해결:
  • BIOS/UEFI에서 Intel VT-x 또는 AMD-V 가상화 기술이 활성화되어 있는지 확인합니다.
  • 안드로이드 스튜디오의 SDK Manager에서 Intel HAXM 또는 Android Emulator Hypervisor Driver for AMD Processors가 설치되었는지 확인하고, 설치되어 있지 않다면 설치합니다.
  • AVD 설정에서 RAM과 그래픽 옵션을 최적화합니다 (이전 섹션 참조).

‘Could not connect to development server’ 오류

이 오류는 React Native Metro Bundler가 제대로 실행되지 않았거나, AVD와 번들러 간의 네트워크 연결에 문제가 있을 때 발생합니다.

• 해결:
  • 새로운 터미널에서 npx react-native start 명령어를 실행하여 Metro Bundler를 수동으로 시작합니다.
  • AVD가 실행 중인 상태에서 Ctrl + M (또는 Cmd + M)을 눌러 개발자 메뉴를 열고 ‘Settings’ > ‘Debug server host & port for device’에서 PC의 IP 주소와 포트(기본값 8081)를 정확히 입력합니다.
  • 방화벽 설정에서 포트 8081에 대한 인바운드 연결을 허용합니다.

이제 React Native 개발을 위한 최적의 안드로이드 환경이 여러분을 기다립니다.

이 가이드를 통해 안드로이드 스튜디오와 AVD 설정을 완벽하게 마쳤기를 바랍니다. 안정적인 개발 환경은 즐거운 코딩 경험의 시작입니다. 권퓨터와 함께 더욱 효율적인 React Native 개발 여정을 만들어나가세요!