dolphin/AndroidSetup.md

2.7 KiB

How to Set Up an Android Development Environment

If you'd like to contribute to the Android project, but do not currently have a development environment setup, follow the instructions in this guide.

Prerequisites

If you downloaded Android Studio, extract it and then see Setting up Android Studio.

Setting up Android Studio

  1. Launch Android Studio, which will start a first-launch wizard.
  2. Choose a custom installation.
  3. If offered a choice of themes, select your preference.
  4. When offered a choice of components, uncheck the "Android Virtual Device" option. Android Studio Components
  5. Accept all licenses, and click Finish. Android Studio will download the SDK Tools package automatically. (Ubuntu users, if you get an error running the mksdcard tool, make sure the lib32stdc++6 package is installed.)
  6. At the Android Studio welcome screen, click "Configure", then "SDK Manager".
  7. Use the SDK Manager to get necessary dependencies, as described in Getting Dependencies.
  8. When done, follow the steps in Readme.md to compile and deploy the application.

Executing Gradle Tasks

In Android Studio, you can find a list of possible Gradle tasks in a tray at the top right of the screen:

Gradle Tasks

Double clicking any of these tasks will execute it, and also add it to a short list in the main toolbar:

Gradle Task Shortcuts

Clicking the green triangle next to this list will execute the currently selected task.

For command-line users, any task may be executed with Source/Android/gradlew <task-name>.

Getting Dependencies

Most dependencies for the Android project are supplied by Gradle automatically. However, Android platform libraries (and a few Google-supplied supplementary libraries) must be downloaded through the Android package manager.

  1. Launch the Android SDK Manager by clicking on its icon in Android Studio's main toolbar: Android Studio Package Icon
  2. Install or update the SDK Platform. Choose the API level selected as compileSdkVersion.
  3. Install or update the SDK Tools. CMake, LLDB and NDK. If you don't use android-studio, please check out https://github.com/Commit451/android-cmake-installer.

In the future, if the project targets a newer version of Android, or use newer versions of the tools/build-tools packages, it will be necessary to use this tool to download updates.