Skip to content
Browse files

doc: Update the build instructions in the root README file.

  • Loading branch information
littleguy77 committed Mar 7, 2015
1 parent 99ce095 commit 96cfe3c788e2b2c179c5d7c6b09c390e03690c5c
Showing with 63 additions and 68 deletions.
  1. +33 −0 .project.init
  2. +30 −68
@@ -0,0 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
@@ -1,71 +1,33 @@

Mupen64Plus, Android Edition (AE) is a port of Mupen64Plus to Android. (Not officially supported by the Mupen64Plus team)

Mupen64Plus, AE Build Instructions

Author: Paul Lamb

(for assistance, visit

Downloading the source:

1. From the terminal, go to the folder where you want to put mupen64plus-ae
(for Eclipse users, this should be ~/workspace/)

2. Clone the git repository
(example: "git clone")

Setting up the project:

1. From the terminal, enter the mupen64plus-ae folder

2. Run "android list targets" to find the index ## for API level 17 or higher

3. Update the Android project
(example: "android update project --target ## --name Mupen64Plus --path .")

Eclipse users:

1. Install or update to the latest ADT plug-in (and optionally the Sequoyah Android Native Support plug-ins)

2. Import existing project into the workspace, and choose the mupen64plus-ae folder

3. If using Sequoyah, right-click on the mupen64plus-ae project and choose "Android->Add native support"

4. Check the paths to the SDK and NDK

Building from the command line:

1. Navigate to the mupen64plus-ae folder

2. Run "ndk-build" to generate the native libraries

3. Run "ant debug" (or "ant release") to generate the .apk file(s)
Mupen64Plus, Android Edition (AE) is an Android user interface for Mupen64Plus.

Please visit [the official forum]( for support and discussion.

Build Instructions

For now, we recommend using Eclipse rather than Android Studio, since the project contains a heavy mix of C, C++, and Java source code.

1. Download and install the prerequisites
- [Android SDK](
- [Android NDK](
- [Eclipse ADT plugin](
2. Clone the mupen64plus-ae repository and initialize the working copy
- `git clone`
- `cp .project.init .project`
3. Import the Eclipse project and dependencies
- Open Eclipse
- Select File → Import → Android → Existing Android Code Into Workspace, and press Next
- Browse to root of cloned repository, and press OK
- Select all projects, and press Finish
4. Add native support to the Eclipse project
- Right-click the mupen64plus-ae project in the Eclipse Package Explorer window
- Select Android Tools → Add Native Support...
- Accept the default library name (mupen64plus-ae), and press Finish
- Delete the unneeded generated C++ file: `rm jni/mupen64plus-ae.cpp`
5. Build and run the app from Eclipse
- Select the mupen64plus-ae project in the Eclipse Package Explorer window
- Select Run → Run

0 comments on commit 96cfe3c

Please sign in to comment.
You can’t perform that action at this time.