Teilen-Weg repariert, Zwischenablage nativ, Sprung in den Tankvorgang (2026.9.2.24/.25)

BEFUND. Die Uebergabe der Teilen-Erweiterung an die App konnte nie
funktionieren: sie legte den Beleg im Gruppen-Container ab, die App suchte ihn
ueber @capacitor/preferences - und dessen iOS-Code liest IMMER
UserDefaults.standard der App, configure({group}) setzt nur ein
Schluessel-Praefix. Falscher Behaelter, falscher Schluessel, und weil ein
fehlender Eintrag der Normalfall ist, meldete nichts einen Fehler.

UMBAU. Die Erweiterung schreibt das PDF als Datei in den Gruppen-Container und
gibt den Pfad im Aufruf mit; die App liest ihn ueber @capacitor/filesystem
(volle file://-Pfade) und loescht ihn danach. Abgeholt ueber getLaunchUrl()
und appUrlOpen - iOS benutzt beide. Nebenbei entfallen die
Base64-Aufblaehung und die 4-MB-Grenze der UserDefaults.

ZWEI WEITERE FEHLER AUF DEMSELBEN WEG. Ein Beleg zu einem bestehenden
Tankvorgang lief in die 20-Sekunden-Frist, obwohl der Server laengst fertig
war. Und beim Duplikat verriet das Backend nicht, welcher Vorgang gemeint ist
- jetzt kommt vorhandener_tank_id mit, und beide Oberflaechen springen
dorthin. Dazu: nach dem Speichern oeffnet sich der neue Vorgang, und waehrend
gelesen wird, steht "Tankbeleg wird verarbeitet ..." mit Zapfsaeule und
Kreisel im Formular.

ZWISCHENABLAGE. navigator.clipboard.read() gibt nur Text, HTML und Bilder
heraus - ein kopiertes PDF ist dort nie zu bekommen. UIPasteboard kennt die
Grenze nicht: ein kleines eigenes Plugin holt es, auch aus Mail (Anhang als
Verweis, ueber pasteboard.urls mit Sicherheitsbereich).

Der native Teil braucht einen Mac-Lauf; ios-teilen-einrichten.mjs spielt beide
Swift-Dateien bei jedem Bau ein.

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-09-02 22:12:34 +02:00
co-authored by Claude Opus 5
parent 36a6c21bfd
commit 8c95e50554
15 changed files with 552 additions and 182 deletions
@@ -11,24 +11,28 @@
// Sie kann der App nichts direkt geben; der einzige gemeinsame Boden ist
// eine App-Gruppe. Der Weg hier:
//
// 1. Das PDF wird gelesen und Base64-kodiert.
// 2. Es landet zusammen mit seinem Namen in den geteilten
// UserDefaults der Gruppe `group.app.datametric360`.
// 3. Die Erweiterung öffnet die App über ihr eigenes URL-Schema.
// 4. Die App liest den Eintrag beim Start bzw. beim Zurückkehren aus,
// löscht ihn und lädt den Beleg hoch (daten/geteilterBeleg.ts).
// 1. Das PDF wird in den Container der App-Gruppe geschrieben.
// 2. Die Erweiterung öffnet die App über ihr URL-Schema und gibt den
// Pfad mit: `datametric360://beleg?pfad=<file://>`.
// 3. Die App liest die Datei über @capacitor/filesystem (das volle
// file://-Pfade ausdrücklich unterstützt) und löscht sie danach.
//
// Base64 in UserDefaults statt einer Datei im Gruppen-Container: die App
// liest UserDefaults ohnehin schon über @capacitor/preferences, das genau
// diese Gruppe kennt. Eine Datei im Container bräuchte dagegen eigenen
// nativen Code auf der App-Seite ein zusätzliches Plugin für einen Weg,
// den es sonst nicht gäbe.
// DER ERSTE ENTWURF GING ÜBER USERDEFAULTS UND HAT NIE FUNKTIONIERT.
// Er legte das PDF base64-kodiert unter `dm360_geteilter_beleg` in
// `UserDefaults(suiteName: gruppe)` ab, weil die App UserDefaults über
// @capacitor/preferences ohnehin liest. Nur liest dieses Plugin (8.0.1,
// ios/Sources/PreferencesPlugin/Preferences.swift) IMMER
// `UserDefaults.standard` der App `configure({ group })` wechselt nicht
// den Container, sondern setzt nur ein Schlüssel-Präfix. Die App suchte
// also `group.app.datametric360.dm360_geteilter_beleg` in ihrem eigenen
// Bereich, während hier der plain Schlüssel im Gruppen-Container lag:
// falscher Behälter und falscher Schlüssel. Gemeldet am 02.09.2026
// (es wird kein Tankvorgang angelegt beim Teilen mit der App).
//
// Der Preis ist eine Größengrenze: UserDefaults ist für Einstellungen
// gedacht, nicht für Anhänge. GRENZE_BYTES hält das bei 4 MB. Ein
// Tankbeleg liegt bei einigen Dutzend Kilobyte, ein gescanntes Mehrseiten-
// PDF kann darüber liegen dann sagt die Erweiterung das und der Weg über
// Datei auswählen" in der App bleibt.
// Die Datei hat zwei weitere Vorteile: keine Base64-Aufblähung um ein
// Drittel, und keine 4-MB-Grenze UserDefaults ist für Einstellungen
// gedacht, nicht für Anhänge. Geblieben ist eine Obergrenze, aber eine
// großzügige (GRENZE_BYTES).
//
// DIESE DATEI IST VERSIONIERT, ios/ NICHT.
// `npx cap add ios` erzeugt den nativen Ordner neu und würde alles darin
@@ -45,13 +49,13 @@ class ShareViewController: UIViewController {
/// Muss zur App-Gruppe in beiden Entitlements-Dateien passen.
private let gruppe = "group.app.datametric360"
/// Schlüssel, unter dem die App den Beleg abholt (geteilterBeleg.ts).
private let schluessel = "dm360_geteilter_beleg"
/// Unterordner im Gruppen-Container, in dem geteilte Belege liegen.
private let ordner = "geteilte-belege"
/// 4 MB. UserDefaults ist kein Dateispeicher darüber wird abgelehnt,
/// statt das System mit einem Anhang zu belasten, für den es nicht
/// gedacht ist.
private let grenzeBytes = 4 * 1024 * 1024
/// 24 MB. Kein technisches Limit mehr, sondern eine Vernunftgrenze:
/// ein Tankbeleg liegt bei einigen Dutzend Kilobyte, alles jenseits
/// davon ist kein Beleg, sondern ein Versehen.
private let grenzeBytes = 24 * 1024 * 1024
override func viewDidLoad() {
super.viewDidLoad()
@@ -102,26 +106,30 @@ class ShareViewController: UIViewController {
}
private func ablegen(daten: Data, name: String) {
guard let ablage = UserDefaults(suiteName: gruppe) else {
guard
let container = FileManager.default.containerURL(
forSecurityApplicationGroupIdentifier: gruppe)
else {
return melden("Die App-Gruppe ist nicht eingerichtet.")
}
// Form wie in geteilterBeleg.ts erwartet. @capacitor/preferences legt
// Werte als String ab, deshalb JSON und kein Dictionary.
let inhalt: [String: Any] = [
"name": name,
"base64": daten.base64EncodedString(),
"zeit": Int(Date().timeIntervalSince1970 * 1000),
]
guard
let json = try? JSONSerialization.data(withJSONObject: inhalt),
let text = String(data: json, encoding: .utf8)
else {
let ziel = container.appendingPathComponent(ordner, isDirectory: true)
// Ein Zeitstempel im Namen: zwei rasch nacheinander geteilte Belege
// sollen sich nicht gegenseitig überschreiben, und der Name bleibt
// für den Nutzer lesbar, falls er den Container je zu sehen bekommt.
let datei = ziel.appendingPathComponent(
"\(Int(Date().timeIntervalSince1970))-\(name)")
do {
try FileManager.default.createDirectory(
at: ziel, withIntermediateDirectories: true)
try daten.write(to: datei, options: .atomic)
} catch {
return melden("Der Beleg ließ sich nicht übergeben.")
}
ablage.set(text, forKey: schluessel)
DispatchQueue.main.async { [weak self] in
self?.appOeffnen()
self?.appOeffnen(pfad: datei)
self?.abschliessen()
}
}
@@ -129,8 +137,15 @@ class ShareViewController: UIViewController {
/// Öffnet die Host-App. Eine Erweiterung darf `UIApplication.shared` nicht
/// benutzen, deshalb der Umweg über die Responder-Kette der einzige von
/// Apple vorgesehene Weg aus einer Erweiterung heraus.
private func appOeffnen() {
guard let ziel = URL(string: "datametric360://beleg") else { return }
private func appOeffnen(pfad: URL) {
// Der Pfad wandert als Abfrageparameter mit. Er zeigt in den
// Gruppen-Container, den die App mit derselben Berechtigung lesen
// darf - kein zusätzliches Plugin nötig.
var bau = URLComponents()
bau.scheme = "datametric360"
bau.host = "beleg"
bau.queryItems = [URLQueryItem(name: "pfad", value: pfad.absoluteString)]
guard let ziel = bau.url else { return }
var antwort: UIResponder? = self
while let r = antwort {
if let app = r as? UIApplication {