인프런 커뮤니티 질문&답변

킴주니님 해당 수강생분 좋은 질문 해주셔서 감사합니다!!

이 문제는 Flutter 개발할 때 정말 흔하게 발생하는 현상이에요. 웹에서는 되는데 에뮬레이터에서만 기본 화면이 나오는 건, 보통 빌드가 제대로 반영이 안 됐을 때 생기는 현상입니다. 하루종일 씨름하셨다니 정말 답답하셨겠습니다 ㅠㅠㅜ

1. 가장 먼저 시도해볼 방법

터미널에서 아래 명령어를 순서대로 실행해보세요.

먼저 flutter clean으로 기존 빌드 파일을 다 지우고, flutter pub get으로 패키지를 다시 받은 다음, flutter run으로 새로 실행해보길 추천드립니다!!

flutter clean
flutter pub get
flutter run

2. 그래도 안 되면 Hot Restart 시도

Cursor에서 앱이 실행 중일 때 단축키 Shift+R을 터미널에서 눌러보세요. 일반 Hot Reload(r키)는 일부 변경사항만 반영하는데, Hot Restart는 앱을 완전히 재시작해서 모든 변경사항을 반영해줍니다.

3. 에뮬레이터에서 앱 삭제 후 재설치

에뮬레이터 안에서 앱 아이콘을 길게 눌러서 삭제한 다음, 다시 flutter run 해보세요. 이전에 설치된 앱이 캐시되어 있어서 새 코드가 반영 안 되는 경우가 있거든요.

4. 에뮬레이터 완전히 껐다 켜기

Android Studio에서 에뮬레이터를 완전히 종료하고(Device Manager에서 Stop 버튼), 다시 시작한 뒤 flutter run 해보세요. 가끔 에뮬레이터 자체가 이전 상태를 기억하고 있어서 새 빌드를 안 받아들이는 경우가 있습니다.

그래도 안 되면 에러 메시지나 터미널에 나오는 내용을 캡처해서 다시 올려주시면, 더 구체적으로 같이 확인해보시죠!! 언제든 편하게 질문해주세요!

안녕하세요, 인프런 AI 인턴입니다. 킴주니님.

Flutter에서 웹 브라우저(Chrome)로 실행할 때는 정상적으로 동작하지만, 에뮬레이터(미디움 폰 등)에서는 기본 Flutter 화면만 보이는 문제를 겪고 계시는군요. 이 문제는 종종 Flutter 앱 구성 요소와 관련된 설정 문제일 수 있습니다. 아래 해결 방법을 확인해 보세요.

해결 방법

1. 빌드 타겟 설정 확인:
   Flutter는 다양한 플랫폼(Android, iOS, Web 등)을 지원하기 때문에, 타겟 플랫폼에 따라 빌드 설정이 달라질 수 있습니다. Android 에뮬레이터에서 실행할 때는 flutter run 명령어를 통해 Android 타겟을 명시적으로 지정해 보세요.

2. 에뮬레이터 설정 확인:

   • Android Studio에서 에뮬레이터를 설정할 때 사용된 가상 디바이스가 올바르게 설정되었는지 확인하세요.
     
   • 최신의 Android SDK 및 관련 도구가 설치되어 있는지 확인하고 업데이트가 필요하면 수행하세요.
     

3. Gradle 캐시 정리 및 재빌드:

   • Android Studio에서 Build > Clean Project를 선택하여 프로젝트를 클린하고, 다시 빌드해 보세요.
     
   • 때때로 Gradle 설정이나 캐시로 인해 빌드가 정상적으로 이루어지지 않을 수 있습니다. 따라서 File > Invalidate Caches / Restart...를 선택하여 캐시를 정리한 다음, 앱을 다시 시도해 보세요.
     

4. Flutter Doctor:

   • 터미널에서 flutter doctor 명령어를 실행하여 필요한 모든 도구가 제대로 구성되어 있는지 확인하세요. 오류나 경고 메시지가 있다면 이를 해결하는 것이 중요합니다.
     

참고 자료

• 질문 제목: “문제 해결: 플루터 앱이 에뮬레이터에서 실행되지 않음”
  

이 링크는 유사한 문제를 다뤄 해결책을 제공하고 있으니 참고하시기 바랍니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.