ShareExtManager

Hilfe

Alles, was du brauchst, um ShareExtManager einzurichten, und was dein Server von der App erhält.

Erste Schritte

  1. Öffne ShareExtManager und tippe oben rechts auf +.
  2. Trage Name und Adresse deines Servers ein, wähle die Art und die Anmeldung, und tippe auf Sichern.
  3. Tippe im Formular auf Testdatei senden. Wenn die Meldung „Die Testdatei ist angekommen“ erscheint, ist das Ziel bereit.
  4. Teile jetzt eine Datei, zum Beispiel ein Foto aus Fotos, und wähle ShareExtManager.

Ein Ziel anlegen

FeldBedeutung
ArtHTTP/HTTPS sendet an eine Adresse, die du festlegst. WebDAV sendet an einen Ordner: Die App hängt den Dateinamen an die Adresse an und sendet die Datei mit PUT.
NameSo heißt das Ziel in der Liste und im Teilen-Dialog.
URLDie Adresse, mit http:// oder https://, bei WebDAV die des Ordners. Beispiel: https://server.example/upload
HTTP-MethodePOST oder PUT (nur bei HTTP/HTTPS).
HTTP-BodyFormular (Multipart): Die Datei steckt in einem Teil eines Formulars (multipart/form-data, RFC 7578), wie bei einem Webformular. Die Datei selbst: Die Datei ist der gesamte HTTP-Body.
Name des TeilsNur bei Multipart. Die App gibt dem Teil, das die Datei enthält, diesen Namen (name). Dein Server muss denselben Namen erwarten. Meist file.
AnmeldungKeine, Benutzername und Passwort (HTTP Basic) oder Bearer-Token. Das Passwort bzw. der Token liegt im Schlüsselbund deines Geräts. Mit dem Schalter Nur auf diesem Gerät behalten kommt es in kein Geräte-Backup; nach einem Gerätewechsel gibst du es dann neu ein.
HeaderZusätzliche HTTP-Header, die bei jedem Upload mitgehen, zum Beispiel X-Folder: inbox. Content-Type und Content-Length setzt die App selbst. Lege hier keine Passwörter ab: Header werden unverschlüsselt gespeichert, nutze die Anmeldung.
Im Teilen-Dialog anzeigen„Für jede Datei anbieten“ oder nur für Bilder, PDF, Filme, Audio oder andere Dateien. Der Dialog zeigt nur Ziele, die alle geteilten Dateien annehmen.
AktivEin ausgeschaltetes Ziel bleibt gespeichert, erscheint aber nicht im Teilen-Dialog.

Über den Feldern erklärt die App kurz, was sie bedeuten. Unten im Formular zeigt Was der Server erhält ein Beispiel der echten Anfrage, aus deinen Eingaben gebaut.

Testdatei senden

Der Knopf sendet die Datei test.txt mit dem Inhalt Hello World genau so, wie später deine Dateien gehen: mit der HTTP-Methode, dem HTTP-Body, dem Teilnamen, den Headern und der Anmeldung aus dem Formular. Kommt sie an, kommen deine Dateien auch an.

Wichtig: Die Testdatei bleibt auf dem Server liegen. Bei WebDAV wird eine vorhandene test.txt überschrieben.

Teilen

Verlauf

Der Tab Verlauf zeigt pro Teilen-Vorgang eine Zeile mit Ziel, Zeit und Anzahl der Dateien. Ein Symbol sagt, ob alles angekommen ist (Haken) oder eine Datei fehlgeschlagen ist (Warnzeichen). Tippe auf die Zeile, um die einzelnen Dateien mit Größe und Fehlertext zu sehen. Wische eine Zeile nach links, um sie zu löschen, oder tippe oben auf Löschen für den ganzen Verlauf. Im Menü oben kannst du nach Ziel filtern und nach Tag oder Ziel gruppieren. Es werden höchstens 200 Einträge gespeichert, nur auf deinem Gerät.

Für Server-Entwickler: Was dein Server erhält

Pro Datei eine Anfrage. Dazu kommen die Anmeldung (Authorization: Basic … oder Bearer …) und die Header aus dem Formular.

ArtDateiDateinameDateityp
HTTP/HTTPS, Multipartim Teil mit dem eingestellten Namenfilename des TeilsContent-Type des Teils
HTTP/HTTPS, Datei selbstganzer HTTP-BodyHeader Content-Disposition: attachment; filename="…" (RFC 6266)Content-Type der Anfrage
WebDAVganzer HTTP-Bodyletzter Teil der URLContent-Type der Anfrage

Bei Namen mit Anführungszeichen, Backslash oder Zeilenumbruch steht der Name in filename sicher kodiert (%22 für ein Anführungszeichen) und zusätzlich exakt in filename*=UTF-8''….

Multipart

POST /upload HTTP/1.1
Host: server.example
Authorization: Basic <Base64 aus Benutzername:Passwort>
Content-Type: multipart/form-data; boundary=Boundary-1234

--Boundary-1234
Content-Disposition: form-data; name="file"; filename="Bericht.pdf"
Content-Type: application/pdf

…Bytes der Datei…
--Boundary-1234--

Die Datei selbst als Body

POST /upload HTTP/1.1
Host: server.example
Content-Type: application/pdf
Content-Disposition: attachment; filename="Bericht.pdf"

…Bytes der Datei…

WebDAV

PUT /dav/inbox/Bericht.pdf HTTP/1.1
Host: server.example
Content-Type: application/pdf

…Bytes der Datei…

iOS ergänzt von sich aus Header wie User-Agent, Accept-Language, Accept-Encoding und Content-Length sowie Upload-Complete und Upload-Draft-Interop-Version (Entwurf für fortsetzbare Uploads). Ein Server ohne Kenntnis davon ignoriert sie.

Als Antwort erwartet die App einen Status 2xx (zum Beispiel 200, 201 oder 204). Alles andere meldet sie als Fehler.

Fehlermeldungen

MeldungWas es bedeutet
Die Testdatei ist angekommen / HochgeladenDer Server hat mit 2xx geantwortet.
Anmeldung abgelehnt (401, 403)Der Server ist erreichbar, nimmt Benutzername, Passwort oder Token aber nicht an. Prüfe die Anmeldung im Ziel.
404: Adresse nicht gefundenDer Server kennt den Pfad nicht. Prüfe die URL, auch ob der Port mit einem Doppelpunkt abgetrennt ist (:8080, nicht .8080).
405: Methode nicht erlaubtDer Server nimmt die gewählte HTTP-Methode hier nicht an. Wechsle zwischen POST und PUT.
Server hat die Testdatei abgelehntDer Server ist erreichbar, lehnt die Datei aber ab (zum Beispiel wegen des Typs, der Größe oder eines fehlenden Felds). Die Meldung zeigt den Anfang seiner Antwort.
Der Server meldet einen Fehler (5xx)Das Problem liegt beim Server.
Der Server ist nicht erreichbarKeine Verbindung. Prüfe Netz und Adresse. Bei Adressen im lokalen Netz muss in den iOS-Einstellungen unter Datenschutz & Sicherheit ▸ Lokales Netzwerk der Zugriff für ShareExtManager erlaubt sein. Eine http://-Adresse funktioniert nur im lokalen Netz; für Server im Internet nimm https://.