강의

멘토링

로드맵

Inflearn brand logo image

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

이소연님의 프로필 이미지
이소연

작성한 질문수

[2025] 비전공자도 가능한 React Native 앱 개발 마스터클래스

[개발] UI 구성

stylecomponents 오류

작성

·

187

0

styled-components를 설치하고 import하면 다음과 같은 오류가 발생합니다:

runtime not ready: ReferenceError: Property 'document' doesn't exist, js engine: hermes, stack: ...

해결을 위해 시도한 것들은 다음과 같습니다:

- import 부분에 /native 잘 붙어 있는지 확인

- Metro 캐시 삭제 후 다시 실행

- styled-components 버전을 낮춰 설치 (5.3.11 등)

하지만 여전히 동일한 에러가 발생해서, 현재는 StyleSheet 방식으로 전환해서 사용하고 있습니다.

혹시 이런 상황에서 styled-components를 안정적으로 사용하는 다른 방법이 있을까요?

아니면 React Native에서는 styled-components를 피하고 StyleSheet를 사용하는 게 나은 선택일까요?

같은 경험을 하신 분이 있다면 공유해주시면 감사하겠습니다!

답변 3

0

https://github.com/styled-components/styled-components/issues/5576
styled-components 깃헙에 관련 이슈 있네요 저도 같은이슈로 삽질하다가 발견해서 댓남깁니다 총총...

정현우님의 프로필 이미지
정현우
지식공유자

오 여기에서 나온 해결책 참고하시면 좋을 것 같은데요?? 좋은 정보 공유 감사합니다 🙂

0

이소연님의 프로필 이미지
이소연
질문자

네 여전히 오류가 뜨네요... ㅠㅠ

그 외의 오늘 시도해 본 방법들은

1. 바벨 설정 제거

  • babel-plugin-styled-components@2.1.4가 styled-components 설치 시 자동 포함됨

  • babel.config.js 내 플러그인 제거

  • 직접 uninstall 시도해도 계속 npm ls에 남아 있음


2. 캐시 정리 + 재설치

  • package-lock.json, node_modules 삭제

  • npm cache clean --force

  • npm install --legacy-peer-deps

  • npx react-native start --reset-cache

→ 결과: 여전히 같은 document 오류 발생


3. pnpm 도입

  • npm install -g pnpm

  • pnpm add styled-components

  • 그래도 babel-plugin-styled-components 따라옴


4. 완전한 새 프로젝트 생성

npx @react-native-community/cli init StyledApp --template react-native-template-typescript@latest cd StyledApp pnpm add styled-components

  • App.tsx에 styled-components 최소 예제 작성

  • → 여전히 document 오류 발생


5. 빌드만 시도

cd android .\gradlew assembleDebug

  • 빌드는 정상적으로 성공함

  • SDK, build-tools 모두 설치 완료


6. 실기기에서 실행

  • USB 디버깅 활성화된 안드로이드 폰 연결

  • npx react-native run-android

→ 결과:

  • 앱 설치 직전 컴퓨터 강제 종료됨 (하드웨어 과부하로 추정)

  • 재부팅 후 다시 실행해도 동일하게 꺼짐

정현우님의 프로필 이미지
정현우
지식공유자

혹시

npx react-native doctor

명령어를 입력해보시겠어요??

정현우님의 프로필 이미지
정현우
지식공유자

정 안되시면 아예 RN 개발 환경 설정을 다시 해보시는 것도 추천드릴게요. 작성해주신 내용 보면 코드상의 문제가 있는건 아닌 것 같고, 사용하시는 컴퓨터 자체의 충돌의 문제 아닐까 생각이 듭니다.

0

정현우님의 프로필 이미지
정현우
지식공유자

혹시

npm install styled-components@latest

명령어를 통해서 최신 버전을 설치하시고 임포트 해보시겠어요?? 해결 방법은 계속 찾아보겠습니다!

이소연님의 프로필 이미지
이소연
질문자

넵! 최신으로 해보았습니다! 그래도 다시한 번 시도해보겠습니다

정현우님의 프로필 이미지
정현우
지식공유자

그렇군요.. 현재 질문주신 부분을 최대로 활용해서 계속 삽질해 보고 있는데 해결방법이 도저히 안나오는 것 같습니다.

그래도 일단 최대한으로 답변을 드리자면

import styled from 'styled-components/native';

코드가 정확하게 적혀져 있는지 다시 한번 확인해 주세요.

그리고 android/app/.cxx 에서 .cxx 폴더를 확인하실 수 있으실 겁니다.

image.png

.cxx 폴더를 삭제해 주세요.

그리고 윈도우를 사용중이시라면
C:\Users\수강생님 사용자 이름\.gradle\caches
폴더, 즉 caches 폴더를 삭제해 주세요.

또는 맥북을 사용중이시라면
/Users/수강생님 사용자 이름/.gradle/caches
폴더, 즉 caches 폴더를 삭제해 주세요.

그리고 다시 빌드 해주시면 됩니다.

해결 안되시면 꼭 추가로 질문 주세요! 그런데 이제 해결방법이 있을련지 모르겠습니다ㅠㅠ 일단 해봐주시고 안되면 스타일시트를 사용하는 방식으로 진행하셔야 될 것 같습니다. 계속 오류 해결방법 찾아 볼게요!

이소연님의 프로필 이미지
이소연

작성한 질문수

질문하기