Skip to content

testing.md

Latest commit

 

History

History
407 lines (297 loc) · 8.67 KB

testing.md

File metadata and controls

407 lines (297 loc) · 8.67 KB
Raw

WindowsBridge – Testing Guide

Übersicht

Dieses Dokument beschreibt die automatisierten Test-Skripte für WindowsBridge und wie man diese ausführt, um die Installation zu verifizieren.

Test-Skripte

WindowsBridge enthält drei spezialisierte Test-Skripte:

1. test_system.sh – System-Level Tests

Überprüft die Grundinstallation des Systems für Windows-Software-Kompatibilität.

Tests umfassen:

  • ✓ Debian-System-Erkennung
  • ✓ 32-Bit (i386) Architektur-Unterstützung
  • ✓ Vulkan-Installation (vulkan-tools, libvulkan1)
  • ✓ GPU-Treiber-Erkennung und Installation
  • ✓ OpenGL-Unterstützung (glxinfo, mesa-utils)
  • ✓ Kernel-Optimierung (vm.max_map_count)
  • ✓ Abhängigkeits-Überprüfung

Ausführung:

bash ./modules/test_system.sh
bash ./modules/test_system.sh --verbose  # Mit Debug-Ausgabe

Erwartete Ausgabe bei erfolgreichem Test:

✓ PASS: Debian-System erkannt
✓ PASS: 32-Bit (i386) Architektur aktiviert
✓ PASS: vulkan-tools installiert
✓ PASS: GPU-Treiber erkannt und installiert
✓ PASS: OpenGL verfügbar

2. test_wine.sh – Wine Installation Tests

Überprüft die Wine-Umgebung und alle Abhängigkeiten.

Tests umfassen:

  • ✓ Wine-Paketinstallation (wine, wine32, wine64)
  • ✓ Wine-Prefix Existenz und Validität
  • ✓ Winetricks-Installation
  • ✓ Registry-Tweaks (DPI, CSMT)
  • ✓ DXVK Installation
  • ✓ Laufzeit-Komponenten

Ausführung:

bash ./modules/test_wine.sh
bash ./modules/test_wine.sh --verbose

Erwartete Ausgabe:

✓ PASS: Wine-Paket installiert
✓ PASS: Wine Kommando verfügbar
✓ PASS: Wine-Prefix Verzeichnis existiert
✓ PASS: Winetricks Kommando verfügbar

Troubleshooting: Wenn der Wine-Prefix-Test fehlschlägt, müssen Sie zuerst wine_setup.sh ausführen:

bash ./modules/wine_setup.sh

3. test_gaming.sh – Gaming-Komponenten Tests

Überprüft alle Gaming-bezogenen Installationen und Abhängigkeiten.

Tests umfassen:

  • ✓ Steam-Installation (apt oder Flatpak)
  • ✓ Lutris-Installation
  • ✓ Heroic-Installation
  • ✓ GameMode
  • ✓ MangoHUD
  • ✓ VKD3D-Proton
  • ✓ Gaming-Abhängigkeiten (lib32-*:i386)
  • ✓ Flatpak + Flathub-Konfiguration

Ausführung:

bash ./modules/test_gaming.sh
bash ./modules/test_gaming.sh --verbose

Erwartete Ausgabe:

✓ PASS: Flatpak installiert
✓ PASS: Steam (Flatpak) installiert
✓ PASS: Lutris (Flatpak) installiert
✓ PASS: GameMode-Paket installiert

Test-Ausführungsreihenfolge (Recommended)

Folgen Sie dieser Reihenfolge für eine vollständige Überprüfung:

Phase 1: System-Vorbereitung

# 1. System-Tests ausführen
bash ./modules/test_system.sh

# Wenn Fehler auftreten:
sudo bash ./modules/system_setup.sh

# Erneut testen
bash ./modules/test_system.sh

Phase 2: Wine-Installation

# 2. Wine-Tests ausführen
bash ./modules/test_wine.sh

# Wenn Fehler auftreten:
bash ./modules/wine_setup.sh

# Erneut testen
bash ./modules/test_wine.sh

Phase 3: Gaming-Setup

# 3. Gaming-Tests ausführen
bash ./modules/test_gaming.sh

# Wenn Fehler auftreten:
bash ./modules/gaming_setup.sh

# Erneut testen
bash ./modules/test_gaming.sh

Phase 4: Vollständige Validierung

# Optional: Alle Tests nacheinander ausführen
bash ./modules/test_system.sh && \
bash ./modules/test_wine.sh && \
bash ./modules/test_gaming.sh && \
echo "✓ Alle Tests bestanden!"

Log-Dateien

Alle Tests schreiben Logs in ~/.config/windowsbridge/:

~/.config/windowsbridge/
├── test_system_YYYYMMDD_HHMMSS.log
├── test_wine_YYYYMMDD_HHMMSS.log
├── test_gaming_YYYYMMDD_HHMMSS.log
└── install_YYYYMMDD_HHMMSS.log

Log-Dateien anzeigen:

# Letzter System-Test
tail ~/.config/windowsbridge/test_system_*.log

# Letzter Wine-Test
tail ~/.config/windowsbridge/test_wine_*.log

# Letzter Gaming-Test
tail ~/.config/windowsbridge/test_gaming_*.log

Häufige Test-Fehler und Lösungen

Problem: "32-Bit (i386) Architektur NICHT aktiviert"

Ursache: 32-Bit Support ist nicht aktiviert.

