설치
Sayren Widget SDK를 설치하는 다양한 방법
설치
Sayren Widget SDK는 여러 가지 방법으로 설치할 수 있습니다.
CDN (권장)
가장 간단한 방법은 CDN을 통해 스크립트를 로드하는 것입니다. 별도의 빌드 과정 없이 바로 사용할 수 있습니다.
unpkg
<script src="https://unpkg.com/@sayren/widget"></script>jsDelivr
<script src="https://cdn.jsdelivr.net/npm/@sayren/widget"></script>특정 버전 고정
프로덕션 환경에서는 버전을 고정하는 것을 권장합니다:
<!-- unpkg -->
<script src="https://unpkg.com/@sayren/widget@0.1.0"></script>
<!-- jsDelivr -->
<script src="https://cdn.jsdelivr.net/npm/@sayren/widget@0.1.0"></script>npm / pnpm / yarn
모던 JavaScript 프로젝트에서는 패키지 매니저를 사용하여 설치할 수 있습니다.
# npm
npm install @sayren/widget
# pnpm
pnpm add @sayren/widget
# yarn
yarn add @sayren/widget설치 후 import하여 사용합니다:
import { SayrenWidget } from '@sayren/widget';
SayrenWidget.init({
workspaceId: 'YOUR_WORKSPACE_ID'
});번들 크기
| 포맷 | 크기 | gzip |
|---|---|---|
| ESM | 6.8KB | ~2.5KB |
| CJS | 7.3KB | ~2.7KB |
| IIFE (CDN) | 7.3KB | ~2.7KB |
브라우저 지원
SDK는 모던 브라우저를 지원합니다:
- Chrome 60+
- Firefox 60+
- Safari 12+
- Edge 79+
Internet Explorer는 지원되지 않습니다.
TypeScript 지원
SDK는 TypeScript 타입 정의를 기본 제공합니다.
별도의 @types 패키지 설치가 필요 없습니다.
import { SayrenWidget, type SayrenConfig, type SayrenStatus } from '@sayren/widget';
const config: SayrenConfig = {
workspaceId: 'YOUR_WORKSPACE_ID',
position: 'bottom-right'
};
await SayrenWidget.init(config);
const status: SayrenStatus = SayrenWidget.status;