Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zu QuartzControl in der Fassung 1.1.0 und erklärt jeden seiner Bildschirme; jeder Bildschirm verweist auf seine Seite hier.

Wie man Notizen schreibt, damit daraus gute Seiten werden, steht im Example-Handbuch.

1.3 – Installieren und erster Start

Woher QuartzControl kommt

Fertig gebaut von der Releases-Seite — welche Form zu welchem System gehört und was macOS beim ersten Start in den Weg legt, steht unter Beziehen und aktualisieren.

Quartz selbst muss nicht installiert werden, und Node auch nicht: Beides bringt QuartzControl mit. Warum, steht unten.

Was beim ersten Start passiert

Es öffnet sich die Startseite mit einer leeren Projektliste. Rechts daneben — auf schmalen Fenstern darunter — steht, was QuartzControl über den Rechner weiß.

QuartzControl prüft drei Werkzeuge, indem sie jedes nach seiner Version fragt: node, npm und git. Die Antwort steht als Zeile auf der Startseite, jeweils mit der Quelle:

  • „in QuartzControl“ — das mitgelieferte. Node und npm reisen immer mit; git nur, wenn auf dem Rechner keines gefunden wurde.
  • „vom System“ — das des Rechners. Bei git ist das der Normalfall und ausdrücklich gewollt: Damit gelten die eigene .gitconfig und die eigenen Zugangshelfer weiter.

Antwortet eines der drei nicht, erscheint oben ein Warnband. Es nennt die Werkzeuge beim Namen und sagt, was ohne sie nicht geht: Builds, neue Projekte, Plugins aus einer git-Quelle und Snapshots. Weil node und npm zu QuartzControl gehören, heißt ein Warnband über sie immer dasselbe — diese Installation ist unvollständig, und am schnellsten hilft, QuartzControl neu zu installieren. „Erneut prüfen“ misst nach, ohne das Programm neu zu starten.

Wo die Zugangsdaten liegen

Unter der Werkzeugzeile steht ein Satz über den Schlüsselbund. Er beantwortet die Frage, ob Passwörter und Token verschlüsselt abgelegt werden können.

Unter macOS ist das immer der Fall — nach jedem Update fragt macOS aber beim ersten Zugriff, ob diese Fassung den Schlüsselbund benutzen darf, meist zweimal. Mit Immer erlauben antworten; wer ablehnt, bekommt überall dort, wo ein Passwort gebraucht wird, genau das gesagt, und ein Neustart stellt die Frage erneut. Unter Linux hängt es davon ab, ob ein Schlüsselbund läuft: Ohne gnome-keyring oder KWallet steht keine Verschlüsselung zur Verfügung, und dann lassen sich Zugänge mit Passwort oder Token gar nicht erst speichern. QuartzControl sagt das in einem eigenen Kasten und nennt dort auch, was hilft. Nichts landet dabei unverschlüsselt auf der Platte — es wird lieber nichts gespeichert als etwas Ungeschütztes.

„Kann nicht prüfen“ ist nicht „alles gut“

Das gilt an vielen Stellen in QuartzControl und zum ersten Mal hier: Wenn etwas sich nicht feststellen lässt, sagt QuartzControl das, statt Entwarnung zu geben. Ein Katalog, der nicht geladen werden konnte, ist nicht leer. Eine Version, die nicht ermittelt werden konnte, ist nicht die neueste.