Files
Theme.SZUAbsolventenverein/RELEASE_GUIDE.md

65 lines
2.0 KiB
Markdown

# Release Anleitung (Mac / Linux)
> [!NOTE]
> Diese Anleitung und das verwendete Skript sind für **macOS** (und Linux) optimiert.
## 1. Release Skript
Das Skript zur Erstellung des Releases befindet sich hier:
`Theme.SZUAbsolventenverein/Package/release.sh`
## 2. Version ändern
Die Versionsnummer muss in den folgenden **4 Dateien** angepasst werden:
1. **Package Projektdatei**
* Datei: `Theme.SZUAbsolventenverein/Package/SZUAbsolventenverein.Theme.Website.Package.csproj`
* Zeile: `<Version>1.0.11</Version>`
2. **NuGet Spezifikation (Nuspec)**
* Datei: `Theme.SZUAbsolventenverein/Package/SZUAbsolventenverein.Theme.Website.nuspec`
* Zeile: `<version>1.0.11</version>`
3. **Client Projektdatei** (optional)
* Datei: `Theme.SZUAbsolventenverein/Client/SZUAbsolventenverein.Theme.Website.Client.csproj`
* Zeile: `<Version>1.0.11</Version>`
4. **Theme Info (C# Code)**
* Datei: `Theme.SZUAbsolventenverein/Client/ThemeInfo.cs`
* Zeile: `Version = "1.0.11",`
## 3. Release Build erstellen
Führe das `release.sh` Skript im Terminal aus.
```bash
# In das Verzeichnis wechseln (falls noch nicht dort)
cd /Users/adamgaiswinkler/Theme.SZUAbsolventenverein/Package
# Skript ausführen
./release.sh net9.0 SZUAbsolventenverein.Theme.Website
```
**Was passiert dabei?**
1. Der Code wird im `Release` Modus kompiliert.
2. Ein NuGet-Paket (`.nupkg`) wird erstellt.
3. Das Paket (`.nupkg`) wird im Ordner **`Theme.SZUAbsolventenverein/Package/`** gespeichert.
> [!IMPORTANT]
> Du musst dieses Paket nun selbst nehmen und dorthin kopieren oder hochladen, wo du es installieren möchtest.
### Windows
Führe die `release.cmd` in der Eingabeaufforderung (cmd) oder PowerShell aus:
```cmd
cd Theme.SZUAbsolventenverein\Package
release.cmd net9.0 SZUAbsolventenverein.Theme.Website
```
## 4. Server neustarten
Damit das neue Theme geladen wird, musst du den Oqtane Server neustarten (falls er läuft):
1. Server stoppen (`Ctrl + C` im Terminal).
2. Server neu starten: `dotnet run` (im Oqtane.Server Verzeichnis).