So prüfen Sie ein Projekt und beheben Probleme
Ob eine Projektdatei gültig ist, entscheidet der Starter, der sie später beim Benutzer ausführt. Der
Bootstrapper Manager fragt deshalb ihn (/check) und hält keine eigenen Regeln, die von denen des Starters
abweichen könnten. Der Befehl Prüfen auf der Seite Projekte oder Probleme lässt den Starter
das gewählte Projekt prüfen. Jedes Problem, das der Starter meldet, führt der Bootstrapper Manager an die
Stelle, an der Sie es beheben: auf die Seite, an das Feld oder die Zeile.
Projekt prüfen und Probleme beheben
Vorgehen:
- Wählen Sie auf der Seite Projekte den Befehl Prüfen (Alt+P). Geprüft wird der Stand im Bootstrapper Manager, einschließlich ungespeicherter Änderungen; der Bootstrapper Manager übergibt ihn dem Starter als temporäre Datei. Die Projektdatei selbst bleibt dabei unverändert.
Ohne Probleme meldet eine Benachrichtigung „Der Starter meldet keine Probleme.“ Sonst öffnet sich die Seite Probleme:
Spalte Inhalt Bereich Die Seite, auf der das Problem behoben wird Problem Der Text des Starters, wie er ihn meldet (englisch). Er beginnt mit dem Teil der Projektdatei, etwa files 'App\Kasse.exe': ...oderstart.runtime ...Doppelklicken Sie auf ein Problem, oder markieren Sie es und wählen Sie Zur Seite (ohne markierte Zeile ist der Befehl nicht verfügbar). Der Bootstrapper Manager öffnet die Seite und zeigt das betroffene Feld bzw. die betroffene Zeile an; die Stelle ist rot markiert.
- Korrigieren Sie den Wert. Die rote Markierung verschwindet sofort, und das Problem entfällt auf der Seite Probleme und in der Zahl an Probleme, weil der Starter den neuen Wert noch nicht beurteilt hat.
- Wählen Sie erneut Prüfen, oder speichern Sie mit Strg+S; beim Speichern prüft der Starter mit. Eine Benachrichtigung sagt, ob Probleme bleiben.
Ergebnis: Sind alle Probleme behoben, verschwindet die Zahl an Probleme in der Navigation, und die Benachrichtigung meldet keine Probleme.
Kontrolle: Wählen Sie Probelauf. Prüfen beurteilt nur die Projektdatei; ob der Lieferordner
erreichbar ist und alles enthält, was die Liste Dateien nennt, zeigt erst der Probelauf (Ergebnis
0 Ok); siehe
So testen Sie ein Projekt vorab und erstellen das MSI-Paket.
Wie der Bootstrapper Manager die Stelle findet
Der Starter beginnt jedes Problem mit dem Teil der Projektdatei, den es betrifft, und nennt bei einem
Listeneintrag dessen Namen – etwa registry 'Software\Muster\Kasse' value 'Port': DWord needs a number.
Daraus liest der Bootstrapper Manager Seite, Feld und Zeile. Ein Problem, dessen Wortlaut er nicht erkennt,
bleibt ohne Markierung; das gilt auch für Meldungen des Bootstrapper Managers selbst wie „Der Starter wurde
nicht gefunden (…).“ Nennt das Problem keinen bekannten Teil der Projektdatei, ist Zur Seite nicht
verfügbar; sonst öffnet Zur Seite die passende Seite ohne Markierung.
Technische Einzelheiten
- Das Ergebnis gilt bis zur nächsten Prüfung. Die Zeilen auf Probleme und die Zahl in der Navigation bleiben, bis Sie erneut prüfen, speichern oder das Projekt neu lesen. Nur die Probleme eines Felds oder einer Zeile, die Sie ändern, entfallen sofort (Schritt 4). Der Untertitel nennt die Uhrzeit der Prüfung. In die Projektdatei kommt das Ergebnis nie.
- Kein Starter, keine Prüfung: Findet der Bootstrapper Manager den Starter nicht, meldet Prüfen das als Problem. Siehe So richten Sie den Bootstrapper Manager ein und starten ihn, Schritt 3.
- Englische Texte: Der Starter meldet Prüfprobleme auf Englisch, damit sie sich eindeutig einer Stelle der Datei zuordnen lassen, unabhängig von der Sprache der Oberfläche. Seine Fehlercodes beim Benutzer beschreibt Fehlercodes des Starters (Dokumentation von WKL Bootstrapper).
Verwandte Themen
- Was der Starter schreibt und meldet (Dokumentation von WKL Bootstrapper)