리액트 네이티브 시작하기: 안드로이드 스튜디오에서 첫 실행 오류 해결 방법

안드로이드 스튜디오에서 새 리액트 네이티브 프로젝트를 만든 후, 처음 실행하면서 겪을 수 있는 오류 해결 방법을 소개합니다.

프로젝트를 생성하고 바로 실행했을 때, ‘Unable to load script. Make sure you’re either running Metro (run ‘npx react-native start’) or that your bundle ‘index.android.bundle’ is packaged correctly for release.‘라는 메시지가 나타나 당황스러울 수 있습니다. 이 메시지는 리액트 네이티브 프로젝트에서 자주 볼 수 있는 오류로, 앱을 디바이스나 에뮬레이터에서 실행할 때 필요한 자바스크립트 번들 파일이 제대로 로드되지 않았을 때 발생합니다. 해결하는 방법은 어렵지 않으니 아래의 순서대로 따라하시면 해결할 수 있습니다.

해결 방법

1. ‘assets’ 디렉토리 생성

• 프로젝트 디렉토리 내의 \android\app\src\main 경로로 이동하여 ‘assets’ 디렉토리가 없다면 생성해주세요.

2. 번들 파일 생성

• 프로젝트의 루트 디렉토리에서 아래 명령어를 실행합니다. 이 명령어는 필요한 번들 파일을 생성해 ‘assets’ 디렉토리 안에 저장합니다.

npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle

3. 앱 실행

• 모든 설정이 완료되었다면, 이제 안드로이드 스튜디오에서 앱을 다시 실행해보세요. 정상적으로 첫 화면이 표시될 것입니다.

추가 정보

• ‘assets’ 디렉토리 생성 및 번들 파일 생성 과정은 리액트 네이티브 앱이 안드로이드 디바이스에서 필요로 하는 자바스크립트 코드를 포함하고 있지 않을 때 필요합니다. 이 과정을 통해 앱이 필요로 하는 자바스크립트 번들을 수동으로 생성하고, 디바이스가 해당 파일을 인식할 수 있도록 합니다.

처음 리엑트 네이티브 프로젝트를 실행할 때 발생할 수 있는 오류를 간단하게 해결 할수 있는 방법에 대해서 알아 보았습니다.