https://gall.dcinside.com/m/godot/957

GitHub actions으로 웹 배포 방법 - 고도엔진 마이너 갤러리

github pages라고 정적 웹파일 호스팅해주는게 있다export -> HTML5로 하면 겜을 번들링해서 html, js, wasm 파일로 뽑아주는데 이걸 깃허브에 올리면 끝깃헙액션으로 푸시하면 이게

gall.dcinside.com

옛날에 고도3일때 올린거랑 거의 비슷한데, 바뀐게 몇개 있다

(1) 빌드시 --export -> --export-release로 옵션 이름이 바뀌었고 --headless 옵션 추가해야함

(2) godot-ci 이미지 특정 버전부터(아마도 4?) export template 경로가 변경되었음 (.../template/... -> .../export_templates/...)

(3) 4부터 웹빌드시 SharedArrayBuffer를 사용하게 된다

원래 브라우저에서 실행되는 js는 이벤트루프 기반 싱글스레드였는데, SharedArrayBuffer를 사용하면 멀티스레드를 사용할 수 있게 되었다

하지만 해당 기능이 spectre 등의 취약점에 이용될 수 있기 때문에, 대부분 브라우저에서는 특정 조건을 만족해야만 사용할 수 있게 되어 있다.

조건이라 함은 아래 헤더가 http response에 있어야 한다

Cross-Origin-Opener-Policy: same-origin

Cross-Origin-Embedder-Policy: require-corp

없으면 아래와 같은 에러가 나온다

그럼 웹서버쪽에 헤더를 붙여주면 그만 아닌가 싶기도 하지만, github pages 등 우리가 컨트롤 할 수 없는 웹서버도 있다

그래서 대안으로는 coi-serviceworker(https://github.com/gzuidhof/coi-serviceworker) 라는걸 쓰는 방법이 있다.

정확한 동작방식은 잘 모르겠으나, index.html에 스크립트를 넣기만 하면 헤더를 컨트롤할 수 없는 경우에도 해결이 된다.

그래서 애초에 웹 빌드시에 coi-serviceworker js 파일을 넣어주자~ 라는 의견도 나옴 (아래이슈참고)

..또는 옛날처럼 싱글쓰레드로 회귀하자는 의견도 있으나, 이건 좀 좋지 않은 것 같다

https://github.com/godotengine/godot-proposals/issues/6616

Use an HTML-based solution to the SharedArrayBuffers problem · Issue #6616 · godotengine/godot-proposals

Describe the project you are working on Any web project Describe the problem or limitation you are having in your project Currently, a Godot 4 web build requires adding the following headers to an ...

github.com

아무튼 (3)을 해결하기 위해 github actions 중간에 파일 받고 index.html 수정하는 내용을 넣어주는 과정이 필요하다

최종 github actions workflow는 아래와 같다

(link: https://github.com/sh-cho/godot-platformer-tutorial/blob/76e3730c2b370fdcb9ab3522a1d520429e2f3f84/.github/workflows/deploy.yml)

참고로 위 워크플로는 별도 브랜치에 커밋하는 방식이 아니고

전부 action runner상에서 빌드 & 배포를 한다

그래서 Settings - Pages - Build and deployment - source를 GitHub Actions로 바꿔줘야 한다

기본은 아마 브랜치 + 경로로 되어있을거임

혹시 웹빌드 로컬에서 테스트 하고 싶다면

mkdir ... , godot 빌드까지 똑같이 하고 (godot 크래시 나도 무시한다)

coi-serviceworker 넣고

npx http-server --cors

로 띄운뒤 localhost 8080으로 접속하면 된다