Hilfe
Alles, was du brauchst, um ShareExtManager einzurichten, und was dein Server von der App erhält.
Erste Schritte
- Öffne ShareExtManager und tippe oben rechts auf +.
- Trage Name und Adresse deines Servers ein, wähle die Art und die Anmeldung, und tippe auf Sichern.
- Tippe im Formular auf Testdatei senden. Wenn die Meldung „Die Testdatei ist angekommen“ erscheint, ist das Ziel bereit.
- Teile jetzt eine Datei, zum Beispiel ein Foto aus Fotos, und wähle ShareExtManager.
Ein Ziel anlegen
| Feld | Bedeutung |
|---|---|
| Art | HTTP/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. |
| Name | So heißt das Ziel in der Liste und im Teilen-Dialog. |
| URL | Die Adresse, mit http:// oder https://, bei WebDAV die des Ordners. Beispiel: https://server.example/upload |
| HTTP-Methode | POST oder PUT (nur bei HTTP/HTTPS). |
| HTTP-Body | Formular (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 Teils | Nur bei Multipart. Die App gibt dem Teil, das die Datei enthält, diesen Namen (name). Dein Server muss denselben Namen erwarten. Meist file. |
| Anmeldung | Keine, 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. |
| Header | Zusä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. |
| Aktiv | Ein 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
- ShareExtManager erscheint im Teilen-Menü von Apps, die eine Datei übergeben, zum Beispiel Fotos oder die Druckvorschau („Als PDF sichern“).
- In Safari bietet die App sich für eine normale Webseite nicht an, denn sie liefert nur einen Link. Tippe im Teilen-Menü auf Optionen und wähle PDF. Dann wird die Seite als PDF geteilt.
- Fehlt ShareExtManager in der Liste der Apps, scrolle in der obersten Reihe ganz nach rechts, tippe auf Mehr und schalte die App ein.
- Mehrere Dateien gehen nacheinander an dasselbe Ziel. Während des Sendens zeigt der Dialog den Fortschritt.
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.
| Art | Datei | Dateiname | Dateityp |
|---|---|---|---|
| HTTP/HTTPS, Multipart | im Teil mit dem eingestellten Namen | filename des Teils | Content-Type des Teils |
| HTTP/HTTPS, Datei selbst | ganzer HTTP-Body | Header Content-Disposition: attachment; filename="…" (RFC 6266) | Content-Type der Anfrage |
| WebDAV | ganzer HTTP-Body | letzter Teil der URL | Content-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
| Meldung | Was es bedeutet |
|---|---|
| Die Testdatei ist angekommen / Hochgeladen | Der 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 gefunden | Der Server kennt den Pfad nicht. Prüfe die URL, auch ob der Port mit einem Doppelpunkt abgetrennt ist (:8080, nicht .8080). |
| 405: Methode nicht erlaubt | Der Server nimmt die gewählte HTTP-Methode hier nicht an. Wechsle zwischen POST und PUT. |
| Server hat die Testdatei abgelehnt | Der 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 erreichbar | Keine 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://. |