버전

1. 토스앱 버전 가져오기 (getTossAppVersion)

getTossAppVersion 함수는 토스 앱 버전을 가져와요. 예를 들어, 5.206.0과 같은 형태로 반환돼요. 토스 앱 버전을 로그로 남기거나, 특정 기능이 특정 버전 이상에서만 실행될 때 사용돼요.

시그니처

function getTossAppVersion(): string;

반환값

• string

  토스 앱 버전

예제

js

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

const tossAppVersion = getTossAppVersion();

React

import { getTossAppVersion } from '@apps-in-toss/web-framework';
import { Text } from '@toss/tds-mobile';

function TossAppVersionPage() {
  const tossAppVersion = getTossAppVersion();

  return <Text>{tossAppVersion}</Text>;
}

React Native

import { getTossAppVersion } from '@apps-in-toss/framework';
import { Text } from '@toss/tds-react-native';

function TossAppVersionPage() {
  const tossAppVersion = getTossAppVersion();

  return <Text>{tossAppVersion}</Text>;
}

---

2. 앱 최소 버전 확인하기 (isMinVersionSupported)

이 함수는 현재 실행 중인 토스 앱의 버전이 파라미터로 전달된 최소 버전 요구사항을 충족하는지 확인해요. 특정 기능이 최신 버전에서만 동작할 때, 사용자에게 앱 업데이트를 안내할 수 있어요.

시그니처

function isMinVersionSupported(minVersions: {
  android: `${number}.${number}.${number}` | 'always' | 'never';
  ios: `${number}.${number}.${number}` | 'always' | 'never';
}): boolean;

파라미터

• minVersions · 필수 · Object

  플랫폼별 최소 버전 요구사항을 지정하는 객체예요.

  • minVersions.android · 필수 · (${number}.${number}.${number} | 'always' | 'never')

    안드로이드 플랫폼의 최소 버전 요구사항이에요.
  • minVersions.ios · 필수 · (${number}.${number}.${number} | 'always' | 'never')

    iOS 플랫폼의 최소 버전 요구사항이에요.

반환값

• boolean

  현재 앱 버전이 최소 버전 이상이면 true, 그렇지 않으면 false를 반환해요.

예제

js

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

const isSupported = isMinVersionSupported({
  android: '1.2.0',
  ios: '1.3.0',
});

React

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

function VersionCheck() {
  const isSupported = isMinVersionSupported({
    android: '1.2.0',
    ios: '1.3.0',
  });

  return <div>{!isSupported && <Text>최신 버전으로 업데이트가 필요해요.</Text>};
}

React Native

import { isMinVersionSupported } from '@apps-in-toss/framework';
import { Text } from '@toss/tds-react-native';
import { View } from 'react-native';

function VersionCheck() {
  const isSupported = isMinVersionSupported({
    android: '1.2.0',
    ios: '1.3.0',
  });

  return <View>{!isSupported && <Text>최신 버전으로 업데이트가 필요해요.</Text>}</View>;
}