본문으로 건너뛰기

getPlatformOS

현재 미니앱이 실행되는 플랫폼 OS를 동기적으로 반환합니다. React Native의 Platform.OS 값을 기반으로 동작하며 'ios' 또는 'android' 중 하나를 반환합니다.

시그니처​

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

declare function getPlatformOS(): 'ios' | 'android';

파라미터​

없음.

반환값​

  • 'ios' — 현재 iOS 환경에서 실행 중입니다.
  • 'android' — 현재 Android 환경에서 실행 중입니다.

권한​

권한이 필요하지 않습니다 — getPlatformOS는 별도의 PermissionName에 바인딩되지 않습니다. 권한이 필요한 다른 네임스페이스의 일반적인 처리 흐름은 Guides — 권한 처리 패턴을 참고하세요.

예제​

최소 예제​

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

const platform = getPlatformOS();
console.log('현재 플랫폼:', platform); // 'ios' 또는 'android'

실전 예제 — 플랫폼별 스타일 분기​

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

function PlatformSpecificButton() {
  const platform = getPlatformOS();
  const isIos = platform === 'ios';

  return (
    <button
      type="button"
      style={{
        // iOS는 둥근 버튼, Android는 Material 스타일
        borderRadius: isIos ? 22 : 4,
        fontFamily: isIos ? '-apple-system' : 'Roboto, sans-serif',
        padding: '12px 24px',
      }}
    >
      {isIos ? 'iOS 스타일 버튼' : 'Android 스타일 버튼'}
    </button>
  );
}

직접 실행해 보기​

sdk-example의 Environment 페이지에서 getPlatformOS 카드를 실행해 결과를 확인할 수 있습니다.

sdk-example에서 실행해 보기

관련 API​

관련 가이드​

외부 참조​