Tool Lagerverwaltung (Teil 8) Nuget Paket bereit gestellt

Nun habe ich endlich ein Template fertig, auf dem ich das Tool entwickeln kann und auch für andere Anwendungen, die ich noch schreiben werden mit .NET MAUI. Ich konnte mich wieder etwas Geistig Sammeln und jetzt kann der nächste Schritt getätigt werden.

 

Benötigt

Visual Studio 2022 oder Rider 2023.3.3

nuget Account (zum hochladen einges nuget Paket)

 

Frontend und .NET

Das bestehende Projekt soll auf .NET MAUI umgestellt werden und auf .NET 7.

 

Projekt Aktualisieren

Warum nicht .NET 8? Beim versucht auf die aktuelle Version, hatte ich noch Probleme, die ich noch nicht verstanden habe. Zeitlich bin ich allerdings auch nicht dazu gekommen, dies zu ergründen.

 

Fehler entdeckt

Beim Testen mit dem Template traten zunächst keine gleich auffallende Fehler auf. Aber nach dem ich das Template angewendet habe für die Solution des WarehouseManagement, musste ich feststellen, dass der Hover Effekt sich nicht zurück setzt auf den Normal zu stand.

Bevor der Fehler behoben wird

Einerseits habe ich nicht beschrieben, wie die Darstellung eines Buttons sich zeigen soll. Andererseits hat man als Benutzer ein gewisse Erwartung wie verwendbare Buttons reagieren soll oder suggerieren soll, ob der Button in der Auswahl liegt.

Also bevor ich zur Fehlerbehebung gehe, definiere ich die Grafischen Darstellung des Buttons und das Wiki für das Application Framework.

Folgende Zustände für den Button werden beschrieben: Normal, Disabled, Pressed, PointerOver

Die Beschreibung ist technisch und sehr auf die Wesentlichen Inhalt beschrieben.

Fertige Seite: Steuerelemente_ButtonPage · Codexzier/Codexzier.Maui.ApplicationFramework Wiki (github.com)

Was ist nun mit den Zuständen, die nicht definiert sind? Die gehe ich an, wenn weitere Zustände gebraucht werden. Das gilt natürlich auch für andere Steuerelemente.

 

Beben

Zuerst dachte ich, der Fehler wäre simple. Den im Style für Visual State 'Normal' habe ich nicht den BackgroundColor nicht festgelegt. War leider nicht das Problem

Das Problem war mit dem Kompilierten Ergebnis in der Release Version. Nachdem ich das Debug kompilierte variante  hochgeladen habe und das Projekt aktualisierte, funktionierte das zurückstellen der Grundfarbe des Buttons.

Warum hier ein Problem mit Release besteht, werde ich zu einem anderen Zeitpunkt heraus finden müssen.

 

Routine finden

Noch ist das keine Gängiger Vorgang. Im Business habe ich bisher keinen Gängigen Vorgang gefunden oder geschweige, dass Fehler in der Reihenfolge Anforderung prüfen, Dokumentation erweitern und dann erst behoben wird.

Links

• Tool Warehouse Management: Codexzier/WarehouseManagement
• nuget Package: NuGet Gallery | Codexzier.Maui.ApplicationFramework 1.0.1
• Dokumentation: Home · Codexzier/Codexzier.Maui.ApplicationFramework Wiki (github.com)

Tool Lagerverwaltung (Teil 3) Noch eine Wiki anlegen

Diesmal ein kurzer Post zur Vollständigkeit für die weitere Entwicklung. Nun braucht die Anwendung selbst eine eigene Wiki. Anders als bei dem Application Framework, wird die Funktionsweise und Benutzung beschrieben.

 

Benötigt

GitHub

 

Begin mit dem Benutzerhandbuch

Jede erstellte Seite soll eine Beschreibung und mindestens eine Skizze haben. Die Beschreibungen sind zunächst als Grundlage, was die Anwendung alles haben und wie sie funktionieren soll. Hier gehören keine Technischen Hintergründe, denn diese gehören entweder im Code als Kommentar oder im Ticket.

 

Am Anfang ein Konzept

Bevor die Anwendung geschrieben wird, soll mit dem Konzepthandbuch die Nutzeranforderungen ermittelt werden. Wenn später die Inhalte fertig sind, können nach und nach die Konzeptbeschreibung zur Benutzerbeschreibung umgestellt werden.

Nun könnte man sagen, dass Konzept kann man sich sparen und man erstelle die Dokumentation, wenn die Anwendung fertig ist. Wenn eine Planung vorliegt, dann ist das Ziel bekannt. Darauf los zu programmieren, führt eher dazu, dass man sein Ziel vergisst.

Die Konzeptbeschreibung ist auch die Möglichkeit die Nutzeranforderung zu spezifizieren und somit im weiteren daraus die Technischen Anforderungen zu formulieren.

Eigentlich eine einfache Sache und dennoch glauben viele, dass man diesen Schritt sich sparen kann. Doch sparen bedeutet am Ende mehr versteckter Zeitaufwand.

 

Wieder mal das GitHub Wiki

Diesmal wird keine Anleitung hinterlegt, wie die Einzelnen Steuerelemente verwendet werden. Wie bereits im vorigen Absatz, werden soll Beschreibungen angelegt. Damit Bildet sich dann Praktisch eine Vorläufige grobe Anforderung, die verfeinert werden kann.

 

Die Inhaltsangabe dient hier zunächst als grobe Richtung. (Im ersten Teil, ist das Beispiel wie das Menü im Edit aussieht)

 * Was kann die Anwendung  
 * Einleitung  
     * Hintergrund  
 * Start Seite  
     * Grundrahmen  
     * Übersichtsliste  
     * Suche  
 * Vorlage Einstellen  
     * Basisfelder  
     * Optionale Felder  
 * Neue Sache  
     * Vorlage verwenden  
     * Eigene Vorlage verwenden  
 * Sache bearbeiten  
     * Optionale Felder hinzufügen  
 * Sache archivieren  
     * Sache wiederherstellen  

Inhalt füllen

Im Ersten Teil habe ich bereits beschrieben, was man bereits mit dem Wiki erzeugen kann und deshalb geht es hier einen Schritt weiter voran mit dem erzeugen der Seite für die 'Start Seite' der Anwendung. Auf der neuen Seite, kommt zu der Textform auch Bilder. Mit diesen wenigen Details, lassen sich im Anschluss bereits die ersten Technischen Anforderungen ableiten.

 

 

Bisher noch nicht erwähnt, hatte ich das Tool Pencil. Neben Ablauf Diagrammen, können Skizzenhaft die Programmoberfläche Gestaltet werden.

 

Nächster Ansatz

Damit ist der nächste Ansatz getan. Aber bevor ich mit den weiteren Teilen der Anwendung weiter schreibe, geht es mit einer Technische Komponente weiter.

 

Übersicht

Teil 1 - Wiki anlegen in GitHub

Teil 2 - Neue Solution

Teil 3 - Noch eine Wiki anlegen

Teil 4 - Datenbank und Schnittstelle

Teil 5 - Konzept ausschreiben

Teil 6 - Umzug nach .NET MAUI