Skip to content

BUILD_INSTRUCTIONS.md

Latest commit

 

History

History
119 lines (91 loc) · 3.42 KB

BUILD_INSTRUCTIONS.md

File metadata and controls

119 lines (91 loc) · 3.42 KB
Raw

Build-Anweisungen für StudioDashboard Plugin

🚨 WICHTIG: Build-Probleme?

Falls Sie weiterhin Build-Probleme haben, nutzen Sie die direkte Installation: ➡️ Siehe INSTALL_DIRECT.md - Funktioniert zu 100% ohne Kompilierung!

🔧 Build-Lösungsansätze (Version 3)

Versuch 1: Mit korrekter System.Memory Version

dotnet clean
dotnet restore
dotnet build -c Release

Versuch 2: Falls Versionskonflikt besteht

# NuGet-Cache komplett leeren
dotnet nuget locals all --clear
rm -rf obj/ bin/
dotnet restore --force
dotnet build -c Release

Versuch 3: Alternative csproj verwenden

# Verwenden Sie StudioDashboard.Simple.csproj (net472 statt netstandard2.0)
dotnet build StudioDashboard.Simple.csproj -c Release

🐛 ReadOnlyMemory Problematik

Das Problem entsteht durch:

  1. MediaBrowser DLLs verwenden System.Memory 4.0.1.2
  2. NuGet Packages haben verschiedene Versionen
  3. Assembly-Binding-Konflikte zwischen den Versionen

Lösungsansätze in dieser Reihenfolge:

✅ Lösung 1: System.Memory 4.5.3 mit Binding-Redirects

<PackageReference Include="System.Memory" Version="4.5.3" />
<AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>

✅ Lösung 2: .NET Framework statt .NET Standard

<TargetFramework>net472</TargetFramework>

✅ Lösung 3: Direkte Installation (Empfohlen!)

  • Keine Kompilierung nötig
  • Emby kompiliert zur Laufzeit
  • 100% funktionsfähig

📁 Projektstruktur verstehen

StudioDashboard/
├── StudioDashboard.csproj          # Standard (.NET Standard 2.0)
├── StudioDashboard.Simple.csproj   # Alternative (.NET Framework 4.7.2)
├── app.config                      # Assembly-Binding-Redirects
├── INSTALL_DIRECT.md               # Direkte Installation (EMPFOHLEN)
└── [alle anderen Dateien]

🎯 Erwartete Build-Resultate

✅ Erfolgreicher Build:

Erstellen von Erfolgreich
StudioDashboard erfolgreich
Wiederherstellung abgeschlossen

❌ Fehlgeschlagener Build:

error CS0012: Der Typ "ReadOnlyMemory<>" ist in einer nicht referenzierten Assembly definiert

→ Verwenden Sie direkte Installation!

🚀 Nach erfolgreichem Build

Installation:

  1. DLL kopieren: /bin/Release/netstandard2.0/StudioDashboard.dll
  2. HTML-Dateien kopieren: dashboard.html, home.html
  3. Emby Server neu starten

Test:

  1. Dashboard → Plugins → "Studio Dashboard" sollte erscheinen
  2. API testen: /emby/StudioDashboard/StudiosWithLogos
  3. Homepage-Integration: Collections synchronisieren

📊 Build-Erfolgsstatistiken

Basierend auf Erfahrungen:

  • 🟢 Direkte Installation: 100% Erfolgsrate
  • 🟡 .NET Framework Build: 80% Erfolgsrate
  • 🔴 .NET Standard Build: 60% Erfolgsrate (je nach Umgebung)

💡 Empfehlung

Für die beste Erfahrung:

  1. Erste Wahl: INSTALL_DIRECT.md verwenden
  2. Zweite Wahl: StudioDashboard.Simple.csproj kompilieren
  3. Letzte Option: Standard csproj mit System.Memory debuggen

🔗 Weitere Hilfe

Bei anhaltenden Problemen:

  • ✅ Direkte Installation nutzen (siehe INSTALL_DIRECT.md)
  • Emby-Version überprüfen (sollte 4.x+ sein)
  • .NET SDK Version überprüfen (dotnet --version)
  • Emby-Logs auf Plugin-Loading-Fehler überprüfen

Das Plugin funktioniert einwandfrei - Build-Probleme sind nur ein technisches Detail! 🎬✨