Logs van een Android-emulator op je Mac: waar je ze vindt en hoe je ze naar support stuurt

Start een Android-emulator niet op, toont hij een foutmelding of doet een knop niets, dan vraagt support om je logs. Dat zijn tekstbestanden waarin de engine en de launcher regel voor regel noteren wat ze doen. Hier lees je waar je ze vindt in MACOS EMULATOR, hoe je ze verstuurt zonder dat ze worden afgekapt, en waarom het moment waarop je ze kopieert telt.

Wat de logs van een emulator vertellen

Terwijl het Android-apparaat draait, schrijft de emulatie-engine op wat hij doet. Weigert hij een configuratie, dan schrijft hij een foutregel voordat hij stopt, en daarin staat de oorzaak vaak letterlijk. Ook de launcher houdt zijn eigen logbestand bij. Samen zijn het drie bestanden:

• emulator.log: het logbestand van de engine. Het venster „Logs” opent dit bestand standaard, dus dit is het bestand dat je stuurt als je niets verandert.
• launcher.log: een regel met datum bij elke controle op updates en bij elke klik op „Update”. Hier lees je een knop af die „niets doet”.
• branding.log, zeldzamer: het instellen van de engine na zijn installatie.

Logs of prestatierapport: twee verschillende dingen

Het prestatierapport meet zes seconden van een potje: de getoonde beelden, het geheugen, de thermische toestand van de Mac. Het wordt versleuteld gekopieerd: jij kunt het niet lezen, alleen support opent het. De logs vertellen wat er is gebeurd, en die blijven gewoon leesbaar: je kunt elke regel nalezen voordat je hem verstuurt.

Hapert het, dan vraagt support om allebei. Start de game niet, dan valt er geen potje te meten: de start heeft zijn spoor dan in het logbestand van de engine achtergelaten. De gids voor beelden per seconde in een emulator legt uit hoe je het rapport maakt.

Waar je de logs vindt in de launcher

1. 1Open „Settings”: het tandwiel, rechtsboven in de launcher.
2. 2Klik in de rubriek „Engine and storage”, op de regel „Logs”, op „View…”.
3. 3Het venster „Logs” opent op emulator.log. Klik op „Copy”: de tekst gaat naar het klembord van je Mac.

Het venster volgt het bestand live, ververst het elke twee seconden („Refreshes every 2 s”) en blijft op de laatste regels staan. Het einde telt, en „Copy” neemt precies het einde van het bestand, ongeveer de laatste 200 kilobyte: wat er net is gebeurd.

Met het menu rechtsboven in het venster kies je een ander bestand. Reageert de knop „Update” niet, kies dan launcher.log voordat je op „Copy” klikt. „Show in Finder” toont het bestand op je schijf, maar „Copy” is genoeg.

Versturen met „Een rapport sturen”

1. 1Log in op je klantenruimte, met je licentiesleutel of je e-mailadres.
2. 2Klik in de kaart „Schrijf naar support” op „Een rapport sturen”: het gesprek opent, met het venster „Rapport plakken”.
3. 3Plak je logs in het veld „Logboeken”, met Cmd + V. Het veld „Prestatierapport” mag leeg blijven: een van de twee is genoeg.
4. 4Klik op „Rapport versturen”. Elk ingevuld veld gaat als .txt-bestand mee, bijgevoegd bij het gesprek.

Loopt het gesprek al? Dezelfde knop staat er als pictogram, naast de paperclip onder de berichten, en ook op de pagina waarop je je ticket volgt, de pagina die de link in de e-mails van support opent.

Plak je logs niet in het berichtvak: een gewoon bericht stopt bij 4000 tekens, en logs gaan daar snel overheen. Het veld „Logboeken” maakt er een bestand van, zonder iets af te knippen. Mislukt het versturen, dan is wat in het veld blijft staan niet verzonden.

Zet in je bericht ook je configuratie (het Apple-menu, daarna Over deze Mac) en wat je ziet, in je eigen woorden.

Het juiste moment: vlak na het probleem, voordat je opnieuw start

Het logbestand van de engine begint bij elke start van het apparaat weer leeg. Start je het apparaat na de storing opnieuw, dan wis je dus wat de engine had geschreven, foutregel inbegrepen. Kopieer je logs zodra het probleem zich voordoet, en start pas daarna opnieuw.

• Open tijdens een start „Settings” niet om ze op te halen: dat breekt de start af die bezig is. Wacht op de foutmelding, of tot het wachten voorbij is. De gids over een emulator die niet opstart zegt hoelang normaal is.
• Toont het venster „Something went wrong” de regel „The engine reported:”, neem die regel dan ook letterlijk over in je bericht: dat is de regel waar support naar zoekt.

Voordat je verwijdert of teruggaat naar de vorige versie

De logs staan bij de rest van de gegevens van de app, in je gebruikersmap, onder Library en daarna Application Support. „Uninstall” wist die hele map, logs inbegrepen: na een herinstallatie valt er niets meer te lezen over de storing van daarvoor. Stuur ze dus eerst. De gids om een Android-emulator te verwijderen laat zien wat er verdwijnt.

Dezelfde regel geldt voor „Switch to the previous version”: ben je eenmaal teruggegaan, dan valt wat er misging niet meer te meten.

Wat je Mac verlaat, en wat niet

De logs verlaten je Mac alleen als je ze zelf plakt. Uit zichzelf verstuurt de launcher alleen de controle van je licentie, en wat je plakt, is precies wat support ontvangt. De gids over de veiligheid van een Android-emulator laat zien wat de app verder van je Mac vraagt.

Veelgestelde vragen