개요
“개요” 섹션@capgo/capacitor-uploader 대용량 파일을 기기 밖으로 이동합니다 네이티브 백그라운드 업로드 iOS 및 Android에서 사용할 수 있습니다. 진행 상황과 완료는 플러그인 이벤트로 전달되므로, 업로드가 계속되는 동안 UI를 분리할 수 있습니다. WebView에서 파일 전체를 버퍼링하는 대신 카메라 캡처나 파일 시스템 경로와 함께 사용하세요.
주요 사용 사례: 사진 또는 비디오 백업, presigned S3 업로드, 메타데이터 필드가 포함된 multipart form 전송, 그리고 maxRetries.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 백그라운드 업로드 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 백그라운드 URLSession |
| Android | 지원 | 업로드 중 포그라운드 서비스 스타일 알림 |
| 웹 | 페이지가 열려 있는 동안 | fetch 기반이며, 네이티브 백그라운드 지속 기능은 없음 |
Web에서도 IndexedDB 스타일 경로를 지원합니다: idb://[database]/[collection]/[key].
핵심 기능
“핵심 기능” 섹션startUpload- 서버로 파일 업로드 시작removeUpload- 진행 중인 업로드 취소 및 제거
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
startUpload | 서버로 파일 업로드를 시작합니다. |
removeUpload | 진행 중인 업로드를 취소하고 제거합니다. |
addListener | 업로드 진행 상황 및 상태 이벤트를 수신합니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-uploader.
@capgo/capacitor-uploader에서 계속하기
@capgo/capacitor-uploader에서 계속하기사용 중이라면 @capgo/capacitor-uploader 저장 공간과 파일 처리를 계획하려면, 다음 항목과 연결하세요 @capgo/capacitor-uploader 사용하기 @capgo/capacitor-uploader를 사용할 때 네이티브 기능을 위해, @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite의 구현 세부 사항은, @capgo/capacitor-data-storage-sqlite 사용하기 @capgo/capacitor-data-storage-sqlite 사용 시 네이티브 기능을 위해, @capgo/capacitor-file @capgo/capacitor-file의 구현 세부 사항을 위해, 그리고 @capgo/capacitor-file 사용하기 @capgo/capacitor-file. 사용 시 네이티브 기능을 위해
