Skip to content

Commit 05b09f2

Browse files
authored
Add headless emulator bug to Common Problems (#15)
1 parent 11a61d8 commit 05b09f2

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

content/en/usage/common-problems.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -256,3 +256,33 @@ adb shell pkill -9 frida-server
256256
```
257257

258258
Alternatively, you can also manually reboot the phone.
259+
260+
## `Emulator failed to start: Command was killed with SIGSEGV (Segmentation fault)` in headless mode (`-no-window`) in `cyanoacrylate`
261+
262+
This might be caused by a bug in the Android emulator’s hardware acceleration. [In the case we encountered](https://github.com/tweaselORG/cyanoacrylate/issues/53), the emulator still starts without problems if `headless` is set to `false`. You can try to resolve the problem by disabling hardware acceleration (see also [the `-accel` option of the Android emulator](https://developer.android.com/studio/run/emulator-commandline#common)):
263+
264+
```js
265+
{
266+
startEmulatorOptions: {
267+
emulatorName: '<your-emulator>',
268+
headless: true,
269+
hardwareAcceleration: {
270+
mode: 'off',
271+
},
272+
},
273+
}
274+
```
275+
276+
Alternatively, if you want to keep hardware acceleration, you can try different options for the GPU acceleration to find what works for you (take a look at [the `-gpu` option of the Android emulator](https://developer.android.com/studio/run/emulator-acceleration#accel-graphics)):
277+
278+
```js
279+
{
280+
startEmulatorOptions: {
281+
emulatorName: '<your-emulator>',
282+
headless: true,
283+
hardwareAcceleration: {
284+
gpuMode: 'host',
285+
},
286+
},
287+
}
288+
```

0 commit comments

Comments
 (0)