Zum Inhalt springen

Debuggen mit OpenCore ​

Wenn du auf einen seltsamen Fehler gestoßen bist und nicht sicher bist, ob es sich um einen Bedienfehler oder ein Problem im Patcher handelt, empfehlen wir, auf dem OpenCore Patcher Paradise Discord-Server um Hilfe zu bitten.

Selbst debuggen ​

Am einfachsten debuggst du selbst über die Patcher-Einstellungen. Dort gibt es viele verschiedene Einstellungen, die drei wichtigsten Optionen sind jedoch:

  • „Enable Verbose Mode“
  • „Enable OpenCore DEBUG“
  • „Enable Kext DEBUG“
OCLP-Debug

Wenn du diese drei Optionen aktiviert hast, erstelle OpenCore neu und installiere es auf dein Laufwerk. Dadurch erhältst du deutlich mehr Debug-Informationen, und Logs werden auf die EFI-Partition geschrieben.

OpenCore-Logs vom Laufwerk holen ​

Mit aktiviertem „Enable OpenCore DEBUG“ wird bei jedem Start eine .txt-Datei auf der EFI-Partition erzeugt. Um diese Logs zu holen, lade MountEFI herunter und starte es:

EFI einhängen

Sobald du die EFI-Partition des Laufwerks eingehängt hast, auf dem macOS installiert ist, solltest du dort die Logs finden:

EFI einhängen

Kernel-Logs aus macOS holen ​

Mit aktiviertem „Enable Kext DEBUG“ werden bei jedem Start deutlich detailliertere Logs im Betriebssystem gespeichert. Um sie zu erhalten, führe einfach den folgenden Befehl aus:

sh
sudo dmesg > ~/Desktop/DMESG.txt

Danach liegt das Log auf deinem Schreibtisch.

Ein Issue bei uns melden ​

Jetzt, wo du aussagekräftige Logs hast, kannst du ein Issue bei uns erstellen. Denk daran, folgende Informationen anzugeben:

  • Modell, für das du patchst (z. B. MacBookPro10,1)
  • Ziel-Betriebssystem (z. B. macOS 11.2.3)
  • Host-Betriebssystem (z. B. macOS 10.15.7)
  • Upload deines OpenCore-Build-Ordners
  • Upload deines OpenCore-Logs (falls zutreffend)
  • Upload deines Kernel-Logs (falls zutreffend)

Bitte suche außerdem vorher, ob das Problem bereits gemeldet wurde. So vermeiden wir doppelte Issues.