diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/html/guide/topics/renderscript/compute.jd | 83 | ||||
| -rw-r--r-- | docs/html/sdk/index.jd | 54 | ||||
| -rw-r--r-- | docs/html/sdk/installing/installing-adt.jd | 8 | ||||
| -rw-r--r-- | docs/html/tools/sdk/eclipse-adt.jd | 44 | ||||
| -rw-r--r-- | docs/html/tools/sdk/tools-notes.jd | 66 | ||||
| -rw-r--r-- | docs/html/tools/support-library/features.jd | 21 | ||||
| -rw-r--r-- | docs/html/tools/support-library/index.jd | 1 |
7 files changed, 232 insertions, 45 deletions
diff --git a/docs/html/guide/topics/renderscript/compute.jd b/docs/html/guide/topics/renderscript/compute.jd index 607d16e..14a1682 100644 --- a/docs/html/guide/topics/renderscript/compute.jd +++ b/docs/html/guide/topics/renderscript/compute.jd @@ -10,6 +10,11 @@ parent.link=index.html <ol> <li><a href="#writing-an-rs-kernel">Writing a RenderScript Kernel</a></li> + <li><a href="#access-rs-apis">Accessing RenderScript Java APIs</a> + <ol> + <li><a href="#ide-setup">Setting Up Your Development Environment</a></li> + </ol> + </li> <li><a href="#using-rs-from-java">Using RenderScript from Java Code</a></li> </ol> @@ -144,9 +149,85 @@ different level of floating point precision:</p> beneficial on some architectures due to additional optimizations only available with relaxed precision (such as SIMD CPU instructions).</p> + +<h2 id="access-rs-apis">Accessing RenderScript Java APIs</h2> + +<p>When developing an Android application that uses RenderScript, you can access its Java API in + one of two ways. The APIs are available in the {@link android.renderscript} package + on devices running Android 3.0 (API level 11) and higher. These are the original APIs for + RenderScript. The APIs are also available as a Support Library in the + {@link android.support.v8.renderscript} package, which allow you to use them on devices running + Android 2.2 (API level 8) and higher.</p> + +<p>We strongly recommend using the Support Library APIs for accessing RenderScript because they + include the latest improvements to the RenderScript compute framework and provide a wider range + of device compatibility. Using the RenderScript APIs in the Support Library requires specific + setup procedures for your development environment, which is described in the next section.</p> + + +<h3 id="ide-setup">Using the RenderScript Support Library APIs</h3> + +<p>In order to use the Support Library RenderScript APIs, you must configure your development + environment to be able to access them. The following Android SDK tools are required for using + these APIs:</p> + +<ul> + <li>Android SDK Tools revision 22.2 or higher</li> + <li>Android SDK Build-tools revision 18.1.0 or higher</li> +</ul> + +<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> + +<ol> + <li>Make sure you have the required Android SDK version and Build Tools version installed.</li> + <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> + +<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> + <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> + <li>{@code sdk.buildtools} - The version of the Android SDK build tools to use. This value + should be set to 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> + + <h2 id="using-rs-from-java">Using RenderScript from Java Code</h2> -<p>Using RenderScript from Java code relies on the {@link android.renderscript} APIs. Most +<p>Using RenderScript from Java code relies on the API classes located in the +{@link android.renderscript} or the {@link android.support.v8.renderscript} package. Most applications follow the same basic usage patterns:</p> <ol> diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index 4ea3752..0581435 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -5,43 +5,43 @@ header.hide=1 page.metaDescription=Download the official Android SDK to develop apps for Android-powered devices. -sdk.linux32_bundle_download=adt-bundle-linux-x86-20130729.zip -sdk.linux32_bundle_bytes=457716139 -sdk.linux32_bundle_checksum=b3686d10dc1cbceba1074404d4386283 +sdk.linux32_bundle_download=adt-bundle-linux-x86-20130911.zip +sdk.linux32_bundle_bytes=474916528 +sdk.linux32_bundle_checksum=7eacc7124299ea99a8fa15c59123540f -sdk.linux64_bundle_download=adt-bundle-linux-x86_64-20130729.zip -sdk.linux64_bundle_bytes=458006784 -sdk.linux64_bundle_checksum=1fabcc3f772ba8b2fc194d6e0449da17 +sdk.linux64_bundle_download=adt-bundle-linux-x86_64-20130911.zip +sdk.linux64_bundle_bytes=475207785 +sdk.linux64_bundle_checksum=daa5794a27be7c7fa708c3d28833b0d3 -sdk.mac64_bundle_download=adt-bundle-mac-x86_64-20130729.zip -sdk.mac64_bundle_bytes=428792424 -sdk.mac64_bundle_checksum=6c42b9966abcfa8a75c0ee83d0d95882 +sdk.mac64_bundle_download=adt-bundle-mac-x86_64-20130911.zip +sdk.mac64_bundle_bytes=448575446 +sdk.mac64_bundle_checksum=a1e0cbcc820ae734cfdf439c40811b4c -sdk.win32_bundle_download=adt-bundle-windows-x86-20130729.zip -sdk.win32_bundle_bytes=463931746 -sdk.win32_bundle_checksum=51faf4e5fdf9c5b4a176179a99ce3511 +sdk.win32_bundle_download=adt-bundle-windows-x86-20130911.zip +sdk.win32_bundle_bytes=481794820 +sdk.win32_bundle_checksum=88a2f4f242aac44f4b1c53e6eccc8710 -sdk.win64_bundle_download=adt-bundle-windows-x86_64-20130729.zip -sdk.win64_bundle_bytes=464064756 -sdk.win64_bundle_checksum=e8f05c1fddb8e609e880de23113c7426 +sdk.win64_bundle_download=adt-bundle-windows-x86_64-20130911.zip +sdk.win64_bundle_bytes=481927327 +sdk.win64_bundle_checksum=e3fa9b7e38af9ed9ac0e99fce3c7026c -sdk.linux_download=android-sdk_r22.0.5-linux.tgz -sdk.linux_bytes=105641005 -sdk.linux_checksum=8201b10c21510f082c54f58a9bb082c8 +sdk.linux_download=android-sdk_r22.2-linux.tgz +sdk.linux_bytes=100909403 +sdk.linux_checksum=2a3776839e823ba9acb7a87a3fe26e02 -sdk.mac_download=android-sdk_r22.0.5-macosx.zip -sdk.mac_bytes=77225724 -sdk.mac_checksum=94f3cbe896c332b94ee0408ae610a4b8 +sdk.mac_download=android-sdk_r22.2-macosx.zip +sdk.mac_bytes=74857114 +sdk.mac_checksum=9dfef6404e2f842c433073796aed8b7d -sdk.win_download=android-sdk_r22.0.5-windows.zip -sdk.win_bytes=113510621 -sdk.win_checksum=30695dffc41e0d7cf9ff948ab0c48920 +sdk.win_download=android-sdk_r22.2-windows.zip +sdk.win_bytes=108790714 +sdk.win_checksum=1ac4c104378cd53049daa6c4458ec544 -sdk.win_installer=installer_r22.0.5-windows.exe -sdk.win_installer_bytes=93505782 -sdk.win_installer_checksum=940849be19ac6151e3e35c8706c81d86 +sdk.win_installer=installer_r22.2-windows.exe +sdk.win_installer_bytes=88788974 +sdk.win_installer_checksum=e5503fa059297d2b18475c086ac6e80c diff --git a/docs/html/sdk/installing/installing-adt.jd b/docs/html/sdk/installing/installing-adt.jd index bdc07d0..e038d20 100644 --- a/docs/html/sdk/installing/installing-adt.jd +++ b/docs/html/sdk/installing/installing-adt.jd @@ -1,8 +1,8 @@ page.title=Installing the Eclipse Plugin -adt.zip.version=22.0.5 -adt.zip.download=ADT-22.0.5.zip -adt.zip.bytes=16839757 -adt.zip.checksum=1097fccf32063e3638a9d27aa0f295ca +adt.zip.version=22.2.0 +adt.zip.download=ADT-22.2.0.zip +adt.zip.bytes=14474195 +adt.zip.checksum=52892c9e3b1ad2d1e6edd50e48b2a127 @jd:body diff --git a/docs/html/tools/sdk/eclipse-adt.jd b/docs/html/tools/sdk/eclipse-adt.jd index e9c514e..151707a 100644 --- a/docs/html/tools/sdk/eclipse-adt.jd +++ b/docs/html/tools/sdk/eclipse-adt.jd @@ -57,6 +57,44 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <div class="toggle-content opened"> <p><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" + alt=""/>ADT 22.2</a> <em>(September 2013)</em> + </p> + + <div class="toggle-content-toggleme"> +<dl> + <dt>Dependencies:</dt> + + <dd> + <ul> + <li>Java 1.6 or higher is required.</li> + <li>Eclipse Helios (Version 3.6.2) or higher is required.</li> + <li>This version of ADT is designed for use with + <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r22.2</a>. + If you haven't already installed SDK Tools r22.2 into your SDK, use the + Android SDK Manager to do so.</li> + </ul> + </dd> + + <dt>General Notes:</dt> + <dd> + <ul> + <li>Updated build tools to allow use of RenderScript on older versions of Android + using new features in the + <a href="{@docRoot}tools/support-library/features.html#v8">Support Library</a>.</li> + <li>Reverted signing changes that sometimes trigger a signing verification problem on older + platforms.</li> + <li>Fixed problem with gradle export function for the Windows platform.</li> + </ul> + </dd> + +</dl> +</div> +</div> + + +<div class="toggle-content closed"> + <p><a href="#" onclick="return toggleContent(this)"> + <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt=""/>ADT 22.0.5</a> <em>(July 2013)</em> </p> @@ -78,7 +116,7 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <dt>General Notes:</dt> <dd> <ul> - <li>Fixed Renderscript compilation issue for Windows platforms.</li> + <li>Fixed RenderScript compilation issue for Windows platforms.</li> <li>Updated <a href="{@docRoot}tools/help/systrace.html">Systrace</a> report generation in the Monitor and DDMS perspectives.</li> </ul> @@ -113,7 +151,7 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <dt>General Notes:</dt> <dd> <ul> - <li>Fixed problem with compiling Renderscript code.</li> + <li>Fixed problem with compiling RenderScript code.</li> <li>Improved Gradle export with better workflow and error reporting.</li> <li>Improved Gradle multi-module export feature.</li> <li>Updated build logic to force exporting of the classpath containers unless you are using @@ -1005,7 +1043,7 @@ href="http://tools.android.com/recent/lint">more info</a>)</li> <dt>Bug fixes:</dt> <dd> <ul> - <li>Fixed build issue when using Renderscript in projects that target API levels 11-13 + <li>Fixed build issue when using RenderScript in projects that target API levels 11-13 (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li> <li>Fixed issue when creating projects from existing source code.</li> <li>Fixed issues in the SDK Manager diff --git a/docs/html/tools/sdk/tools-notes.jd b/docs/html/tools/sdk/tools-notes.jd index 4aef8a0..e8c4717 100644 --- a/docs/html/tools/sdk/tools-notes.jd +++ b/docs/html/tools/sdk/tools-notes.jd @@ -30,6 +30,54 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <div class="toggle-content opened"> <p><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" + alt=""/>SDK Tools, Revision 22.2</a> <em>(September 2013)</em> + </p> + + <div class="toggle-content-toggleme"> + + <dl> + <dt>Dependencies:</dt> + <dd> + <ul> + <li>Android SDK Platform-tools revision 16 or later.</li> + <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is + designed for use with ADT 22.2 and later. If you haven't already, update your + <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.2.</li> + <li>If you are developing outside Eclipse, you must have + <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li> + </ul> + </dd> + + <dt>General Notes:</dt> + <dd> + <ul> + <li>Updated build tools to allow use of RenderScript on older versions of Android + using new features in the + <a href="{@docRoot}tools/support-library/features.html#v8">Support Library</a>.</li> + <li>Moved the Systrace tool to the {@code >sdk</platform-tools/} directory. </li> + <li>Modified <a href="{@docRoot}tools/help/gltracer.html">Tracer for OpenGL ES</a> to + support OpenGL ES 3.0.</li> + <li>Lint + <ul> + <li>Fixed problem with lint not detecting custom namespaces. + (<a href="http://b.android.com/55673">Issue 55673</a>)</li> + <li>Fixed problem with the XML report including invalid characters. + (<a href="http://b.android.com/56205">Issue 56205</a>)</li> + <li>Fixed command-line execution of lint to work in headless mode to support execution + by build servers. (<a href="http://b.android.com/55820">Issue 55820</a>)</li> + </ul> + </li> + <li>Improved support for path names with spaces in the Windows command-line tools.</li> + </ul> + </dd> + </dl> + </div> +</div> + + +<div class="toggle-content closed"> + <p><a href="#" onclick="return toggleContent(this)"> + <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt=""/>SDK Tools, Revision 22.0.5</a> <em>(July 2013)</em> </p> @@ -55,10 +103,10 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <dt>General Notes:</dt> <dd> <ul> - <li>Fixed Renderscript compilation issue for Windows platforms with ant.</li> + <li>Fixed RenderScript compilation issue for Windows platforms with ant.</li> <li>Updated <a href="{@docRoot}tools/help/systrace.html">Systrace</a> to work with the Android 4.3 platform image.</li> - <li>Fixed packaging of Renderscript compiler.</li> + <li>Fixed packaging of RenderScript compiler.</li> <li>Build tools 18.0.0 is obsolete and 18.0.1 should be used instead.</li> </ul> </dd> @@ -95,7 +143,7 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues <dt>General Notes:</dt> <dd> <ul> - <li>Fixed problem with compiling Renderscript code.</li> + <li>Fixed problem with compiling RenderScript code.</li> </ul> </dd> </dl> @@ -274,17 +322,17 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues </ul> </li> - <li>Renderscript + <li>RenderScript <ul> <li>Added support for <a href="{@docRoot}guide/topics/renderscript/compute.html#filterscript">Filterscript</a> compilation.</li> - <li>Added new project setting to control the Renderscript compilation target separately + <li>Added new project setting to control the RenderScript compilation target separately from an Android project. Adding the following line to a {@code project.properties} - file causes Renderscript code to be compiled for Android API Level 17, while the + file causes RenderScript code to be compiled for Android API Level 17, while the containing application can target a different (lower) API level: <pre>renderscript.target = 17</pre> - Previously, the Renderscript compilation target was tied to the + Previously, the RenderScript compilation target was tied to the {@code android:minSdkVersion} setting in the manifest. (<a href="http://code.google.com/p/android/issues/detail?id=40487">Issue 40487</a>) </li> @@ -483,7 +531,7 @@ with GPU acceleration.</li> <li>Improved resize algorithm for better rendering on scaled emulator windows.</li> <li>Fixed a bug in the {@code lint} check for unprotected broadcast receivers to ignore unprotected receivers for default Android actions.</li> - <li>Fixed build issue for projects using Renderscript.</li> + <li>Fixed build issue for projects using RenderScript.</li> <li>Fixed memory leak in the emulator.</li> </ul> </dd> @@ -823,7 +871,7 @@ ignore attribute. (<a <li>Fixed emulator crash on Linux due to improper webcam detection (<a href="http://code.google.com/p/android/issues/detail?id=20952">Issue 20952</a>).</li> <li>Fixed emulator issue when using the <code>-wipe-data</code> argument.</li> - <li>Fixed build issue when using Renderscript in projects that target API levels 11-13 + <li>Fixed build issue when using RenderScript in projects that target API levels 11-13 (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li> <li>Fixed issue when creating an AVD using the GoogleTV addon (<a href="http://code.google.com/p/android/issues/detail?id=20963">Issue 20963</a>).</li> diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd index 8d25d96..65148bf 100644 --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -15,6 +15,7 @@ page.title=Support Library Features <li><a href="#v7-mediarouter">v7 mediarouter library</a></li> </ol> </li> + <li><a href="#v8">v8 Support Library</a></li> <li><a href="#v13">v13 Support Library</a></li> </ol> @@ -252,7 +253,7 @@ script dependency identifier <code>com.android.support:support-v7-mediarouter:&l where "18.0.0" is the minimum revision at which the library is available. For example:</p> <pre> -com.android.support:support-v7-mediarouter:18.0.0 +com.android.support:mediarouter-v7:18.0.+ </pre> <p class="caution">The v7 mediarouter library APIs introduced in Support Library @@ -262,6 +263,24 @@ href="https://developers.google.com/cast/">Google Cast developer preview</a>. </p> +<h2 id="v8">v8 Support Library</h2> + +<p>This library is designed to be used with Android (API level 8) and higher. It adds support for + the <a href="{@docRoot}guide/topics/renderscript/compute.html">RenderScript</a> computation + framework. These APIs are included in the {@link android.support.v8.renderscript} package. You + should be aware that the steps for including these APIs in your application is <em>very + different</em> from other support library APIs. For more information about using these APIs + in your application, see the + <a href="{@docRoot}guide/topics/renderscript/compute.html#access-rs-apis">RenderScript</a> + 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. +</p> + + <h2 id="v13">v13 Support Library</h2> <p>This library is designed to be used for Android 3.2 (API level 13) and higher. It adds support diff --git a/docs/html/tools/support-library/index.jd b/docs/html/tools/support-library/index.jd index 06c7a3f..4ee8c12 100644 --- a/docs/html/tools/support-library/index.jd +++ b/docs/html/tools/support-library/index.jd @@ -58,6 +58,7 @@ page.title=Support Library <p>This section provides details about the Support Library package releases.</p> + <div class="toggle-content opened"> <p><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt="" |