Logs eines Android-Emulators auf dem Mac: wo sie liegen und wie sie vollständig beim Support ankommen

Startet ein Android-Emulator nicht, zeigt er einen Fehler oder bleibt eine Schaltfläche ohne Wirkung, fragt dich der Support nach deinen Logs. Das sind Textdateien, in denen die Engine und der Launcher Zeile für Zeile festhalten, was sie tun. Hier ist, wo du sie in MACOS EMULATOR findest, wie du sie schickst, ohne dass etwas abgeschnitten wird, und warum der Moment zählt, in dem du sie kopierst.

Was die Logs eines Emulators erzählen

Während das Android-Gerät läuft, schreibt die Emulations-Engine mit, was sie tut. Lehnt sie eine Konfiguration ab, schreibt sie eine Fehlerzeile, bevor sie sich beendet, und die Ursache steht dort oft schwarz auf weiß. Der Launcher führt außerdem sein eigenes Log. Insgesamt sind es drei Dateien:

• emulator.log: das Log der Engine. Das Fenster „Logs“ öffnet es von selbst, also schickst du genau dieses, wenn du nichts änderst.
• launcher.log: eine Zeile mit Datum bei jeder Prüfung auf Updates und bei jedem Klick auf „Update“. Hier hinterlässt eine Schaltfläche, die „nichts tut“, ihre Spur.
• branding.log, seltener gebraucht: die Einrichtung der Engine nach ihrer Installation.

Logs oder Leistungsbericht: zwei verschiedene Dinge

Der Leistungsbericht misst sechs Sekunden Spiel: die angezeigten Bilder, den Arbeitsspeicher, den thermischen Zustand des Mac. Er wird verschlüsselt kopiert: Du kannst ihn nicht lesen, erst der Support öffnet ihn. Die Logs dagegen erzählen, was passiert ist, und sie bleiben im Klartext: Du kannst jede Zeile lesen, bevor du sie schickst.

Ruckelt es, fragt der Support nach beidem. Startet das Spiel gar nicht, gibt es keine Partie zu messen: Dann hat der Start seine Spur im Log der Engine hinterlassen. Der Ratgeber zum Messen der Bilder pro Sekunde im Emulator erklärt, wie du den Bericht aufnimmst.

Wo du die Logs im Launcher findest

1. 1Öffne „Settings“: das Zahnrad oben rechts im Launcher.
2. 2Klick im Bereich „Engine and storage“ in der Zeile „Logs“ auf „View…“.
3. 3Das Fenster „Logs“ öffnet sich mit emulator.log. Klick auf „Copy“: Der Text landet in der Zwischenablage des Mac.

Das Fenster folgt der Datei live, aktualisiert sich alle zwei Sekunden („Refreshes every 2 s“) und bleibt dabei an den letzten Zeilen. Auf das Ende kommt es an, und „Copy“ nimmt genau das Ende der Datei, ihre letzten rund 200 KB: das, was gerade passiert ist.

Über das Menü oben rechts im Fenster wechselst du die Datei. Reagiert die Schaltfläche „Update“ nicht, wähl dort launcher.log, bevor du auf „Copy“ klickst. „Show in Finder“ zeigt dir die Datei auf deiner Festplatte, aber „Copy“ reicht.

Die Logs mit „Bericht senden“ verschicken

1. 1Melde dich mit deinem Lizenzschlüssel oder deiner E-Mail-Adresse in deinem Kundenbereich an.
2. 2Klick in der Karte „An den Support schreiben“ auf „Bericht senden“: Das Gespräch öffnet sich, zusammen mit dem Fenster „Füge deinen Bericht ein“.
3. 3Füg deine Logs mit Cmd + V in das Feld „Protokolle“ ein. Das Feld „Leistungsbericht“ darf leer bleiben: Eines der beiden reicht.
4. 4Klick auf „Bericht senden“. Jedes ausgefüllte Feld geht als .txt-Datei mit, an das Gespräch angehängt.

Läuft das Gespräch schon? Dann findest du dieselbe Schaltfläche als Symbol neben der Büroklammer unter den Nachrichten, und auf der Seite zu deinem Ticket, die der Link in den E-Mails des Supports öffnet.

Füg deine Logs nicht in das Nachrichtenfeld ein: Eine gewöhnliche Nachricht endet bei 4000 Zeichen, und Logs sind schnell länger. Das Feld „Protokolle“ macht eine Datei daraus und schneidet nichts ab. Schlägt das Senden fehl, ist das, was noch im Feld steht, nicht rausgegangen.

Schreib in deine Nachricht deine Konfiguration (Apple-Menü, dann „Über diesen Mac“) und in deinen eigenen Worten, was du siehst.

Der richtige Moment: direkt nach dem Problem, vor dem Neustart

Das Log der Engine beginnt bei jedem Start des Geräts leer. Startest du das Gerät nach dem Fehler neu, löschst du also, was die Engine geschrieben hatte, samt Fehlerzeile. Kopier deine Logs, sobald das Problem aufgetreten ist, und starte erst danach neu.

• Öffne während eines Starts nicht „Settings“, um sie zu holen: Das bricht den laufenden Start ab. Warte auf die Fehlermeldung oder auf das Ende der Wartezeit. Der Ratgeber zum Android-Emulator, der nicht startet sagt, wie lange ein Start normalerweise dauert.
• Zeigt das Fenster „Something went wrong“ die Zeile „The engine reported:“, übernimm auch diese Zeile Wort für Wort in deine Nachricht: Genau sie sucht der Support.

Vor dem Deinstallieren oder Zurückwechseln

Die Logs liegen mit den übrigen Daten der App in deinem Benutzerordner, unter ~/Library/Application Support. „Uninstall“ löscht diesen ganzen Ordner, Logs inklusive: Nach einer Neuinstallation gibt es über den Fehler von vorher nichts mehr zu lesen. Schick sie also zuerst. Die Anleitung zum Deinstallieren eines Android-Emulators zeigt im Detail, was dabei verschwindet.

Dieselbe Regel gilt vor „Switch to the previous version“: Nach dem Zurückwechseln lässt sich nicht mehr messen, was nicht stimmte.

Was deinen Mac verlässt, und was nicht

Die Logs verlassen deinen Mac nur, wenn du sie selbst einfügst. Von sich aus schickt der Launcher nur die Prüfung deiner Lizenz, und was du einfügst, ist genau das, was der Support bekommt. Der Ratgeber zur Sicherheit eines Android-Emulators erklärt, was die App sonst noch von deinem Mac verlangt.

Häufige Fragen