Added text for Android Eclipse deprecation to be replaced with Android Studio

Author: John Wolf

4_Android/android_examples.md

@@ -3,23 +3,23 @@ ARToolKit includes a number of fully-working examples on Android that demonstrat
 
 The examples are divided into 3 sets.
 
-1.  Java-based: examples where all user-developed code is in Java, and is based on the provided ARBaseLib classes.
-2.  Mixed Java/C/C++: examples where user-developed code is split between the Java environment and native C/C++ (NDK) environment. Code can use the provided ARBaseLib java classes while also addressing ARToolKit in C/C++ via the libARWrapper C/C++ API.
-3.  C/C++-based: examples where most of the user-developed code is native C/C++ (NDK). These examples offer the greatest power to the AR developer and direct access to the full native ARToolKit API.
+1.  All Java-based: examples where all user-developed code is in Java, and is based on the provided ARBaseLib classes.
+2.  Mixed Java and native C/C++ using Android NDK: examples where user-developed code is split between the Java environment and native C/C++ environment. Code can use the provided ARBaseLib java classes while also addressing ARToolKit in C/C++ via the libARWrapper C/C++ API.
+3.  AR and rendering code in native C/C++ using Android NDK: examples where most of the user-developed code is native C/C++. These examples offer the greatest power to the AR developer and direct access to the full native ARToolKit API.
 
 The examples are as follows:
 
-##Java-based
+##All Java-based
 
 -   **ARSimple**: An example that extends the ARActivity class in ARBaseLib to create a simple augmented reality application.
 -   **ARSimpleInteraction**: An example that adds simple interaction to ARSimple.
 
-##Mixed Java/C/C++
+##Mixed Java and Native C/C++ Using Android NDK
 
 -   **ARSimpleNative**: An example that uses an additional native library to perform rendering in C rather than Java.
 -   **ARSimpleNativeCars**: An example that uses a native OBJ model loader.
 
-##AR and rendering code in C/C++
+##AR and Rendering Code in Native C/C++ Using Android NDK
 
 -   **ARNative**: An example that uses the ARToolKit libraries directly and renders with OpenGL.
 -   **ARNativeOSG**: An example that uses the ARToolKit libraries directly and loads and renders 3D model content using the advanced OpenSceneGraph framework.

4_Android/android_native.md

@@ -9,22 +9,25 @@ Building native static and shared ARToolKit libraries requires a development env
 The following SDKs and tools should be installed and configured correctly. These are required for standard Android JDK development:
 
 - [Java Development Kit][1]
-- [Eclipse IDE][2]
-- [Android SDK][3]
-- [ADT Plugin for Eclipse][4]
+- [Android SDK][2] (Installed with Android Studio IDE to "/Users/\<user\>/Library/Android/sdk")
+- [Android Studio IDE][3]
+- [Eclipse IDE][4] - deprecated
+- [ADT Plugin for Eclipse][5] - deprecated
 
 And these extras are required for building native code with the NDK in Eclipse:
 
-- CDT Plugin for Eclipse (install from within Eclipse).
-- [Android NDK][5]
-- [Android NDK plugin for Eclipse][6]
+- [Android NDK Preview][6] (download the NDK that works with Android Studio IDE)
+- CDT Plugin for Eclipse (install from within Eclipse) - deprecated
+- [Android NDK plugin for Eclipse][7] - deprecated
 
-On Windows, NDK development is possible using [Cygwin][7], which provides a Linux-type environment. When installing Cygwin, ensure that the "make" package under "Devel" is selected, as this is required by the NDK and may not be installed by default.
+On Windows, NDK development is possible using [Cygwin][8], which provides a Linux-type environment. When installing Cygwin, ensure that the "make" package under "Devel" is selected, as this is required by the NDK and may not be installed by default.
 
 Please ensure you have a working SDK and NDK environment before continuing.
 
+To help with the Eclipse to Android Studio transition, in the GitHub "artookit5" repository, see the [document][9]:<br/>"\<repo root\>/AndroidStudioProjects/Docs/AS_Migration.pdf."
+
 ##Building Native Libraries
-Each native library in the SDK, whether core library or example, includes a Windows batch file called build.bat that automatically configures and initiates the build. The build.bat file first calls the SetNDKBuildVars.bat file in the SDK root directory. This batch file sets some environment variables that are required for the build process, including the paths to the various tools and SDKs listed above. Naturally, these paths will differ from machine to machine, so it is important to edit this file to match the current development environment. Until this file has been configured, an error message will appear, as shown below.
+Each native library in the SDK, whether core library or example, includes a Windows batch file called build.bat that automatically configures and initiates the build. The build.bat file first calls the SetNDKBuildVars.bat file, both located in the "android" folder directly off the root folder of the "artoolkit5" SDK or repository. This batch file sets some environment variables that are required for the build process, including the paths to the various tools and SDKs listed above. Naturally, these paths will differ from machine to machine, so it is important to edit this file to match the current development environment. Until this file has been configured, an error message will appear, as shown below.
 
 ![set_ndk_build_vars][set_ndk_build_vars]
 
@@ -41,14 +44,16 @@ When the build completes, there will be new shared libraries in `ARToolKitWrappe
 To use this native library in your own Android application, you will need to copy the libs directory to your Android application project directory. ![right][libs_directory]
 
 [1]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
-[2]: http://www.eclipse.org/
+[2]: http://developer.android.com/sdk/index.html
 [3]: http://developer.android.com/sdk/index.html
-[4]: http://developer.android.com/sdk/eclipse-adt.html
-[5]: http://developer.android.com/sdk/ndk/index.html
-[6]: http://tools.android.com/recent/usingthendkplugin
-[7]: http://www.cygwin.com
-[android_developing]: 4_Android:android_developing
+[4]: http://www.eclipse.org/
+[5]: http://developer.android.com/sdk/eclipse-adt.html
+[6]: http://tools.android.com/tech-docs/android-ndk-preview
+[7]: http://tools.android.com/recent/usingthendkplugin
+[8]: http://www.cygwin.com
+[9]: https://github.com/artoolkit/artoolkit5/blob/master/AndroidStudioProjects/Docs/AS_Migration.pdf
 
+[android_developing]: 4_Android:android_developing
 [set_ndk_build_vars]: :set_ndk_build_vars.png
 [set_ndk_build]: :set_ndk_build.png
 [libs_directory]: :libs_directory.png