@hanwha-ss1/capacitor-plugin

한화 모바일 공통 기능을 하나의 Capacitor 플러그인으로 제공한다. 새 프론트 코드는 HanwhaPlugin을 사용하고, 기존 함수명은 그대로 유지한다.

지원 버전

• Capacitor 8.5.2 (2026-10-01 기준 최신 안정 버전)
• Android minSdk 23 / compileSdk 36
• iOS 15.0 이상
• Node.js 20 이상

설치

npm install @hanwha-ss1/capacitor-plugin
npx cap sync

import { HanwhaPlugin } from '@hanwha-ss1/capacitor-plugin';

await HanwhaPlugin.configuration({ appgroup: 'group.com.hanwha.app', iv: '0000000000000000' });
await HanwhaPlugin.set({ key: 'accessToken', value: token, encrypt: true });
const tokenResult = await HanwhaPlugin.get({ key: 'accessToken', default: '' });

기존 함수명 호환

프론트에서 플러그인 등록 객체만 Plugin, SharedPreference, Viewer에서 HanwhaPlugin으로 변경하면 아래 함수 호출명은 유지할 수 있다.

| 기존 영역 | 유지되는 함수 | |---|---| | Plugin | executeApp, addContact, getCertificateProvisioning, auth, checkSeoulTimeZone, timezone, open, edgeSwipe, openCamera, fileDownload, fileDownloadChunk, doDisabledCapture, addKeyboardMenu, removeKeyboardMenu, clearCache | | SharedPreference | configuration, getAll, get, set, delete, deleteAll | | Viewer | load |

상세 명세는 기능 명세, 전환 순서는 마이그레이션 가이드를 참고한다.

검증

npm run build
ANDROID_HOME=$HOME/Library/Android/sdk npm run verify:android

현재 Android 라이브러리 빌드와 단위 테스트가 통과한다. iOS는 소비 앱의 Xcode 프로젝트에 npx cap sync ios 후 실제 기기/시뮬레이터에서 검증한다.