open-wxa/wxa-runner

어떤 프로젝트인가요?

핵심 기능

• 01브라우저에서 공식 WeChat 기반 라이브러리로 컴파일된 미니 프로그램 결과물을 실행합니다.
• 02네이티브, uni-app 및 Taro 빌드 결과물을 지원합니다.
• 03WeChat DevTools 없이 Playwright로 헤드리스 E2E 테스트를 실행할 수 있습니다.
• 04중단점 설정, 네트워크 및 DOM 검사 기능으로 Chrome DevTools 디버깅을 지원합니다.
• 05저장 시 핫 리로드를 제공합니다.
• 06설정 훅으로 네이티브 API를 모킹하고, wx.request를 가로채며, 로그인 상태를 미리 설정할 수 있습니다.

활용 사례

• Linux의 CI에서 미니 프로그램용 Playwright E2E 테스트를 작성하는 경우.
• 개발 중 브라우저 DevTools로 페이지 로직과 네트워크 호출을 디버깅하는 경우.
• 모킹한 로그인이나 스텁 처리한 백엔드 응답이 필요한 흐름을 테스트하는 경우.

빠른 시작

1. 1

   컴파일된 미니 프로그램 디렉터리에서 개발 서버를 실행합니다

   npx wxa-runner dev ./dist/dev/mp-weixin
2. 2

   터미널에 표시된 로컬 주소를 브라우저에서 엽니다

사용 전 알아둘 점

• !WeChat Developer Tools를 대체하지 않습니다. 미리보기, 업로드, 실제 기기 디버깅에는 여전히 WeChat Developer Tools가 필요합니다.
• !공식 WeChat base library를 기반으로 하며, 프로젝트의 MIT 라이선스 적용 대상이 아닙니다.

토픽

자주 묻는 질문

wxa-runner은(는) 무엇인가요?

공식 WeChat 기반 라이브러리를 사용해 일반 브라우저에서 WeChat 미니 프로그램을 실행하고, Chrome DevTools 디버깅과 Playwright E2E 테스트를 지원합니다. wxa-runner는 네이티브 프로젝트와 uni-app 또는 Taro 빌드를 포함한 컴파일된 WeChat 미니 프로그램 결과물을 데스크톱 브라우저에서 바로 실행합니다. 렌더링, 컴포넌트, setData와 라이프사이클은 재구현이 아니라 공식 WeChat 기반 라이브러리에서 실행되므로, 앱의 H5 버전보다 실제 기기에서의 동작에 가깝습니다.

wxa-runner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

wxa-runner은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

wxa-runner은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. wxa-runner의 마지막 커밋은 2026년 10월 21일입니다.

wxa-runner은(는) 어디에 사용할 수 있나요?

Linux의 CI에서 미니 프로그램용 Playwright E2E 테스트를 작성하는 경우. 개발 중 브라우저 DevTools로 페이지 로직과 네트워크 호출을 디버깅하는 경우. 모킹한 로그인이나 스텁 처리한 백엔드 응답이 필요한 흐름을 테스트하는 경우.

wxa-runner는 어떻게 설치하나요?

컴파일된 미니 프로그램 디렉터리에서 개발 서버를 실행합니다: npx wxa-runner dev ./dist/dev/mp-weixin 터미널에 표시된 로컬 주소를 브라우저에서 엽니다

wxa-runner은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/open-wxa/wxa-runner