Appearance

2025년 4월 14일 ​

패키지 업데이트 ​

다음 패키지를 업데이트했어요.

  • react-native-bedrock: 0.0.19
  • @react-native-bedrock/native: 0.0.19
  • @apps-in-toss/framework: 0.0.20
  • @apps-in-toss/web-framework: 0.0.20

getDeviceId 패키지 위치 변경 ​

@apps-in-toss/framework 패키지에서 getDeviceId 함수를 가져와서 사용해야 해요. 기존에 사용하던 react-native-bedrock 패키지에서는 더 이상 제공하지 않아요.

어떻게 바꾸면 되나요? ​

1. 패키지를 최신 버전으로 업데이트해요

아래 명령어로 @apps-in-toss/framework 패키지를 최신 버전으로 업데이트해요.

sh
$ npm install @apps-in-toss/framework
sh
$ pnpm install @apps-in-toss/framework
sh
$ yarn add @apps-in-toss/framework

2. getDeviceId import 경로를 바꿔요

기존 코드에서 react-native-bedrock에서 가져오던 getDeviceId를 @apps-in-toss/framework에서 가져오도록 수정해요.

tsx
import { getDeviceId } from "react-native-bedrock"; 
import { getDeviceId } from "@apps-in-toss/framework";

뒤로가기 이벤트 제어 ​

@apps-in-toss/web-framework 패키지에 뒤로가기 버튼 이벤트를 감지하고 제어할 수 있는 기능이 추가됐어요. 웹뷰에서 사용자가 뒤로가기 버튼을 눌렀을 때, bedrockEvent 객체의 backEvent 이벤트를 통해 이를 감지할 수 있어요. 이 기능을 사용하면 웹에서 직접 뒤로가기 동작을 제어할 수 있어요.

예를 들어, 특정 화면에서 뒤로가기 버튼을 눌렀을 때 사용자에게 확인창을 띄우거나, 커스텀 내비게이션 로직을 실행할 수 있어요.

자세한 사용 방법은 뒤로가기 버튼 이벤트 제어하기 문서를 참고해 주세요.

네비게이션 다크모드 제거 ​

이번 업데이트에서는 기본적으로 적용되던 다크모드 스타일이 제거됐어요.

getPlatformOS export 경로 수정 ​

react-native-bedrock 패키지에서 getPlatformOS 함수가 react-native-bedrock/constant-bridges에서 export 되고 있던 부분을 react-native-bedrock으로 변경했어요.

게임 웹뷰에서 안드로이드 뒤로가기 버튼 동작 제어하기 ​

안드로이드 기기에서 물리 뒤로가기 버튼을 눌렀을 때, 게임 웹뷰가 바로 닫히지 않도록 처리했어요. 사용자가 실수로 앱을 종료하는 상황을 방지하기 위해, 뒤로가기 버튼을 누르면 먼저 종료 여부를 묻는 얼럿을 보여줘요.

얼럿 메시지는 다음과 같이 표시돼요.

  • "ㅇㅇㅇ을 종료할까요?"

게임 웹뷰 종료 얼럿 메시지에서 조사(을/를) 자동 처리하기 ​

게임 웹뷰 종료 얼럿 메시지에서 앱 이름 뒤에 자연스러운 한국어 조사가 붙도록 개선했어요.

  • 받침 없는 이름일 때 → 를

    • 예: "가나다를 종료할까요?"

  • 받침 있는 이름일 때 → 을

    • 예: "간난단을 종료할까요?"

이렇게 변경해서 앱 이름에 따라 자연스럽고 올바른 문장이 보이도록 했어요.