[Programming/Qt] Qt6와 웹어셈블리(WASM) 연동

Qt6를 WebAssembly(WASM) 타겟으로 빌드하여 브라우저에서 실행하는 방법을 간단히 정리한다.

Posted Mar 2, 2026 Updated Apr 7, 2026

By Seongcheol Jeon

views 1 min read

나는 Qt6.7을 설치하면서 Qt를 위한 웹어셈블리 패키지도 함께 설치하였다. 그래서 WASM SDK를 잡아주어야 한다.

그런데 내가 설치한 Qt 버전과 호환성이 좋은 WASM 버전을 설치해야 하는데, 어는 버전을 설치하는 것이 좋을지 고민하였다. 아래는 그 질문에 대한 답이 나와 있다.

Qt for WebAssembly 이 사이트로 가서 확인해보면, Qt6.7의 경우 SDK의 버전은 3.1.50이다. 그래서 해당 버전을 설치하였다.

Emscripten 설치

소스 다운로드

  
git clone https://github.com/emscripten-core/emsdk.git

emsdk 설치

  
cd emsdk
./emsdk install 3.1.50
./emsdk activate 3.1.50

간단한 main.cpp 파일을 생성하자.

  
#include <iostream>

int main() {
  std::cout<<"Hello World!"<<std::endl;

  return 0;
}

main.cpp를 컴파일하면, javascript파일이 생성된다. 이것을 node를 통해 실행하면 터미널에 “Hello World!”가 출력된다.

  
// build
em++ main.cpp

// run
node a.out.js

  
// html 파일 생성
em++ main.cpp -o main.html

// run 
emrun main.html