Kommandozeile

Das updateSystem.NET stellt Ihnen zum Verwalten Ihrer Updates neben dem Designer auch ein Kommandozeilentool zur Verfügung, mit welchem Sie automatisiert Updatepakete erstellen können.

Wie Funktioniert's?

Die Erstellung der Updatepakete läuft über ein Zwei-Komponenten System. Zum einen über Befehelszeilenparameter welche an die updateSystemDotNet.Designer.commandLine.exe Anwendung übergeben werden und zum anderen über eine XML-Datei welche die näheren Informationen zu dem Updatepaket- sowie die auszuführenden Updateactions enthält.

Verwendung der Kommandozeilenparameter

• /project : Der Pfad zu dem Updateprojekt von welchem eine neue Version erstellt werden soll.
  Beispiel: /project="C: \Users\Max Mustermann\Desktop\meineAnwendnug.udproj"
  
  
• /version : Die neue Version für das Updatepaket. Dazu gibt es folgende Optionen:
  
  • /version=1.2.3.4 Einfache Versionsangabe, nicht sonderlich optimal, da sehr unflexibel
  • /version=increment:major|minor|build|revision Dabei wird das letzte Updatepaket genommen und bei diesem entspechend die Version incrementiert.
  • /version=determineAutomatically Dieses Argument benötigt noch ein zusätzliches Argument:
    
    • /versionSource="C: \Users\Max Mustermann\Desktop\ExeMitVersion.exe"
    
    Mit dieser Option wird die Versionsnummer automatisch aus der in /versionSource angegebenen Exe, Dll (oder was auch immer alles eine Versionsnummer besitzt) ermittelt.
• /description : Die Beschreibung des neuen Updatepaketes.
  Beispiel: /description="Das ist ein Testpaket."
• /updateDefinition : Gibt den Pfad zu der Xml Datei an, welche die Updateinformationen enthält die für dieses Update angewendet werden sollen.
  Beispiel: /updateDefinition="C: \Users\Max Mustermann\Desktop\myDefinition.xml"
  Ein Beispiel der Updatedefinitionsdatei finden Sie im Programmverzeichnis des updateSystem.Net unter dem Namen updateDefinitionTemplate.xml.
• /changelogType : Das commandLine Utility Unterstützt von Haus aus den Import von Changelogs im Xmlformat. Dazu muss als Wert für diesen Parameter "xml" angegeben werden. Nutzen Sie ein eigenes Format, müssen Sie ein ChangelogImport-Plugin schreiben, und dann dessen PluginId (GUID) als Wert für diesen Parameter angeben.
  
  • Beispiel für den Built-In Xml Import: /changelogType=xml
    Ein Beispiel des Aufbau's der Xml Datei des Changelogs finden Sie im Programmverzeichnis des updateSystem.Net unter dem Namen changelogTemplate.xml.
  • Beispiel für ein Import-Plugin: /changelogType=DDD93619-FC1E-46df-BF24-05CB294D2976
  
  
  
• /changelogSource : Gibt den Pfad zu der Datei an, welche den Changelog beinhaltet.
  Beispiel: /changelogSource="C: \Users\Max Mustermann\Desktop\myChangelog.xml"