Dummy-Devices are a kind of „Software-Clone“ created from a real device: All details Adebar usually gathers from your Android device via ADB are stored into text files. This is mostly intended for development and troubleshooting purposes – for example, if you have problems with Adebar and your device, you can create an issue, send the „Dummy Device Data“ – and someone experienced can look into it without having the real device.
Creating a dummy device
For creation of dummy devices, you find a script named
mk_dummy in the
directory of Adebar. This script will do most of the work for you; just follow
- copy the script into a „working directory“ where the dummy shall be created
- enable USB Debugging in your device and connect it to your computer
- in the directory where you copied
<name>with the name you want to give that device, e.g.
bqx5_90for a BQ Aquaris X5 running Android 9. Note that no spaces are allowed in the name.
- watch the process:
mk_dummywill create a new directory with the name you gave the device (
bqx5_90in above example), collect the details from your „real device“, and store them into files located in that directory. This can take a little – but not much longer than a minute.
Now you've got your DummyDevice. If you want to send that to someone for investigation, simply pack up the directory into an archive, like
zip -ro9 bqx5_90.zip bqx5_90/*or
tar cjf bqx5_90.tar.bz2 bqx5_90/*or
tar czf bqx5_90.tar.gz bqx5_90/*
Now you can transfer the archive by mail, upload or whatever.
Using a dummy device
If you want to make use of a dummy device yourself, just create a config for it (see Configuration for details). The two important parameters here are:
DUMMY_BASE=$HOME/adebar/dummies(where your dummy devices reside)
DUMMY=bqx5_90(name of the dummy device you want to use)
Optionally you can also specify a different
STORAGE_BASE. Everything else is
configured as done for a real device – though some things will be ignored by
- things to be transferred to the device (this cannot be done for dummies)
- some app-specific details (like disabled components)
- files to be pulled (like configuration files, or XPrivacy data)
Sending dummy device data
Before sending your DummyDevice data across the network, be aware that they
can contain personal data – so you want to sanitze them. For example, replace
email addresses in the
dumpsys_account file by something like
email@example.com. Further, your device's IMEI might be present in
dumpsys_telephony.registry might contain
phone numbers, and so on.
It might not be the best idea to place such a dummy device into the public. So better send them in a safe way (e.g. a PGP encrypted mail). When unsure, ask.