본문으로 건너뛰기

TypeScript 지원

🔔 최신화 일자: 2025-04-25

nachocode Client SDK는 타입스크립트(TypeScript) 지원을 제공합니다.

타입스크립트 프로젝트에서 SDK를 더욱 편리하고 안전하게 사용하려면, 별도의 타입 선언 파일(Nachocode.d.ts)을 프로젝트에 추가하면 됩니다.

이 가이드는 타입스크립트 프로젝트에서 nachocode SDK를 설정하는 방법을 안내합니다.

1. 타입 선언 파일 설치 방법​

타입 선언 파일(Nachocode.d.ts)은 다음 두 가지 방법 중 하나로 설치할 수 있습니다.

✅ 방법 1: CDN에서 직접 다운로드​

다음 명령어로 최신 타입 선언 파일을 다운로드 받습니다.

curl -O https://cdn.nachocode.io/nachocode/client-sdk/@latest/Nachocode.d.ts

다운로드한 파일을 프로젝트 내의 타입 정의 디렉터리(types 또는 원하는 경로)에 추가하세요.

✅ 방법 2: 수동 다운로드​

웹 브라우저에서 아래 링크를 클릭하여 수동으로 다운로드 받을 수 있습니다.

2. 권장 디렉터리 구조 및 설정​

다음과 같은 디렉터리 구조를 권장합니다.

project-root/
├─ src/
│  ├─ index.ts
│  └─ ...
├─ types/
│  └─ Nachocode.d.ts  ✅ 타입 선언 파일 위치
└─ tsconfig.json

📌 타입스크립트 프로젝트의 tsconfig.json에서 타입 선언을 인식할 수 있도록 typeRoots 옵션을 설정하세요.

{
  "compilerOptions": {
    "typeRoots": ["./types", "./node_modules/@types"],
    ...
  }
}

💡 설명:
typeRoots 옵션은 컴파일러가 타입 선언 파일을 찾을 위치를 지정합니다.

3. 기본 사용 예시​

타입스크립트 환경에서는 자동완성 및 타입 검사 기능이 제공되어 편리합니다.

if (window.Nachocode) {
  // SDK 초기화
  Nachocode.init('your_api_key_here', { logger: true });

  // 앱 이름 가져오기
  const appName: string = Nachocode.app.getAppName();
  console.log(`앱 이름: ${appName}`);
}

4. 비동기 초기화 (initAsync) 예시​

nachocode Client SDK는 Promise를 반환하는 비동기 초기화 기능을 제공합니다.
비동기 초기화를 활용하면 SDK가 완전히 준비된 후 코드를 실행할 수 있습니다.

(async () => {
  if (window.Nachocode) {
    try {
      await Nachocode.initAsync('your_api_key_here', { logger: true });
      if (Nachocode.env.isApp()) {
        // 네이티브 앱 환경에서 실행할 코드 작성
        console.log('nachocode SDK가 네이티브 앱 환경에서 초기화되었습니다.');
      }
    } catch (error) {
      console.error('nachocode SDK 초기화에 실패했습니다.', error);
    }
  } else {
    console.error('nachocode SDK가 로드되지 않았습니다.');
  }
})();

5. 타입 선언 파일 (Nachocode.d.ts) 자세히 보기​

SDK의 전체 타입 정의 및 API 세부 사항을 확인하고 싶다면 아래 링크에서 직접 확인할 수 있습니다.

ℹ️ 추가 지원 안내

향후 여러 프론트엔드 프레임워크에 대한 지원도 계획 중입니다. 추가적인 지원이 필요하거나 기능 제안이 있으면 언제든지 support@nachocode.io에 의견을 남겨주세요.