Artefakt Toolbox
Deutsch

Worauf du achten solltest

Diese Regeln entscheiden, ob ein Tool auf dem Handy zuverlässig läuft. Dazu kommen Erfahrungen aus dem Bau der Galerie-Tools.

Die Grundregeln

  1. Alles in eine Datei

    Bilder als SVG im Code oder als Daten-Link einbetten, keine fremden Schriften, Bibliotheken direkt in die Datei kopieren statt per Link einzubinden. Sonst bleibt das Tool offline leer.

  2. Zuerst das Handy

    Setze <meta name="viewport" content="width=device-width, initial-scale=1">. Tippflächen mindestens 48 px hoch, Schrift mindestens 16 px, keine Funktion, die nur mit Hover (Mauszeiger) geht.

  3. Daten bewusst speichern

    Lege Werte in localStorage ab und speichere nach jeder Änderung. Lege nichts Wichtiges nur im Arbeitsspeicher ab: Es ist weg, sobald das Tool schließt.

  4. Gut lesbar

    Hoher Kontrast, klare Beschriftungen, kein Text unter 14 px. Wenn das Tool zur Toolbox passen soll: dunkler Hintergrund, helle Schrift, ein Akzent in Bernstein.

  5. Keine Geheimnisse im Code

    Eine Tool-Datei ist lesbarer Text. Wer sie bekommt, sieht alles darin. Gib keine Passwörter, Schlüssel oder privaten Daten in die Datei, bevor du sie weitergibst.

  6. Fremden Tools nicht blind vertrauen

    Die Abschottung ist ein Schutz, aber kein Freifahrtschein. Prüfe, woher ein Tool kommt, und schalte erweiterte Erlaubnisse nur ein, wenn du es wirklich brauchst.

  7. Zuerst testen

    Öffne neuen Code im Editor und schau ihn dir in der Vorschau an. Probiere die wichtigsten Wege aus, auch ungewöhnliche Eingaben.

  8. Versionen nutzen

    Behalte den Namen bei, dann wird die neue Datei zur neuen Version. Die letzten drei Fassungen kannst du zurückholen, wenn eine Änderung etwas kaputt macht.

Lehren aus dem Bau der Galerie

Beim Bau des gemeinsamen Bausatzes für die Galerie-Tools sind uns einige Stolpersteine begegnet, die fast jedes Tool betreffen. Diese Lösungen gelten für deine Tools genauso.

Stolperstein und Lösung
ThemaWas passiertSo machst du es richtig
Timer im HintergrundLäuft ein Tool im Hintergrund oder ist der Bildschirm aus, drosselt das Handy setInterval. Mitgezählte Sekunden gehen dann nach.Startzeit merken (Date.now()) und die Restzeit bei jedem Takt daraus berechnen, statt Sekunden mitzuzählen.
Sortieren per ZiehenZiehen und Ablegen (HTML5 drag and drop) funktioniert auf Android-Touch nicht.Knöpfe „hoch“ und „runter“ je Eintrag anbieten.
Bilder im BackupBilder als Blob oder Object-URL landen nicht im Backup der Toolbox.Bilder verkleinern (zum Beispiel höchstens 512 px, JPEG) und als Daten-Link speichern.
Speicher voll oder gesperrtlocalStorage kann voll sein oder fehlen. Ohne Absicherung bricht das Tool mit einem Fehler ab.Jeden Zugriff in try/catch setzen, auf den Arbeitsspeicher zurückfallen und einen Hinweis zeigen, dass gerade nicht gespeichert wird.
Neue Fassung, alte DatenNach einem Umbau passen gespeicherte Daten nicht mehr zum Code.Daten mit Versionsnummer speichern ({ v: 2, daten }) und alte Fassungen beim Laden umziehen.
Zahlen und DatenSelbstgebaute Formate sind in anderen Sprachen falsch (Komma, Datum, Mehrzahl).Intl nutzen: NumberFormat, DateTimeFormat, PluralRules und RelativeTimeFormat. Das ist im Browser eingebaut und läuft offline.
Rückfragen nervenStändige „Wirklich löschen?“-Fragen werden weggeklickt und schützen dann nicht mehr.Sofort ausführen und zehn Sekunden lang „Rückgängig“ anbieten. Nur das Löschen ganzer Bestände fragt vorher.
alert und confirmDiese Fenster blockieren das Tool und sehen auf jedem Gerät anders aus.Eigene Dialoge bauen, die mit Esc schließen und den Fokus zurückgeben.
Ton auf dem HandyTöne starten erst nach einer Berührung. Ein Timer, der von selbst piept, bleibt sonst stumm.Den Ton (AudioContext) beim ersten Tippen auf „Start“ vorbereiten.
Bildschirm geht ausBei Timern, Noten oder Rezepten wird das Display dunkel.Wachhalten anfragen (navigator.wakeLock) und eine Ablehnung ohne Fehler hinnehmen.
Code verkleinernVerkleinerter Code ist für dich und für „Mit KI ändern“ kaum noch lesbar.Code lesbar lassen. Eine Datei mit rund 60 bis 90 KB ist kein Problem.

Siehe auch: Bauplan der Galerie · Wenn etwas nicht klappt