https://github.com/webbju/android-plus-plus

Android++ -- A native development and debugging solution for Visual Studio.
https://github.com/webbju/android-plus-plus

android build-tool cplusplus debugging-tool java msbuild ndk visual-studio

Last synced: 11 days ago
JSON representation

Android++ -- A native development and debugging solution for Visual Studio.

• Host: GitHub
• URL: https://github.com/webbju/android-plus-plus
• Owner: webbju
• License: other
• Created: 2016-01-04T08:21:08.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2025-06-03T18:46:17.000Z (9 months ago)
• Last Synced: 2025-07-08T21:39:53.326Z (7 months ago)
• Topics: android, build-tool, cplusplus, debugging-tool, java, msbuild, ndk, visual-studio
• Language: C#
• Homepage:
• Size: 192 MB
• Stars: 534
• Watchers: 52
• Forks: 79
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# 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: ``

     * name: `ANDROID_NDK`, value: ``

     * name: `JAVA_HOME`, value: ``

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.