Skip to content

webbju/android-plus-plus

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

Android++ (android-plus-plus)

Android++ is a freely distributed extension and associated MSBuild scripts designed to enable Android application development within Visual Studio. Primarily for NDK based C/C++ applications, it also incorporates customisable deployment, resource management, and integrated Java source compilation.

Getting Started

Prerequisites:
  • Android SDK (http://developer.android.com/sdk/)

    • Please avoid installing to a path which contains spaces.
  • Android NDK (https://developer.android.com/tools/sdk/ndk/)

    • Please avoid installing to a path which contains spaces.
    • Compatibility tested with NDK r9d, r10, r10b, r10c and r10d.
  • Java Development Kit (JDK) 1.7 or 1.8

    • If using JDK 1.7, please ensure you are using a revision of at least 67.
    • If using JDK 1.8, please ensure you are using a revision of at least 21.
    • Early revisions of JDK 1.7 tend to cause devices to hang when debugging.
Installation:
  1. Create several new environment variables to reference installations of the SDK, NDK, and JDK.

    • Open your computer's 'Control Panel'.
      • If viewing items by category, follow 'System and Security' -> 'System'.
      • If viewing items by icon, just click 'System'.
    • Click 'Advanced System Settings' (left panel). This should open a 'System Properties'.
    • Select the 'Advanced' tab, and click 'Environment Variables'.
    • Add the following new user or system variables:
      • name: ANDROID_SDK, value: <path_to_sdk_root>
      • name: ANDROID_NDK, value: <path_to_ndk_root>
      • name: JAVA_HOME, value: <path_to_java_jdk_root>
  2. Close all instances of Visual Studio and any Command Prompt windows.

  3. Bootstrap for one (or more) instances of Visual Studio using the bootstrap_vs*.cmd scripts in Android++'s root.

    • Scripts are separated by version to allow for improved customisation/testing.
    • More advanced scripts can be found in the ./bootstrap/ directory. These allow more fine grain control.
    • Installation of Visual Studio extensions in is a little unpredictable, be sure to uninstall any existing registered extensions before upgrading. Look in ./bootstrap/ for these scripts.
    • Improved automation of the upgrade process will follow in later releases.
  4. Build a sample. See below.

Building and running 'hello-gdbserver' sample:
  1. Find bundled projects located under msbuild/samples from the root of your Android++ installation.

  2. Build the hello-gdbserver project. This is a tiny application to force a segmentation fault.

  3. Ensure 'hello-gdbserver' is set as the launch project. This is indicated by the project name being represented in bold.

    • If it's not bold, right-click the project in the 'Solution Explorer' pane and select 'Set as StartUp Project'.
  4. Run the project. Press F5 or select 'Debug -> Start Debugging'.

  5. A 'Configuring Android++' dialog should appear. Installation and connection status can be monitored here.

    • A 'Waiting for Debugger' prompt should also appear on the device. When this disappears, JDB has successfully connected.
    • As the ADB protocol is slow, installation times can be lengthy for large APKs - and vary with target device.
    • If you experience any errors, please first consult ./docs/troubleshooting.txt.
  6. Wait for connection to be finalised. On device you should see a large button labelled 'Induce Crash'. Press it.

  7. Visual Studio should alert you that a 'Segmentation Fault' has occurred. Click 'Break' to see its location in native code.