메인 콘텐츠로 건너뛰기
@capgo/capacitor-파일 파일 및 저장소 오픈 소스

파일 Capacitor 플러그인

파일 시스템 플러그인을 위한 읽기, 쓰기 및 디렉토리 및 파일 관리

설치

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

사용 방법

Capacitor에서 파일 사용하기

장치에서 테스트

Capgo 앱을 다운로드하고 QR code를 스캔하세요.

파일 플러그인 미리보기 QR code

@capgo/capacitor-file을 사용하여

Capacitor 파일 플러그인은 Cordova File 플러그인과 같은 파일 시스템 연산을 구현합니다.

설치

bun add @capgo/capacitor-file
bunx cap sync

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

import

import { CapacitorFile } from '@capgo/capacitor-file';

API의 주요 기능

메서드 설명
requestFileSystem 파일 시스템을 요청하세요.
resolveLocalFileSystemURL 파일 URL을 엔트리로 해결하세요.
getFile 파일 엔트리를 가져오세요.
getDirectory 디렉토리 엔트리를 가져오세요.
readFile 텍스트 또는 base64로 파일을 읽으세요.
readAsDataURL base64와 MIME 타입 접두사를 포함한 데이터 URL로 파일을 읽으세요.
writeFile 데이터를 파일에 쓰세요.
appendFile 파일에 데이터를 추가하세요.
deleteFile 파일을 삭제하세요.
mkdir 디렉토리를 삭제하세요.
rmdir 디렉토리를 생성하세요.
readdir 디렉토리 내용 읽기.
stat 파일 또는 디렉토리의 메타데이터 가져오기.
getMetadata stat()의 별칭으로 파일 또는 디렉토리의 메타데이터 가져오기.
rename 파일 또는 디렉토리 이름 변경 또는 이동.
move rename()의 별칭으로 파일 또는 디렉토리 이동.
copy 파일 또는 디렉토리 복사.
exists 파일 또는 디렉토리가 존재하는지 확인.
getUri 파일 URI 가져오기.
truncate 파일 크기를 지정한 크기로 잘라내기.
getDirectories 모든 파일 시스템 디렉토리 가져오기.
getFreeDiskSpace 디스크의 무료 공간 크기 가져오기.
checkPermissions 파일 작업에 대한 현재 권한 상태 확인. 안드로이드에서는 외부 저장소 권한을 확인하고, iOS와 웹에서는 항상 '허용'을 반환합니다.
requestPermissions 파일 작업을 위한 권한 요청. 안드로이드에서 이 요청은 앱의 개인 디렉토리 외부의 파일에 접근하기 위한 외부 저장소 권한이 필요합니다. iOS와 웹에서는 특별한 권한이 필요하지 않기 때문에 항상 '허용'을 반환합니다.

예시

requestFileSystem()

파일 시스템을 요청합니다.

import { CapacitorFile, FileSystemType } from '@capgo/capacitor-file';

const result = await CapacitorFile.requestFileSystem({ type: FileSystemType.TEMPORARY });
console.log(result);

resolveLocalFileSystemURL()

파일 URL을 엔트리로 해결합니다.

import { CapacitorFile } from '@capgo/capacitor-file';

const result = await CapacitorFile.resolveLocalFileSystemURL({ url: 'https://example.com' });
console.log(result);

getFile()

파일 엔트리를 가져옵니다.

import { CapacitorFile } from '@capgo/capacitor-file';

const result = await CapacitorFile.getFile({ path: 'path/to/file' });
console.log(result);

getDirectory()

디렉토리 엔트리를 가져옵니다.

import { CapacitorFile } from '@capgo/capacitor-file';

const result = await CapacitorFile.getDirectory({ path: 'path/to/file' });
console.log(result);

readFile()

텍스트 또는 base64로 파일을 읽습니다.

import { CapacitorFile } from '@capgo/capacitor-file';

const result = await CapacitorFile.readFile({ path: 'path/to/file' });
console.log(result);

readAsDataURL()

MIME 타입 접두사와 함께 base64로 파일을 읽습니다.

import { CapacitorFile } from '@capgo/capacitor-file';

const result = await CapacitorFile.readAsDataURL({ path: 'path/to/file' });
console.log(result);

아래 표에는 24개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 GitHub.

이벤트를 듣습니다.

addListener handle을 반환합니다. 호출 handle.remove() 화면이 언마운트되거나, CapacitorFile.removeAllListeners() 모든 리스너를 삭제합니다.

전체 참조

capgo/capacitor-file을 사용하는 경우 계속하세요

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file을 사용하고 있습니다. capgo/capacitor-file과 연결하여 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file의 구현 세부 사항을 참조하세요 capgo/capacitor-file을 사용하여 capgo/capacitor-file과 연결하세요 Getting Started Getting Started @capgo/capacitor-SQLite 데이터 저장소 @capgo/capacitor-data-storage-sqlite @capgo/capacitor-데이터 저장소-sqlite Using @capgo/capacitor-data-storage-sqlite @capgo/capacitor-업로더 @capgo/capacitor-uploader

FAQ

파일 플러그인 FAQ

파일 플러그인을 Capacitor 앱에 설치하는 방법은?

Run "bun add @capgo/capacitor-file" (or "npm install @capgo/capacitor-file"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-file" in your app code.

React, Vue 및 Angular과 함께 @capgo/capacitor-file가 작동합니까?

Yes. File은 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 plain JavaScript와 같은 웹 프레임워크가 Capacitor 내부에서 실행되는 경우에 작동합니다.

어떤 Capacitor 버전이 @capgo/capacitor-file을 지원하는지?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다: 플러그인 메이저 버전이 사용하는 Capacitor 메이저 버전과 일치하는 경우 (예: 플러그인 v8과 Capacitor 8) 호환성 테이블은 GitHub README에서 확인할 수 있습니다.

@capgo/capacitor-file은 무료이며 오픈 소스인가?

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

code이 File을 사용하는 것을 업데이트할 수 있나요?

code을 업데이트하면 Native code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo Live Update와 함께 즉시 배포할 수 있습니다.

__CAPGO_KEEP_3__

플러그인을 스토어 빌드에 추가한 후, Capgo 라이브 업데이트로 사용자에게 몇 분 내에 자바스크립트, HTML 및 CSS 변경 사항을 푸시합니다.

Capgo 시작