From 8f2eabb5e4518adc19372b2220fa37a8d819dac0 Mon Sep 17 00:00:00 2001 From: Rich Slogar Date: Thu, 18 Dec 2014 10:26:59 -0800 Subject: docs: renderscript using gradle settings b/13532631 Change-Id: I35808faf3fae8706ca6f9e46408c791594ab1467 --- docs/html/guide/topics/renderscript/compute.jd | 107 ++++++++++++++++++------- docs/html/tools/support-library/features.jd | 5 +- 2 files changed, 81 insertions(+), 31 deletions(-) (limited to 'docs') diff --git a/docs/html/guide/topics/renderscript/compute.jd b/docs/html/guide/topics/renderscript/compute.jd index 2e7ce56..eef8cda 100644 --- a/docs/html/guide/topics/renderscript/compute.jd +++ b/docs/html/guide/topics/renderscript/compute.jd @@ -185,50 +185,101 @@ precision (such as SIMD CPU instructions).

You can check and update the installed version of these tools in the Android SDK Manager.

-

- Note: Use of Support Library RenderScript APIs is not currently supported with - Android Studio or Gradle-based builds. -

-

To use the Support Library RenderScript APIs in Eclipse:

+

To use the Support Library RenderScript APIs:

  1. Make sure you have the required Android SDK version and Build Tools version installed.
    2. -
  2. Open the {@code project.properties} file in the root folder of your application project.
    3. -
  3. Add the following lines to the file: +
  4. Update the settings for the Android build process to include the RenderScript settings: + +

    For Android Studio or Gradle-based builds

    +
      +
    • Open the {@code build.gradle} file in the app folder of your application module.
      • +
    • Add the following RenderScript settings to the file: + +
      +android {
+    compileSdkVersion 19
+    buildToolsVersion "19.0.3"
+
+    defaultConfig {
+        minSdkVersion 8
+        targetSdkVersion 16
+
+        renderscriptTargetApi 18
+        renderscriptSupportModeEnabled true
+
+    }
+}
+
      + + +

      The settings listed above control specific behavior in the Android build process:

      + +
        +
      • {@code renderscriptTargetApi} - Specifies the bytecode version to be generated. We + recommend you set this value to the highest available API level and set + {@code renderscriptSupportModeEnabled} + to {@code true}. Valid values for this setting are any integer value + from 11 to the most recently released API level. If your minimum SDK version specified in your + application manifest is set to a different value, that value is ignored and the target value + in the build file is used to set the minimum SDK version.
        • +
      • {@code renderscriptSupportModeEnabled} - Specifies that the generated bytecode should fall + back to a compatible version if the device it is running on does not support the target + version. +
        • +
      • {@code buildToolsVersion} - The version of the Android SDK build tools to use. This value + should be set to {@code 18.1.0} or higher. If this option is not specified, the highest + installed build tools version is used. You should always set this value to ensure the + consistency of builds across development machines with different configurations.
        • +
      + +
      • + +

      For Eclipse

      +
        +
      • Open the {@code project.properties} file in the root folder of your application project.
        • +
      • Add the following lines to the file: + 
         renderscript.target=18
 renderscript.support.mode=true
 sdk.buildtools=18.1.0
        -
        • + +

        The settings listed above control specific behavior in the Android build process:

        + +
          +
        • {@code renderscript.target} - Specifies the bytecode version to be generated. We + recommend you set this value to the highest available API level and set + {@code renderscript.support.mode} to {@code true}. Valid values for this setting are any + integer value from 11 to the most recently released API level. If your minimum SDK version + specified in your application manifest is set to a higher value, this value is ignored and + the target value is set to the minimum SDK version.
          • +
        • {@code renderscript.support.mode} - Specifies that the generated bytecode should fall + back to a compatible version if the device it is running on does not support the target version. +
          • +
        • {@code sdk.buildtools} - The version of the Android SDK build tools to use. This value + should be set to {@code 18.1.0} or higher. If this option is not specified, the highest + installed build tools version is used. You should always set this value to ensure the + consistency of builds across development machines with different configurations.
          • +
        + + +
      + +
    +
  5. In your application classes that use RenderScript, add an import for the Support Library classes: + 
     import android.support.v8.renderscript.*;
    -
    6. -
-

The {@code project.properties} settings listed above control specific behavior in the Android - build process:

- - + +

Using RenderScript from Java Code

diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd index 079dd71..9738235 100644 --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -379,9 +379,8 @@ com.android.support:recyclerview-v7:21.0.+ developer guide.

- Note: Use of RenderScript with the support library is supported with the Android - Eclipse plugin and Ant build tools. It is not currently supported with Android Studio or - Gradle-based builds. + Note: Use of RenderScript with the support library is supported with Android + Studio and Gradle-based builds, as well as the Eclipse plugin and Ant build tools.

-- cgit v1.1