1. Setting the project up - EmulairEmulator/Emulair-Lemuroid-clone GitHub Wiki

Installing Android Studio

This project is being worked on using Android Studio. Unfortunately, other IDEs can't build this app, so you will have to download it. To install Android Studio, go to the Android Developers website, click "Download", and follow all the necessary steps. If you want automatic updates for Android Studio, consider using Jetbrains Toolbox.

Cloning the repo

To clone the repository on your PC, it is recommended to use Git or Android Studio's built-in "Project from Version Control" option, but you can also just click on "Download ZIP" directly from the web version of GitHub. Don't forget to also clone the LibretroCores repository that contains all the emulators Emulair is using, if you wish to create a version of Emulair with built-in cores that don't require any in-app download. Place this repo directly in the root folder, where files such as .gitignore and README.md are located.

Building Emulair

Once the project has been opened, Android Studio will automatically download all necessary libraries and sync all the build.gradle files with the project. In case syncing fails or is interrupted, click on the "Sync project with Gradle files" button located at the right section of the top toolbar (the one that looks like a miniature elephant, the logo of Gradle). To build the project, simply click on the green hammer shaped button, located on the same toolbar. If anything fails, check if all the files are in place and if you are using the latest version of Android Studio.

Choosing what version to run

Emulair has four flavours, two related to the cores (bundled or downloaded), and the other two related to what sources the app is downloaded from (Google Play or other sources). There is also a distinction to be made between "Debug" and "Release" - the "Debug" version has different colours and a different name ("Emulair D" instead of simply "Emulair"), just so it won't be confused with the "Release" version during development. For testing purposes, it is recommended to choose the debug version, along with the "bundled" and "gplay" flavours. To select a specific flavour for building, go to Build -> Select build variant..., click on :emulair-app's Active build variant, then select a desired build type from the dropdown menu.

Note: In the near future, Emulair will drop the separate Google Play build version and will focus on providing the same codebase for any Android app store.

Running Emulair on Android Studio's built-in emulator

To run Emulair directly from Android Studio, you need to set up a virtual Android device in the "Device Manager" section. Upon completing the setup, simply select your virtual device from the top toolbar's dropdown menu, then click the green arrow button on the right to run the app.

Running Emulair on your mobile device

To run Emulair directly on your Android device, you'll first have to enable either USB or wireless debugging from your phone's settings, then select your physical device from the same dropdown menu mentioned above. The last step is to click the green "Run" button.