Bedrock → Granite 마이그레이션 관련 문의 (유니티 WebGL 프로젝트)

개발
1

안녕하세요, 유니티 WebGL로 WebView를 사용해서 프로젝트를 개발중입니다.

어제 공지사항 “2025/09/10 SDK 패키지 업데이트” 글의 내용을 보고 마이그레이션을 하려고 하는데요.

  • 기반 프레임워크가 변경 되었어요.

    • Bedrock → Granite로 바뀌었어요.

    • 제공되는 CLI를 통해 마이그레이션을 진행해 주세요.

    • 마이그레이션 후 개발자 테스트를 꼭 진행해 주세요.

[ 마이그레이션 관련 ]

  • ait migrate granite

관련 위 내용을 적용하기 위해서 게임 개발 위주로 해서 SDK 적용 관련 지식이 부족하다보니,
내용 중에 “제공되는 CLI를 통해 마이그레이션을 진행해 주세요.” , "ait migrate granite” 를 어떤식으로 어디서 진행해야 하는 것인지 이해가 좀 힘들더라구요.
혹시 번거로우시더라도 좀 더 구체적인 적용 방법에 대해서 설명 해주실 수 있을까요?

현재 프로젝트는 유니티 WebGL로 개발중이며, “Vite로 Unity WebGL 빌드 감싸기” 방식으로 개발 중입니다.

2

안녕하세요 :slight_smile:
web-framework 버전, TDS 버전은 최신화되셨을까요 ?!
최신화 하셨다면, 사용하신 패키지 매니저에 맞게 migrate 해주시면 돼요

e.g. 패키지 매니저 npm 사용

npx ait migrate granite

e.g. 패키지 매니저 yarn 사용

yarn ait migrate granite
1개의 좋아요
3

우선 빠른 회신 감사드립니다!!
혹시 web-framework 버전, TDS 버전은 최신화 방법을 여쭤봐도 될까요? ㅜ,ㅜ
기초적인 질문이라면 죄송합니다만, node 및 리액트에 대한 이해도가 낮다보니 문의 드립니다.

4

패키지매니저에 따라 다르지만 npm 기준으로 설명드리자면,

npm install @apps-in-toss/web-framework@latest
npm install @toss-design-system/mobile@latest @toss-design-system/mobile-ait@latest

요렇게 해주시면 될 것 같아요!

1개의 좋아요
5

답변 감사합니다~!

npm install @apps-in-tossapps-in-tossapps-in-tossapps-in-to@toss-design-systempms/web-fra@tosework@latest
@toss-design-systempm install @tos@@toss-design-systemoss-design-system-design-system/mobile@latest @toss-design-system/mobile-ait@latest

각각 실행시 아래와 같은 오류가 발생하는데 혹시 다른 선행 조건 또는 사전 작업이 필요할까요?

스크린샷 2025-09-11 오후 1.00.14
스크린샷 2025-09-11 오후 1.00.141920×1220 145 KB

6

요 문서 참고 부탁드려요 :slight_smile: