Documentation improvement

[tausiq]

Issue 01

Before running the "Emulator Setup" the distutils package is required.

Distutils package is available only for python3 and AOSP requires python 2.7. Still the package is required. Otherwise getting the following error,

no module named distutils.dir_util

Please add the following line in documentaiton,

sudo apt-get install python3-distutils -y

Issue 02

Repo tool is required. Please add the following link in documentation,
https://source.android.com/setup/develop#installing-repo

Additionally,

sudo apt-get install curl -y

Issue 03

sudo apt-get install lzip

Issue 04

sudo apt-get install m4

Issue 05

sudo apt install python-pip -y
pip install zxcvbn
pip install numpy

Issue 06

This repo should be cloned with --recursive flag, otherwise dj-on-github/sp800_22_tests files will not get downloaded.

sudo apt-get install git -y
git clone --recursive https://github.com/lucapiccolboni/crylogger.git

Issue 07

sudo apt-get install cpu-checker
kvm-ok
sudo chown $USER /dev/kvm

[lucapiccolboni]

Thanks! It is always difficult to keep track of dependencies. This is great. Thanks for your contributions.

[tausiq]

I have added a couple of more points. I will keep updating this issue until I am done with my current attempt. Please keep this issue open till then. Thanks!

[darwintree]

Here are some other issues. I run crylogger in Ubuntu 20.04.

Adb dependency is needed

sudo apt-get install adb

otherwise run.py line 30
return subprocess.check_output(split, stderr=subprocess.STDOUT).decode("utf-8")
would throw an error that "File or directory not found"

aes example needs to be signed

The orginal compiled apk can not be installed for the below reason

---------------adb: failed to install /home/zhang/documents/code/crylogger/scripts/data/apks/com.example.aes_0.apk: Failure [INSTALL_PARSE_FAILED_NO_CERTIFICATES: Package /data/app/vmdl1148869426.tmp/base.apk has no certificates at entry AndroidManifest.xml]

use android studio and sign the bundled apk will help

[lucapiccolboni]

Thanks for reporting these issues!

As far as I remember, I didn't have issues in installing the apk of the aes example, but I'm glad you were able to find a solution.

For future reference, here are some additional guidelines on how to create a building environment (it is linked in the README). Most dependencies are listed there. There are additional dependencies for the Python scripts check.py and run.py.

Thanks.

[tausiq]

Hello @lucapiccolboni I am done with my current attempt. Everything looks good as expected. I couldn't run a good number apps against the tool, but that is not related to documentation improvement. You can close the issue and update the README.md file. If you like me to send a PR, I would be happy to do that as well. Thanks!