Merge pull request #2363 from sigmabeta/android-build-instructions

Add Android build instructions to Readme.md.
This commit is contained in:
Lioncash 2015-05-03 14:34:53 -04:00
commit a04ec46e40
1 changed files with 27 additions and 0 deletions

View File

@ -49,6 +49,33 @@ On OS X, an application bundle will be created in `./Binaries`.
On Linux, it's strongly recommended to perform a global installation via `sudo make install`. On Linux, it's strongly recommended to perform a global installation via `sudo make install`.
## Installation on Android
Dolphin requires [Android Studio](http://developer.android.com/tools/studio/index.html) to build
the Android UI. Import the Gradle project located in `./Source/Android`, and then execute the
Gradle task `assembleDebug` to build, or `installDebug` to install the UI onto a connected device.
In order to launch the app, you must build and include the native Dolphin libraries into the UI project.
Building native code requires the [Android NDK](https://developer.android.com/tools/sdk/ndk/index.html).
### Build Steps:
1. `mkdir Build-Android-<abi>`
2. `cd Build-Android-<abi>`
3. `cmake -DANDROID=True -DANDROID_NDK=<ndk-path> -DANDROID_NATIVE_API_LEVEL=android-18 -DANDROID_TOOLCHAIN_NAME=<toolchain> -DANDROID_ABI=<abi> -DCMAKE_TOOLCHAIN_FILE=../Source/Android/android.toolchain.cmake -DGIT_EXECUTABLE=<git-path> ..`
4. `make`
Replace `<git-path>` with the absolute path to your machine's Git executable, <ndk-path> with the absolute
path to where you installed your NDK, and the rest depending on which platform the Android device you are
targeting uses:
|Platform | <abi> | <toolchain> |
|-------------------------|-------------|---------------------------|
|ARM 32-bit (most devices)| armeabi-v7a | arm-linux-androideabi-4.9 |
|ARM 64-bit (i.e. Nexus 9)| arm64-v8a | aarch64-linux-android-4.9 |
|Intel 64-bit | x86_64 | x86_64-4.9 |
The native libraries will be compiled, and copied into `./Source/Android/app/libs`. Android Studio
and Gradle will include any libraries in that folder into the APK at build time.
## Uninstalling ## Uninstalling
When Dolphin has been installed with the NSIS installer, you can uninstall When Dolphin has been installed with the NSIS installer, you can uninstall
Dolphin like any other Windows application. Dolphin like any other Windows application.