Environment setup
=================

Gerrit
------

Our gerrit is available at the following address:
https://android-review.cri.epita.net.

Use your CRI credentials to sign in.

You **must** sign in at least once to exist on Gerrit. If you do not, I will not
be able to create your Git repositories.

SSH configuration
-----------------

#. Create a SSH key with a passphrase.

#. In Gerrit, in your login menu, go to your settings and add your public SSH
   key.

#. SSH host value must be ``sand-gerrit``.

.. important::
   Gerrit does not use the standard SSH port 22 but the port 29418 !

Android build
-------------

I **strongly** recommend using a docker container to build Android sources :
`Dockerfile <_static/Dockerfile_android>`_.

#. Install ``docker`` from your package manager.

#. Add yourself into ``docker`` group.

#. Start ``docker`` service:

   .. code:: bash

       sudo systemctl start docker
       sudo systemctl status docker

#. Create a directory ``docker-sand`` and change to this directory

#. Put the linked ``Dockerfile`` in this directory.

#. Build the docker image and run a container:

   .. code:: bash

       docker build -t sand:8 .
       docker run -u=`id -u $USER` -v <absolute path to your Android source tree>:/home/sand/ -v /tmp/:/tmp/ -t -i sand:8

It will prompt you a shell. All build commands must be done from this shell !

From your host, you must also source ``build/envsetup.sh`` and run ``lunch``
with the good target in order to be able to start Google emulator.