Übersicht
Abschnitt: „Übersicht“@capgo/capacitor-uploader verschiebt große Dateien vom Gerät mithilfe von Native Background-Uploads auf iOS und Android. Fortschritt und Abschluss werden über Plugin-Events gemeldet, sodass deine UI entkoppelt werden kann, während der Upload weiterläuft. Nutze es direkt mit der Kamera oder Filesystem-Pfaden, statt ganze Dateien im WebView zu puffern.
Typische Anwendungsfälle: Foto- oder Video-Backups, presigned S3-Uploads, Multipart-Form-Posts mit Metadaten sowie resiliente Retries via maxRetries.
Plattformunterstützung
Abschnitt mit dem Titel „Plattformunterstützung“| Plattform | Background-Upload | Notizen |
|---|---|---|
| iOS | Ja | Background URLSession |
| Android | Ja | Foreground-Service-Benachrichtigung während des Uploads |
| Web | Solange die Seite offen ist | fetch basiert, keine native Hintergrundfortsetzung |
Web unterstützt auch IndexedDB-Style-Pfade: idb://[database]/[collection]/[key].
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“startUpload- Datei-Upload auf einen Server starten.removeUpload- Laufenden Upload abbrechen und entfernen.
Öffentliches API
Abschnitt mit dem Titel „Öffentliche API“| Methode | Beschreibung |
|---|---|
startUpload | Einen Datei-Upload auf einen Server starten. |
removeUpload | Einen laufenden Upload abbrechen und entfernen. |
addListener | Upload-Fortschritts- und Status-Events abonnieren. |
getPluginVersion | Die native Capacitor Plugin-Version abrufen. |
Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-uploader.
Weiter mit @capgo/capacitor-uploader
Abschnitt mit dem Titel „Weiter mit @capgo/capacitor-uploader“Wenn du es nutzt @capgo/capacitor-uploader um Speicher- und Dateiverwaltung zu planen, verbinde es mit Mit @capgo/capacitor-uploader für die native Funktionalität bei der Nutzung von @capgo/capacitor-uploader, @capgo/capacitor-data-storage-sqlite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite, Mit @capgo/capacitor-data-storage-sqlite für die native Funktionalität in „@capgo/capacitor-data-storage-sqlite verwenden“, @capgo/capacitor-file für das Implementierungsdetail in @capgo/capacitor-file und @capgo/capacitor-file verwenden für die native Funktion bei der Nutzung von @capgo/capacitor-file.