← 홈으로 돌아가기

라이브러리

독립적인 JavaScript 라이브러리

📦 파일 구조

flutter-bridge.js

UMD 번들 - 13KB

모든 환경에서 사용 가능한 JavaScript 라이브러리

  • CDN으로 직접 로드
  • NPM 모듈로 import
  • ES6 모듈로 import
  • CommonJS require

flutter-bridge.d.ts

TypeScript 타입 정의 - 5KB

완벽한 TypeScript 지원과 자동완성

package.json

NPM 패키지 설정

npm publish로 NPM 레지스트리에 배포 가능

🚀 사용 방법

1. CDN (가장 간단)

<script src="./flutter-bridge.js"></script>
<script>
    const bridge = new FlutterBridge();
</script>

2. ES6 모듈

import FlutterBridge from './flutter-bridge.js';

const bridge = new FlutterBridge({ debug: true });

3. CommonJS

const FlutterBridge = require('./flutter-bridge.js');

const bridge = new FlutterBridge();

4. TypeScript

import FlutterBridge from './flutter-bridge';

const bridge = new FlutterBridge({ debug: true });

// 타입 지원으로 자동완성!

⚙️ 초기화 옵션

const bridge = new FlutterBridge({
    debug: true,        // 디버그 로그 출력
    timeout: 10000,     // 타임아웃 (밀리초)
    retries: 3          // 재시도 횟수
});

🌐 프레임워크별 사용

Vue 3

// main.js 또는 App.vue
import FlutterBridge from './utils/flutter-bridge';

const bridge = new FlutterBridge({ debug: true });

// 전역으로 제공
app.provide('bridge', bridge);

React

// useBridge.js
import { useState } from 'react';
import FlutterBridge from './utils/flutter-bridge';

const bridge = new FlutterBridge({ debug: true });

export function useBridge() {
    return bridge;
}

Angular

// bridge.service.ts
import { Injectable } from '@angular/core';
import FlutterBridge from './utils/flutter-bridge';

@Injectable({ providedIn: 'root' })
export class BridgeService {
    private bridge = new FlutterBridge({ debug: true });
    
    async getLocation() {
        return await this.bridge.getLocation();
    }
}

📁 파일 위치

라이브러리 파일들은 lib/ 폴더에 있습니다:

lib/
├── flutter-bridge.js      # UMD 번들
├── flutter-bridge.d.ts    # TypeScript 타입
├── package.json           # NPM 설정
├── README.md              # 라이브러리 문서
└── examples/              # 예제 파일들
    ├── vanilla-js.html
    ├── vue3-cdn.html
    ├── react-cdn.html
    ├── angular-cdn.html
    └── svelte-cdn.html

💡 예제 파일

각 프레임워크별 완전한 예제가 제공됩니다:

📚 API 메서드

전체 API 목록은 API 문서를 참고하세요.

주요 메서드:

라이브러리 사용법 상세 가이드 →