Schritt für Schritt Anleitung
Diese Anleitung wird Sie Schritt für Schritt durch das Einrichten eines neuen Updateprojektes, dem hinzufügen des updateSystem.NET zu Ihrem Projekt und dem Erstellen eines ersten Updates führen.
Das updateSystem.NET herunterladen und installieren
Laden Sie sich die aktuelle Version des updateSystem.NET hier herunter und folgen Sie den Anweisungen des Installationsassistenten.
Nach der Installation finden Sie im Startmenu einen neuen Eintrag "updateSystem.NET Administration" über diesen Sie die Administrationsoberfläche starten können.
Ein neues Updateprojekt erstellen
Nachdem Sie die Administration gestartet haben klicken Sie auf der linken Seite auf "Neues Projekt". Dies öffnet einen Assistenten welcher in mehreren Schritten Informationen sammelt die zum Erstellen eines Updateprojektes notwendig sind.
-
Schritt 1: Allgemeine Projektinformationen
Name der Anwendung: Geben Sie hier den Namen Ihrer Anwendung an, dieser erscheint in fast allen Dialogen die der updateController später während der Updatesuche anzeigt.
Update-Url: Dies ist die HTTP-URL über welche die Updates abgerufen werden. Diese muss auf das gleiche Verzeichnis zeigen, welches Sie in Schritt 3 bei Ihren FTP-Serverdaten angegeben haben.
Projektdateiname: Dies ist der vollständige Pfad zu der Projektdatei welche während dem Einrichten erzeugt wird und alle Informationen beinhaltet die benötigt werden um Ihr Updateprojekt öffnen zu können.
-
Schritt 2: Statistiken
Hier können Sie einen Statistikserver festlegen welcher mit Ihrem Projekt verknüpft werden kann, um Daten über die Anzahl von Updateanfragen und Downloads zu erfassen. Diese Einstellung ist optional und wird in dieser Schnellstartanleitung nicht weiter behandelt, weitere Informationen über den Gebrauch der Statistikdienste finden Sie in der Hilfe.
-
Schritt 3: Den FTP-Server konfigurieren
Das updateSystem.NET veröffentlicht die Updatekonfiguration sowie die Updatepakete direkt über FTP.
In diesem Schritt legen Sie nun die Zugangsdaten zu Ihrem FTP-Server sowie das Verzeichnis fest, in welches die Updatedaten hochgeladen werden sollen.
-
Schritt 4:
In diesem Schritt richtet der Assistent alle benötigten Verzeichnisse und Dateien auf Ihrem FTP-Server ein. Nachdem der Vorgang erfolgreich abgeschlossen wurde, öffnet ein Klick auf "Weiter" das neu angelegte Updateprojekt.
Ihr Projekt Updatefähig machen
Nun müssen Sie in Ihrem Projekt ein updateController-Objekt erstellen, um Updates suchen und installieren zu können. Dies geht entweder über den Windows Forms Designer oder per Code.
Das erste Updatepaket erstellen
Öffnen Sie Ihr angelegtes Updateprojekt mit der updateSystem.NET Administration (z.B. über einen Doppelklick auf die Projektdatei). Wechseln Sie in den Tab Updatepakete und wählen Sie Hinzufügen.
Auf der ersten Dialogseite müssen Sie allgemeine Informationen über die Versionsinformationen des neuen Updatepaketes angeben:
-
Version: Dies ist die Versionsnummer die dieses Updatepaket tragen soll, in unserem Beispiel 2.0.0.0.
-
Releasestatus: Hier können Sie einen aus drei verschiedenen Typen (Final, Beta, Alpha) wählen, welcher dem aktuellen Entwicklungsstand Ihres Projektes und den Dateien welche Sie über das Update ausliefern möchten am besten entspricht.
Entscheiden Sie sich für Beta oder Alpha können Sie neben der Auswahlbox noch eine Zahl festlegen, um die wievielte Vorabversion es sich handelt. Diese Angabe wird auch bei der Updatesuche berücksichtigt.
-
Architektur: Mit dieser Einstellung können Sie festlegen, für welche Prozessorarchiktekturen das Update verfügbar sein soll. Der Standardwert ist "Unabhängig", Sie können die Verfügbarkeit jedoch auf 32-Bit (x86) oder 64-Bit (x64) Betriebssystemarchitekturen einschränken.
-
Beschreibung: Dies ist eine interne Beschreibung des Updatepaketes, Sie ist für den Benutzer welchem das Updateangezeigt wird nicht ersichtlich.
-
Veröffentlicht: Aktivieren Sie diese Option, wenn das Updatepaket als verfügbar gekennzeichnet werden- und damit allen Clients zum Download bereitstehen soll.
-
Service Pack: Mit dieser Option markieren Sie das Updatepaket als Service Pack. Dies hat zur Auswirkung, dass alle Updates, welche einen niedrigeren Releasestatus als dieses Update haben, bei der Updatesuche nicht berücksichtigt werden.
Im Bereich Änderungen geben Sie die Änderungen an, die dieses Updatepaket im Gegensatz zu der alten Version beinhaltet. Sie können im oberen Bereich zwischen Deutsch und Englisch wählen bzw. die Änderungen in beiden Sprachen verfassen.
Unter dem Punkt Aktionen finden Sie alle Updateaktionen die Sie in diesem Updatepaket verwenden können. Ziehen Sie die gewünschte Aktion einfach via Drag and Drop auf den Punkt Aktionen oder klicken Sie doppelt auf einen Eintrag um diesen Hinzuzufügen und dessen Konfigurationsseite zu öffnen.
Hier können Sie nun die Aktionen aussuchen, die für ihr Update erforderlich sind, wenn Sie nur Programmdateien austauschen wollen, benötigen Sie ausschließlich die Aktion Dateien kopieren oder ersetzen.
Die Updateaktion Dateien kopieren oder ersetzen ist die Aktion, welche am häufigsten benötigt wird, da sie die neuen Programmdateien enthällt.
Um die Daten Ihrer Anwendung zu aktualisieren, wählen Sie den Ordner Programmverzeichnis aus und klicken Sie entweder auf Dateien hinzufügen oder Ordner hinzufügen.
Wenn Sie einen neuen Ordner anlegen möchten, können Sie dies über einen Rechtsklick auf einen Ordner in der Verzeichnisansicht tun.
Jetzt sollten Sie alle Informationen zusammen haben, um das erste Updatepaket erstellen zu können. Sie haben die Version festgelegt, angegeben was sich in dieser Version alles geändert hat und die neuen Dateien hinzugefügt. Klicken Sie jetzt auf Updatepaket erstellen um Ihr neues Update zu erstellen und hochzuladen.
Nach Updates suchen und diese Installieren
Nun muss nur noch die Updatesuche und Installtion in Ihrer Anwendung angestoßen werden. Dies können Sie z.B. über einen Klick auf einen Button oder beliebig anders auslösen.
Das unten ausgeführte Codebeispiel gibt die einfachste Art wieder, um Ihre Anwendung automatisch zu aktualisieren, Sie können den Updatevorgang natürlich noch weiter nach Ihren Wünschen gestalten, Anleitungen und Beispiele dazu finden Sie in der Hilfe und in dem Quellcode der Beispielanwendungen.
1 private void btnRunUpdateInteractive_Click(object sender, EventArgs e) {
2
3 //Automatisch die zu aktualisierende Anwendung schließen
4 upctrlMain.autoCloseHostApplication = true;
5
6 //Updatesuche starten
7 upctrlMain.updateInteractive(this);
8 }