@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