레거시 브라우저 (IE11)

IE11을 포함한 레거시 브라우저에서 Sophonz Browser SDK를 설치하는 방법을 안내합니다.

Sophonz Browser SDK는 레거시 브라우저를 제한적으로 지원합니다. 지원 범위는 IE11, Chrome 52, Edge Legacy 79, Safari 11, Firefox 57 이상입니다.

NOTE — 테스트 환경

Internet Explorer 11에서 테스트되었습니다.

패키지 매니저로 설치

패키지 매니저(npm, yarn, pnpm, bun 등)로 설치한 경우, @sophonz/browser-sdk 패키지를 설치합니다.

npm install @sophonz/browser-sdk

아래와 같이 @sophonz/browser-sdk/legacy를 import하여 사용합니다.

import SophonzSDK from "@sophonz/browser-sdk/legacy";
 
SophonzSDK.init({
  collectorUrl: '{{SOPHONZ_TRACES_COLLECTOR_URL}}',
  appName: '{{NAME_OF_YOUR_WEB_SERVICE}}',
  appVersion: '{{VERSION_OF_YOUR_WEB_SERVICE}}',
  appKey: '{{KEY_OF_YOUR_WEB_SERVICE}}',
  project: '{{SERVICE_NAMESPACE}}',
  deploymentEnvironment: '{{DEPLOYMENT_ENVIRONMENT}}',
  // 기타 설정...
});

NOTE — 번들 포맷

umd 포맷으로 번들링이 되어 있어 commonjs, amd, iife 등 다양한 환경에서 사용할 수 있습니다.

CDN 혹은 로컬 설치

CDN 혹은 로컬 js 파일을 HTML에 추가합니다. 아래 예시에서는 index.html 파일에 Sophonz Browser SDK의 CDN 경로를 추가하고 초기화합니다. 폐쇄망의 경우 자세한 설치 및 설정은 폐쇄망(air-gapped) 설치 섹션을 참고하세요.

<script
  src="https://cdn.sophonz.com/release/npm/@browser-sdk/latest/index-legacy.js"
  type="text/javascript"></script>
<script>
window.SophonzSDK.init({
  collectorUrl: '{{SOPHONZ_TRACES_COLLECTOR_URL}}',
  appName: '{{NAME_OF_YOUR_WEB_SERVICE}}',
  appVersion: '{{VERSION_OF_YOUR_WEB_SERVICE}}',
  appKey: '{{KEY_OF_YOUR_WEB_SERVICE}}'
  project: '{{SERVICE_NAMESPACE}}',
  deploymentEnvironment: '{{DEPLOYMENT_ENVIRONMENT}}',
  // 기타 설정...
});
</script>

NOTE — index-legacy.js 파일

index-legacy.js 자바스크립트 파일은 레거시 브라우저에서 사용할 수 있도록 번들링된 파일입니다. 이 파일은 tgz 패키지를 압축 해제하여 build 폴더에 있는 index-legacy.js 파일을 프로젝트에 추가하여 사용할 수 있습니다.

tgz 패키지 다운로드: https://cdn.sophonz.com/release/npm/@browser-sdk/latest/sophonz-browser-sdk-latest.tgz

특정 버전을 설치하려면 @browser-sdk/{VERSION}을 사용합니다. 지원되는 버전은 1.0.0 이상입니다. SDK 초기화 코드는 동일하며, 설정이 완료되면 모든 계측이 자동으로 수행됩니다.