Capacitor 파일 플러그인은 Cordova File 플러그인과 같은 파일 시스템 연산을 구현합니다.
핵심 기능
‘핵심 기능’이라는 제목의 섹션requestFileSystem- 파일 시스템을 요청합니다.resolveLocalFileSystemURL- 파일 URL을 엔트리로 해결합니다.getFile- 파일 엔트리를 가져옵니다.getDirectory- 디렉토리 엔트리를 가져옵니다.
- Public API
- Public 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 | 바이트 단위의 사용 가능한 디스크 공간을 가져옵니다. |
addListener | 읽기 진행 이벤트를 듣습니다. |
addListener | 쓰기 진행 이벤트를 듣습니다. |
removeAllListeners | 모든 이벤트 리스너를 제거합니다. |
getPluginVersion | 플러그인 버전을 가져옵니다. |
checkPermissions | 파일 작업에 대한 현재 권한 상태를 확인합니다. 안드로이드에서는 외부 저장소 권한을 확인하고, iOS 및 웹에서는 항상 '허용'을 반환합니다. |
requestPermissions | 파일 작업에 대한 권한을 요청합니다. 안드로이드에서는 앱의 개인 디렉토리 외부의 파일에 접근하기 위해 필요한 외부 저장소 권한을 요청합니다. iOS 및 웹에서는 항상 '허용'을 반환합니다. |
참조 값
참조 값 섹션파일 저장 위치를 선택할 때, 암호화된 텍스트를 작성할 때, 또는 파일 오류를 처리할 때 사용하는 값입니다.
디렉터리
디렉터리 섹션| 값 | 사용자는 |
|---|---|
DOCUMENTS | 사용자에게 보이지 않는 영구 문서입니다. 안드로이드에서는 앱 파일 디렉터리로 매핑됩니다. |
DATA | 사용자에게 보이지 않는 영구 앱 데이터입니다. 안드로이드에서는 앱 파일 디렉터리로 매핑됩니다. |
LIBRARY | 사용자에게 보이지 않는 영구 앱 데이터입니다. 안드로이드에서는 앱 파일 디렉터리로 매핑됩니다. |
CACHE | 운영 체제가 삭제할 수 있는 임시 캐시 데이터입니다. |
EXTERNAL | 안드로이드 외부 저장소의 루트, 예를 들어 SD 카드 또는 공유 외부 저장소입니다. |
EXTERNAL_STORAGE | 안드로이드 외부 저장소 데이터 디렉토리. |
APPLICATION | 읽기 전용 애플리케이션 번들 또는 자산 디렉토리. |
인코딩
인코딩| 값 | 사용 |
|---|---|
utf8 | UTF-8 텍스트. |
ascii | ASCII 텍스트. |
utf16 | UTF-16 텍스트. |
파일 오류 코드
인코딩| 값 | Code | 의미 |
|---|---|---|
NOT_FOUND_ERR | 1 | 파일 또는 디렉토리가 존재하지 않습니다. |
SECURITY_ERR | 2 | 보안 규칙 또는 권한으로 인해 작업이 중단되었습니다. |
ABORT_ERR | 3 | 작업이 취소되었습니다. |
NOT_READABLE_ERR | 4 | 파일 또는 디렉토리를 읽을 수 없습니다. |
ENCODING_ERR | 5 | 인코딩이 유효하지 않거나 지원되지 않습니다. |
NO_MODIFICATION_ALLOWED_ERR | 6 | 대상이 수정될 수 없습니다. |
INVALID_STATE_ERR | 7 | 작업을 수행할 수 없는 객체의 상태입니다. |
SYNTAX_ERR | 8 | 경로 또는 입력 구문이 유효하지 않습니다. |
INVALID_MODIFICATION_ERR | 9 | 대상에 대한 요청된 변경이 유효하지 않습니다. |
QUOTA_EXCEEDED_ERR | 10 | 저장 공간 할당량이 초과되었습니다. |
TYPE_MISMATCH_ERR | 11 | 값의 유형이 예상한 유형과 일치하지 않습니다. |
PATH_EXISTS_ERR | 12 | 목적지 경로가 이미 존재합니다. |
실질적인 진실의 원천
“실질적인 진실의 원천”이라는 제목의 섹션이 참조는 __CAPGO_KEEP_0__에서同步됩니다. src/definitions.ts 에서 capacitor-파일.
capgo/capacitor-파일에서 계속 진행하세요.
“capgo/capacitor-파일에서 계속 진행하세요.”라는 제목의 섹션Capgo를 사용하여 저장소 및 파일 처리를 계획하고 있다면 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-파일을 연결하세요. capgo/capacitor-파일 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-파일을 사용하여 저장소 및 파일 처리를 계획하고 있다면 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-파일을 연결하세요. Using @capgo/capacitor-파일 for the native capability in Using @capgo/capacitor-file, @capgo/capacitor-데이터 저장소-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, Using @capgo/capacitor-데이터 저장소-sqlite for the native capability in Using @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-업로더 for the implementation detail in @capgo/capacitor-uploader, and Using @capgo/capacitor-업로더 for the native capability in Using @capgo/capacitor-uploader.