yvprasadbpc/andocker

andocker

This project provides a mechanism to run in a virtualized sandbox the entire Android and React Native ecosystem. This could be useful for testing environment, in a context of CI/CD integration, that would have an easy and scalable mechanism to run tests.

To have an explanation on how this tool works please refer to this article: Android emulation on Docker

Prerequisites

Host system must provide:

• Docker
• Node 12.13.1 Erbium (nvm could come in to help out)
• nested virtualization

How to Use

Go to the /ecosystem folder, set executable permission to compose.sh script and run it:

$ cd ecosystem/
$ chmod +x compose.sh
$ ./compose.sh

To force the expo image rebuilding run the command:

$ ./compose.sh --rebuild-ecosystem

Usage Technical Limitations

This issue investigated in details what are some limitations.

• The emulator works only in Ubuntu systems. It is possible that it works also on others Linux OS but they have not been tested yet.

• nested virtualisation must be available in host system. If you're using a VM to run the host system:

  Enable in VirtualBox

  VMWare supports nested virtualization natively.

  If you're on an Intel CPU please verify the related virtualization mirroring.

• OSX users must virtualize host system.

Special thanks to omarhassanhub who conducted this detailed investigation.

License

This project is distributed under EUPL-1.2.