Overdue third party cleanup. (#11)

* Remove prebuilt binaries and old build scripts. * Remove Python 2.7.5 x86_64 redistribution. * Cleanup markdown presentation.
webbju · Oct 24, 2020 · 6d60276 · 6d60276
1 parent d797770
commit 6d60276
Show file tree

Hide file tree

Showing 1,867 changed files with 68 additions and 584,601 deletions.
diff --git a/readme.txt → LICENSE.md b/readme.txt → LICENSE.md
@@ -1,23 +1,8 @@
+Copyright (C) 2013-2015 NaturalMotion Limited. Used under licence.
 
-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.
+Code written by Justin Webb.
 
-  http://www.android-plus-plus.com
-
---------------------------------------------------------------------------------------------------------------------------------
-
- - For versioning and change-list info, refer to 'docs/changes.txt'.
-
- - If you're new to Android++, or need help installing, please read 'docs/getting_started.txt'.
-
---------------------------------------------------------------------------------------------------------------------------------
-
-Copyright (C) 2013-2015 NaturalMotion Limited. Used under licence. 
-
-Code written by Justin Webb. 
-
-Licence granted by Justin Webb with the permission of NaturalMotion Limited. 
+Licence granted by Justin Webb with the permission of NaturalMotion Limited.
 
 No rights are granted by NaturalMotion Limited under this licence.
 
@@ -30,10 +15,3 @@ Permission is granted to anyone to use this software for any purpose, including
 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
 3. This notice may not be removed or altered from any source distribution.
-
---------------------------------------------------------------------------------------------------------------------------------
-
-Thank you for your support.
-
-Justin Webb 
-webbju@android-plus-plus.com
diff --git a/README.md b/README.md
@@ -0,0 +1,65 @@
+# 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.
diff --git a/bin/v12.0/.gitignore b/bin/v12.0/.gitignore
diff --git a/bin/v12.0/AndroidPlusPlus.Common.dll b/bin/v12.0/AndroidPlusPlus.Common.dll
diff --git a/bin/v12.0/AndroidPlusPlus.Common.pdb b/bin/v12.0/AndroidPlusPlus.Common.pdb
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugCommon.dll b/bin/v12.0/AndroidPlusPlus.VsDebugCommon.dll
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugCommon.pdb b/bin/v12.0/AndroidPlusPlus.VsDebugCommon.pdb
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugEngine.dll b/bin/v12.0/AndroidPlusPlus.VsDebugEngine.dll
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugEngine.pdb b/bin/v12.0/AndroidPlusPlus.VsDebugEngine.pdb
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugLauncher.dll b/bin/v12.0/AndroidPlusPlus.VsDebugLauncher.dll
diff --git a/bin/v12.0/AndroidPlusPlus.VsDebugLauncher.pdb b/bin/v12.0/AndroidPlusPlus.VsDebugLauncher.pdb
diff --git a/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.dll b/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.dll
diff --git a/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.pdb b/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.pdb
diff --git a/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.pkgdef b/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.pkgdef
diff --git a/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.vsix b/bin/v12.0/AndroidPlusPlus.VsIntegratedPackage.vsix
diff --git a/bin/v14.0/.gitignore b/bin/v14.0/.gitignore
diff --git a/bin/v14.0/AndroidPlusPlus.Common.dll b/bin/v14.0/AndroidPlusPlus.Common.dll
diff --git a/bin/v14.0/AndroidPlusPlus.Common.pdb b/bin/v14.0/AndroidPlusPlus.Common.pdb
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugCommon.dll b/bin/v14.0/AndroidPlusPlus.VsDebugCommon.dll
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugCommon.pdb b/bin/v14.0/AndroidPlusPlus.VsDebugCommon.pdb
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugEngine.dll b/bin/v14.0/AndroidPlusPlus.VsDebugEngine.dll
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugEngine.pdb b/bin/v14.0/AndroidPlusPlus.VsDebugEngine.pdb
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugLauncher.dll b/bin/v14.0/AndroidPlusPlus.VsDebugLauncher.dll
diff --git a/bin/v14.0/AndroidPlusPlus.VsDebugLauncher.pdb b/bin/v14.0/AndroidPlusPlus.VsDebugLauncher.pdb
diff --git a/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.dll b/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.dll
diff --git a/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.pdb b/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.pdb
diff --git a/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.pkgdef b/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.pkgdef
diff --git a/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.vsix b/bin/v14.0/AndroidPlusPlus.VsIntegratedPackage.vsix
diff --git a/build/build_snapshot_all.cmd b/build/build_snapshot_all.cmd
diff --git a/build/build_snapshot_tests.cmd b/build/build_snapshot_tests.cmd
diff --git a/contrib/python-x86_64/bin/2to3 b/contrib/python-x86_64/bin/2to3
diff --git a/contrib/python-x86_64/bin/idle b/contrib/python-x86_64/bin/idle
diff --git a/contrib/python-x86_64/bin/libpython2.7.dll b/contrib/python-x86_64/bin/libpython2.7.dll
diff --git a/contrib/python-x86_64/bin/pydoc b/contrib/python-x86_64/bin/pydoc
diff --git a/contrib/python-x86_64/bin/python-config b/contrib/python-x86_64/bin/python-config
diff --git a/contrib/python-x86_64/bin/python-config.sh b/contrib/python-x86_64/bin/python-config.sh
diff --git a/contrib/python-x86_64/bin/python.exe b/contrib/python-x86_64/bin/python.exe
diff --git a/contrib/python-x86_64/bin/python2-config b/contrib/python-x86_64/bin/python2-config
diff --git a/contrib/python-x86_64/bin/python2.7-config b/contrib/python-x86_64/bin/python2.7-config
diff --git a/contrib/python-x86_64/bin/python2.7.exe b/contrib/python-x86_64/bin/python2.7.exe
diff --git a/contrib/python-x86_64/bin/python2.exe b/contrib/python-x86_64/bin/python2.exe