Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 372b3238 authored by Rich Slogar's avatar Rich Slogar Committed by Android Git Automerger
Browse files

am fd65b95c: am 3851b473: am 389d5ac6: am 353232ec: am b97afd41: am a27dd186:...

am fd65b95c: am 3851b473: am 389d5ac6: am 353232ec: am b97afd41: am a27dd186: am e78f136b: Merge "docs: renderscript using gradle settings" into lmp-docs

* commit 'fd65b95c':
  docs: renderscript using gradle settings
parents 1b1de8be fd65b95c
Loading
Loading
Loading
Loading
+79 −28
Original line number Diff line number Diff line
@@ -185,41 +185,77 @@ precision (such as SIMD CPU instructions).</p>
<p>You can check and update the installed version of these tools in the
  <a href="{@docRoot}tools/help/sdk-manager.html">Android SDK Manager</a>.</p>

<p class="note">
  <strong>Note:</strong> Use of Support Library RenderScript APIs is not currently supported with
  Android Studio or Gradle-based builds.
</p>

<p>To use the Support Library RenderScript APIs in Eclipse:</p>
<p>To use the Support Library RenderScript APIs:</p>

<ol>
  <li>Make sure you have the required Android SDK version and Build Tools version installed.</li>
  <li> Update the settings for the Android build process to include the RenderScript settings:

    <p><strong>For Android Studio or Gradle-based builds</strong></p>
    <ul>
      <li>Open the {@code build.gradle} file in the app folder of your application module. </li>
      <li>Add the following RenderScript settings to the file:

<pre>
android {
    compileSdkVersion 19
    buildToolsVersion "19.0.3"

    defaultConfig {
        minSdkVersion 8
        targetSdkVersion 16
<strong>
        renderscriptTargetApi 18
        renderscriptSupportModeEnabled true
</strong>
    }
}
</pre>


    <p>The settings listed above control specific behavior in the Android build process:</p>

    <ul>
      <li>{@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.</li>
      <li>{@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.
      </li>
      <li>{@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.</li>
    </ul>

    </li>

    <p><strong>For Eclipse</strong></p>
    <ul>
      <li>Open the {@code project.properties} file in the root folder of your application project.</li>
      <li>Add the following lines to the file:

<pre>
renderscript.target=18
renderscript.support.mode=true
sdk.buildtools=18.1.0
</pre>
  </li>
  <li>In your application classes that use RenderScript, add an import for the Support Library
    classes:
<pre>
import android.support.v8.renderscript.*;
</pre>
  </li>
</ol>

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

      <ul>
        <li>{@code renderscript.target} - Specifies the bytecode version to be generated. We
    recommend you set this value 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.</li>
        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.</li>
        <li>{@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.
        </li>
@@ -228,7 +264,22 @@ import android.support.v8.renderscript.*;
        installed build tools version is used. You should always set this value to ensure the
        consistency of builds across development machines with different configurations.</li>
      </ul>
     </li>

    </ul>

  </ul>

  <li>In your application classes that use RenderScript, add an import for the Support Library
    classes:

<pre>
import android.support.v8.renderscript.*;
</pre>

  </li>

 </0l>

<h2 id="using-rs-from-java">Using RenderScript from Java Code</h2>

+2 −3
Original line number Diff line number Diff line
@@ -373,9 +373,8 @@ com.android.support:recyclerview-v7:21.0.0
  developer guide.</p>

<p class="note">
  <strong>Note:</strong> Use of RenderScript with the support library is supported with the Android
  Eclipse plugin and Ant build tools. It is <em>not currently</em> supported with Android Studio or
  Gradle-based builds.
  <strong>Note:</strong> 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.
</p>