Update Android Apps to use gradle

site/user/quick/android.md

 Android
 =======
 
 Prerequisites
 -------------
 
 _Currently we only support building Skia for Android on a Linux or Mac host!_
 
 The following libraries/utilities are required in addition to those needed for a standard skia checkout:
 
-  * Apache Ant
   * The Android SDK: http://developer.android.com/sdk/
 
-~~~~
-$ sudo apt-get install ant git
-~~~~
-
 Check out the source code
 -------------------------
 
-Follow the instructions [here](../download) for downloading the Skia source. Modify .gclient to add the following line to
-the bottom, and then run gclient sync again:
-
-    target_os = ["android"]
+Follow the instructions [here](../download) for downloading the Skia source. 
 
 Inside your Skia checkout, `platform_tools/android` contains the Android setup
 scripts, Android specific dependencies, and the Android Sample App.
 
 Setup the Android SDK
 ---------------------
 
 To finish setting up the Android SDK you need to download use the SDK to
 download the appropriate API level.  To do this simply go to the directory
 where you installed the SDK and run the following commands
@@ skipping 19 matching lines @@
 Custom Android Build Script
 ---------------------------
 
 The android_ninja script is a wrapper for the ninja command (provided by
 depot_tools) and is specifically designed to work with the Skia's build
 system. To use the script you need to call it from Skia's trunk directory with
 the -d option plus any of the options or arguments you would normally pass to
 ninja (see descriptions of some of the other flags here).
 
     export ANDROID_SDK_ROOT=/path/to/android/sdk
+    export ANDROID_HOME=/path/to/android/sdk
     export PATH=$PATH:/path/to/depot_tools
 
     cd skia
     ./platform_tools/android/bin/android_ninja -d nexus_10 # or nexus_7, galaxy_nexus, etc...
 
 The -d option enables the build system to target the build to a specific
 architecture such as MIPS (generic), x86 (generic) and ARM (generic and device
 specific flavors for Nexus devices). This in turn allows Skia to take
 advantage of specific device optimizations (e.g. NEON instructions).
 
@@ skipping 52 matching lines @@
 approach will also produce the noisiest results.
 
     # <input> is file/dir on device
     ./platform_tools/android/bin/android_run_skia --release nanobench --skps <input>
 
 Build and run SampleApp
 -----------------------
 
 The SampleApp on Android provides a simple UI for viewing sample slides and gm images.
 
-    BUILDTYPE=Debug ./platform_tools/android/bin/android_ninja -d $TARGET_DEVICE
+    BUILDTYPE=Debug ./platform_tools/android/bin/android_ninja -d $TARGET_DEVICE SampleApp_APK
 
 Then, install the app onto the device:
 
     ./platform_tools/android/bin/android_install_app
 
 Finally to run the application you can either navigate to the Skia Samples
 application using the application launcher on your device or from the command
 line.  The command line option allows you to pass additional details to the
 application (similiar to other operating system) that specify where to find
 skp files and other resources.
 
     ./platform_tools/android/bin/android_launch_app --resourcePath /data/local/tmp/resources
 
 By default if no additional parameters are specified the app will use the default
 params...
 
     --resourcePath /data/local/tmp/skia_resoures 
     --pictureDir /data/local/tmp/skia_skp
 
+
+Android Studio Support
+-----------------------
+
+You can also build and run SampleApp (and some other experimental apps) using Android
+Studio.  To create the project either select "import project" from the quickstart
+screen or use File -> Open.  In both cases you'll need to select ./platform_tools/android/apps
+as the root directory of your project.
+
+Finally to be able to build within Android studio it needs to know the path to 
+ninja so you will need to add a properties file and populate it with the path
+to depot_tools.  The syntax and location of that file is...
+ 
+    # 
+    # file location: ./platform_tools/android/apps/gradle.properties
+    #
+    depot_tools.dir=<path_to_depot_tools>
+    
+That should be all the setup you need.  You should now be able to build and deploy
+SampleApp on ARM and Intel devices.

[scroggo, 2015/07/08 18:39:35]

Why do we specify particular chipsets?

[djsollen, 2015/07/08 18:49:47]

because those are the only variants I added to Android Studio and I thought it
might be helpful to call that out.  However, I don't have a strong leaning
either way.

+
+
 Build tools
 -----------
 
 The Android platform does not support skdiff at this time.
 
 Clean up all generated files
 ----------------------------
 
     make clean
 
@@ skipping 11 matching lines @@
     # include additional arguments in quotes (e.g. "dm --nopdf")
     ./platform_tools/android/bin/android_gdb_native dm
     
     # SAMPLE APP
     # make sure you've installed the app on the device first
     ./platform_tools/android/bin/android_gdb_app
 
 When the gdb client is ready, insert a breakpoint, and continue to let the
 program resume execution.