Lösung:

sudo dpkg --add-architecture i386
sudo apt-get update
bash ./modules/test_system.sh

Problem: "Wine-Paket nicht installiert"

Ursache: Wine ist nicht installiert oder falsches Repository.

Lösung:

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install -y wine wine32 wine64 winetricks
bash ./modules/test_wine.sh

Problem: "Wine-Prefix Verzeichnis existiert NICHT"

Ursache: Wine wurde noch nicht initialisiert.

Lösung:

bash ./modules/wine_setup.sh
bash ./modules/test_wine.sh

Problem: "GPU-Treiber nicht erkannt"

Ursache: GPU-Treiber sind nicht installiert oder nicht erkannt.

Debugging:

# Zeige installierte GPUs
lspci | grep -i "VGA\|3D"

# Überprüfe Treiber-Status
glxinfo | grep "OpenGL vendor"
vulkaninfo | head -20

# Installation erzwingen
sudo bash ./modules/system_setup.sh --force-drivers

Problem: "Steam weder via apt noch Flatpak installiert"

Ursache: Steam ist nicht installiert und/oder Flatpak ist nicht konfiguriert.

Lösung:

# Option 1: Via apt
sudo apt-get install -y steam

# Option 2: Via Flatpak
sudo apt-get install -y flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakref
flatpak install flathub com.valvesoftware.Steam

bash ./modules/test_gaming.sh

Problem: "GameMode-Paket nicht installiert"

Ursache: GameMode wurde nicht installiert.

Lösung:

sudo apt-get install -y gamemode
bash ./modules/test_gaming.sh

Verbose Mode für Debugging

Alle Tests unterstützen --verbose für erweiterte Debug-Ausgaben:

bash ./modules/test_system.sh --verbose 2>&1 | tee debug_system.log
bash ./modules/test_wine.sh --verbose 2>&1 | tee debug_wine.log
bash ./modules/test_gaming.sh --verbose 2>&1 | tee debug_gaming.log

Verbose Output zeigt:

  • Detaillierte lspci/GPU-Informationen
  • Alle Wine-Registry-Einträge
  • Alle Paket-Überprüfungen
  • Debug-Timestamps und Sequenzen

Integration mit Installation

Die Test-Skripte können als Post-Installation-Validierung verwendet werden:

# Installation durchführen
sudo bash ./installer.sh --profile gaming

# Ergebnisse validieren
bash ./modules/test_system.sh
bash ./modules/test_wine.sh
bash ./modules/test_gaming.sh

Test-Metriken interpretieren

Erfolgsquote berechnet sich aus:

Erfolgsquote = (Bestandene Tests / Gesamttests) * 100%

Interpretation:

  • 100%: Alle Tests bestanden – Installation vollständig
  • 90-99%: Die meisten Tests bestanden – Kleinere Probleme, aber funktionsfähig
  • 70-89%: Mehrere Tests fehlgeschlagen – Setup erforderlich
  • < 70%: Kritische Fehler – Neuinstallation erforderlich

Manuelle Verifikation

Falls automatisierte Tests nicht ausreichend sind, können Sie manuell verifizieren:

System-Verifikation:

# 32-Bit Support
dpkg --print-foreign-architectures | grep i386

# GPU Info
glxinfo | head -20
vulkaninfo | head -20

# Kernel Settings
sysctl vm.max_map_count

Wine-Verifikation:

# Wine Version
wine --version

# Winetricks
winetricks --version

# Wine Prefix
ls -la ~/.wine/

Gaming-Verifikation:

# Steam
steam --version 2>/dev/null || flatpak run com.valvesoftware.Steam --version

# Lutris
lutris --version 2>/dev/null || flatpak run net.lutris.Lutris --version

# GameMode
gamemoderun true && echo "GameMode functional"

Continuous Testing

Für wiederholte Tests können Sie ein Bash-Skript erstellen:

#!/bin/bash
# run_all_tests.sh

echo "=== WindowsBridge Test Suite ==="
echo ""

bash ./modules/test_system.sh && SYSTEM_PASS=1 || SYSTEM_PASS=0
echo ""

bash ./modules/test_wine.sh && WINE_PASS=1 || WINE_PASS=0
echo ""

bash ./modules/test_gaming.sh && GAMING_PASS=1 || GAMING_PASS=0
echo ""

echo "=== Zusammenfassung ==="
[ $SYSTEM_PASS -eq 1 ] && echo "✓ System Tests: BESTANDEN" || echo "✗ System Tests: FEHLGESCHLAGEN"
[ $WINE_PASS -eq 1 ] && echo "✓ Wine Tests: BESTANDEN" || echo "✗ Wine Tests: FEHLGESCHLAGEN"
[ $GAMING_PASS -eq 1 ] && echo "✓ Gaming Tests: BESTANDEN" || echo "✗ Gaming Tests: FEHLGESCHLAGEN"

exit $((1 - SYSTEM_PASS * WINE_PASS * GAMING_PASS))

Verwenden Sie dieses Skript:

bash run_all_tests.sh

Kontakt & Support

Für Test-bezogene Probleme:

  1. Überprüfen Sie die Logdateien in ~/.config/windowsbridge/
  2. Verwenden Sie --verbose Flag für mehr Details
  3. Lesen Sie die entsprechende Module-Dokumentation
  4. Konsultieren Sie troubleshooting.md

Letzte Aktualisierung: 2026 Version: 1.0.0