Capacitor 파일 플러그인은 Cordova File 플러그인과 같은 파일 시스템 연산을 구현합니다.
핵심 기능
‘핵심 기능’이라는 제목을 가진 섹션requestFileSystem- 파일 시스템을 요청합니다.resolveLocalFileSystemURL- 파일 URL을 엔트리로 해결합니다.getFile- 파일 엔트리를 가져옵니다.getDirectory- 디렉토리 엔트리를 가져옵니다.
Public API
Public API| 메서드 | 설명 |
|---|---|
requestFileSystem | 파일 시스템을 요청합니다. |
resolveLocalFileSystemURL | 파일 URL을 엔트리로 해결합니다. |
getFile | 파일 엔트리를 가져옵니다. |
getDirectory | 디렉토리 엔트리를 가져옵니다. |
readFile | 파일을 텍스트 또는 base64로 읽습니다. |
readAsDataURL | MIME 타입 접두사와 함께 base64를 사용하여 파일을 읽습니다. |
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 | Android에서 앱 파일 디렉토리로 매핑되는 사용자에게 보이는 영구 문서를 찾을 수 있습니다. |
DATA | 사용자가 보이지 않는 영구 앱 데이터입니다. |
LIBRARY | 사용자가 보이지 않는 영구 앱 데이터입니다. Android에서 앱 파일 디렉토리로 매핑됩니다. |
CACHE | OS가 삭제할 수 있는 임시 캐시 데이터입니다. |
EXTERNAL | Android 외부 저장소의 기본 루트, 예를 들어 SD 카드 또는 공유 외부 저장소입니다. |
EXTERNAL_STORAGE | Android 외부 저장소 데이터 디렉토리. |
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_KEEP_0__/__CAPGO_KEEP_1__-파일을 사용하여 저장소와 파일 처리를 계획하고 있다면 capgo/capacitor-파일 저장소와 파일 처리를 계획하고 있는 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-파일을 연결하세요. capgo/capacitor-파일을 사용하여 native 기능을 위해 capgo/capacitor-파일을 사용합니다. capgo/capacitor-데이터 저장소 SQLite implementation detail을 위해 capgo/capacitor-데이터 저장소 SQLite를 사용합니다. capgo/capacitor-데이터 저장소 SQLite를 사용하여 native 기능을 위해 capgo/capacitor-데이터 저장소 SQLite를 사용합니다. capgo/capacitor-업로더 implementation detail을 위해 capgo/capacitor-업로더를 사용하고 capgo/capacitor-업로더를 사용하여 native 기능을 위해 capgo/capacitor-업로더를 사용합니다.