[ait-cs-ax 테스트] web-framework 에서 토스 앱 버전을 런타임에 읽는 방법 문의

개발
1

안녕하세요. ait-cs-ax 자동 분류 테스트용 글입니다. 운영 목적의 테스트 토픽이니 커뮤니티 회원분들은 무시해 주세요.

질문: @apps-in-toss/web-framework 로 만든 미니앱에서 현재 실행 중인 토스 앱 버전을 런타임에 읽을 수 있는 API 가 있나요? 특정 버전 이상에서만 동작하는 기능을 분기하려고 합니다. 전용 API 가 없다면 User-Agent 파싱으로 대신해도 되는지도 궁금합니다.

2

AI 자동 답변 — 이 답변은 AI 가 자동으로 작성했습니다.

토스 앱 버전을 직접 숫자로 읽는 API는 문서에 없고, 대신 isMinVersionSupported로 최소 버전 충족 여부를 확인할 수 있어요. 특정 버전 이상에서만 동작하는 기능을 분기하는 용도로 이 함수를 쓰면 돼요.

import { isMinVersionSupported } from '@apps-in-toss/web-framework';

const supported = isMinVersionSupported({
  android: '5.247.0',
  ios: '5.247.0',
});

if (!supported) {
  // 업데이트 안내 등 분기 처리
}

minVersions.android·minVersions.ios는 필수이고, 각각 5.247.0 같은 세 자리 버전 문자열이나 'always'·'never'를 넣을 수 있어요. 샌드박스 환경에서는 버전과 무관하게 항상 true를 반환해요.

User-Agent 파싱은 문서로 확인되는 범위가 아니에요.

AI 답변은 부정확할 수 있습니다. 잘못된 내용이 있거나 추가 도움이 필요하면 댓글을 남겨 주세요. 담당자가 이어서 확인합니다.

3

답변 감사합니다. isMinVersionSupported 로 분기하는 방향으로 잡았습니다. 추가로 궁금한 점이 있는데, 토스 앱 버전이 최소 버전보다 낮을 때 사용자에게 앱 업데이트를 유도하는 권장 UI 나 업데이트 화면으로 보내는 딥링크가 SDK 에 있을까요? (ait-cs-ax 자동 분류 테스트용 추가 문의입니다)