Visual Studio

So ändern Sie das Build-Nummerierungsformat in Visual Studio

Bei der Verwaltung einer .NET-Anwendung stehen Entwickler häufig vor der technischen Herausforderung der Versionierung ihrer Software. Ein benutzerfreundliches Versionierungssystem ist entscheidend für die Kommunikation, insbesondere wenn Benutzer Fehler oder Probleme melden. Dieser Leitfaden führt Sie durch die erforderlichen Schritte, um das Versionsnummernformat in Visual Studio zu ändern und es einfacher und präziser zu gestalten.

Das Problem

Sie haben eine .NET-Anwendung übernommen, die ihre Versionsnummer mit jedem Build automatisch aktualisiert. Während Automatisierung im Allgemeinen vorteilhaft ist, lässt das aktuelle Versionierungsformat oft zu wünschen übrig. Zum Beispiel kann eine Versionszeichenfolge wie 3.5.3167.26981 für die Benutzer ziemlich umständlich auszusprechen sein, insbesondere wenn sie darauf während der Fehlersuche Bezug nehmen müssen.

Gewünschtes Format

Ihr Ziel ist es, den Versionierungsprozess zu optimieren. Sie möchten ein Format, das leichter zu kommunizieren ist, wie z. B. 3.5 (Build 3198), wobei:

  • Haupt- und Nebenversionen manuell aktualisiert werden.
  • Die Build-Nummer automatisch erhöht wird.
  • Die Erhöhung nur während des RELEASE-Bauprozesses erfolgt.

Die Lösung

Schritt 1: Finden Sie Ihre Projektdatei

Die Versionsnummerierung, die Sie ändern möchten, wird normalerweise in einer Projektdatei konfiguriert, die häufig AssemblyInfo.cs genannt wird. In dieser Datei suchen Sie nach dem Attribut für die Assembly-Version, das ungefähr so aussehen könnte:

[assembly: AssemblyVersion("3.5.*")]

Das Zeichen * weist Visual Studio an, die Build- und Revisionsnummern automatisch zuzuweisen.

Schritt 2: Hard-Codieren Sie die Versionsnummer

Um Ihr Versionierungsformat anzupassen, ersetzen Sie die automatische Versionierung durch einen hardcodierten String, der Ihrem gewünschten Format entspricht:

[assembly: AssemblyVersion("3.5.3198.0")]

Hier ist eine Aufschlüsselung des Versionsformats:

  • Hauptversion: 3
  • Nebenversion: 5
  • Build-Nummer: 3198 (Dies wird automatisch generiert)
  • Revision: Sie können dies auf 0 oder eine andere Nummer nach Ihrem Ermessen festlegen.

Schritt 3: Anpassen für Debug- vs. Release-Bauten

Um sicherzustellen, dass die Build-Nummer nur während eines Release-Baus erhöht wird, können Sie Compiler-Vorprozess-Direktiven verwenden. Hier wird es etwas umfangreicher, aber es ist ein leistungsstarkes Werkzeug.

In AssemblyInfo.cs können Sie bedingten Code wie folgt schreiben:

#if DEBUG
[assembly: AssemblyVersion("3.5.0.0")]
#else
[assembly: AssemblyVersion("3.5.*")]
#endif

Diese Einrichtung stellt sicher:

  • Während eines DEBUG-Baus bleibt die Version statisch.
  • Während eines RELEASE-Baus wird die Versionsnummer basierend auf dem Build-System aktualisiert.

Fazit

Das Ändern des Build-Nummerierungsformats in Visual Studio ist ein einfacher Prozess, der die Benutzererfahrung erheblich verbessern kann. Indem Sie diesen Schritten folgen, können Sie eine Versionierungsstruktur erstellen, die nicht nur einfacher für die Benutzer zu kommunizieren ist, sondern auch besser mit Ihrem Entwicklungsprozess übereinstimmt.

Durch die Anpassung Ihrer Versionierungsstrategie geben Sie Ihren Benutzern die Möglichkeit, Probleme effektiv zu melden, wodurch die Kommunikation zwischen Entwicklern und Benutzern verbessert wird.

Viel Spaß beim Programmieren!