본문 바로가기
@capgo/capacitor-data-storage-sqlite 파일 및 스토리지 오픈 소스

데이터 저장 Capacitor 플러그인

간단한 키-값 API와 암호화를 지원하는 SQLite 데이터베이스로 데이터를 로컬에 저장하세요

설치

bun add @capgo/capacitor-data-storage-sqlite bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-data-storage-sqlite
  • pnpm add @capgo/capacitor-data-storage-sqlite
  • yarn add @capgo/capacitor-data-storage-sqlite

가이드

Capacitor에서 Data Storage 사용법

기기에서 테스트하기

Capgo 앱을 다운로드한 후 QR code을 스캔하세요.

Data Storage 플러그인 미리보기 QR code

@capgo/capacitor-data-storage-sqlite 사용하기

키/값 문자열 쌍을 저장하는 SQLite 저장소.

설치

bun add @capgo/capacitor-data-storage-sqlite
bunx cap sync

bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.

가져오기

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

API 한눈에 보기

메서드 설명
openStore Store를 엽니다.
closeStore Store를 닫습니다.
isStoreOpen Store가 열려 있는지 확인합니다.
isStoreExists Store가 존재하는지 확인합니다.
deleteStore Store를 삭제합니다.
setTable 기존 Store에 테이블을 설정하거나 추가합니다.
set 지정된 키와 값으로 데이터를 저장합니다.
get 지정된 키에 해당하는 데이터 값을 가져옵니다.
remove 지정된 키의 데이터를 삭제합니다.
clear Data Store를 비웁니다 (모든 키 삭제).
iskey 데이터 키가 존재하는지 확인합니다.
keys 데이터 키 목록을 가져옵니다.
values 데이터 값 목록을 가져옵니다.
filtervalues 필터 키에 대한 데이터 값 목록을 가져옵니다.
keysvalues 데이터 키/값 쌍 목록을 가져옵니다.
isTable 테이블 존재 여부를 확인합니다.
tables 현재 스토어의 테이블 목록을 가져옵니다.
deleteTable 테이블을 삭제합니다.
importFromJson JSON에서 데이터베이스를 가져옵니다.
isJsonValid JSON 객체의 유효성을 확인합니다.
exportToJson 주어진 데이터베이스를 JSON 객체로 내보냅니다.
vacuum 현재 SQLite 스토어를 재구성하여 사용하지 않는 디스크 공간을 확보합니다.

예시

openStore()

Store를 엽니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.openStore({
  database: 'database',
  table: 'table',
  encrypted: false,
  mode: 'encryption',
  autoVacuum: 'none',
});

closeStore()

Store를 닫습니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.closeStore({ database: 'database' });

isStoreOpen()

Store가 열려 있는지 확인합니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

const result = await CapgoCapacitorDataStorageSqlite.isStoreOpen({ database: 'database' });
console.log(result);

isStoreExists()

Store가 존재하는지 확인합니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

const result = await CapgoCapacitorDataStorageSqlite.isStoreExists({ database: 'database' });
console.log(result);

deleteStore()

Store를 삭제합니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.deleteStore({
  database: 'database',
  table: 'table',
  encrypted: false,
  mode: 'encryption',
  autoVacuum: 'none',
});

setTable()

기존 Store에 테이블을 설정하거나 추가합니다.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.setTable({ table: 'table' });

위 표에는 22개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 다음 문서에 설명되어 있습니다. GitHub 리포지토리.

전체 레퍼런스

@capgo/capacitor-data-storage-sqlite 사용하기부터 계속하기

사용 중이라면 @capgo/capacitor-data-storage-sqlite 사용하기 저장 공간과 파일 처리를 계획하려면, 다음 항목과 연결하세요 @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite의 구현 세부 사항은, 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-file @capgo/capacitor-file의 구현 세부 사항은, @capgo/capacitor-file 사용하기 @capgo/capacitor-file 사용 시 네이티브 기능에 대해서는, 그리고 @capgo/capacitor-uploader @capgo/capacitor-uploader.의 구현 세부 사항에 대해서는

자주 묻는 질문

Data Storage 플러그인 FAQ

Capacitor 앱에 Data Storage 플러그인을 설치하는 방법은 무엇인가요?

"bun add @capgo/capacitor-data-storage-sqlite" (또는 "npm install @capgo/capacitor-data-storage-sqlite")를 실행한 후, iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 "bunx cap sync"를 실행하세요. 앱 code에서 "@capgo/capacitor-data-storage-sqlite"로 가져오세요.

@capgo/capacitor-data-storage-sqlite은 React, Vue, Angular와 호환되나요?

네. Data Storage는 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 순수 JavaScript를 포함하여 Capacitor 내에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-data-storage-sqlite이 지원하는 Capacitor 버전은 무엇인가요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-data-storage-sqlite은 무료이고 오픈 소스인가요?

네. 소스 code는 https://github.com/Cap-go/capacitor-data-storage-sqlite/의 GitHub에서 공개되어 있으며, npm에서 무료로 설치할 수 있습니다. 버그 보고와 풀 리퀘스트를 환영합니다.

Data Storage를 사용하는 code을 App Store 리뷰 없이 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 리뷰를 기다리지 않고 Data Storage 변경 사항을 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기