- 
Revision 3 (March 2012)
@@ -135,15 +236,6 @@ class="toggle-content-img" alt="" />Revision 1
(December 2011)
-
To test your application on an emulator that represents the latest Android device, you can create
-an AVD with the new WXGA720 skin (it's an xhdpi, normal screen device). Note that the emulator
-currently doesn't support the new on-screen navigation bar for devices without hardware navigation
-buttons, so when using this skin, you must use keyboard keys Home for the Home button,
-ESC for the Back button, and F2 or Page-up for the Menu button.
-
-
However, due to performance issues in the emulator when running high-resolution screens such as
-the one for the WXGA720 skin, we recommend that you primarily use the traditional WVGA800 skin
-(hdpi, normal screen) to test your application.
diff --git a/docs/html/tools/sdk/eclipse-adt.jd b/docs/html/tools/sdk/eclipse-adt.jd
index aa21423fad9c5..947e463d6dd46 100644
--- a/docs/html/tools/sdk/eclipse-adt.jd
+++ b/docs/html/tools/sdk/eclipse-adt.jd
@@ -95,7 +95,47 @@ padding: 5px 0 0;
-
+ADT 20.0.1 (June 2012)
+
+
+ - Dependencies:
+
+ -
+
+ - Java 1.6 or higher is required for ADT 20.0.1.
+ - Eclipse Helios (Version 3.6.2) or higher is required for ADT 20.0.1.
+ - ADT 20.0.1 is designed for use with SDK
+ Tools r20.0.1. If you haven't already installed SDK Tools r20.0.1 into your SDK, use the
+ Android SDK Manager to do so.
+
+
+
+ - Bug fixes:
+ -
+
+ - Fixed issue in the New Project Wizard related to installation of the Support Library.
+ - Fixed several issues with New Project Wizard related to templates.
+ - Fixed issue with the text-based launcher icon in New Project Wizard.
+ - Fixed issue with sticky error markers in Java files.
+ - Fixed problem with manifest merger when exporting release {@code .apk} files.
+ - Fixed NDK support to automatically find include path on Windows.
+ - Fixed editor startup exception for new configurations where editor would come up blank.
+ - Added support for {@code xxhdpi} density, which was included in API Level 16.
+ - Fixed a bug in the {@code lint} check for unprotected broadcast receivers to ignore
+unprotected receivers for default Android actions.
+
+
+
+
+
+
+
+
+
+
+ 
ADT 20.0.0 (June 2012)
@@ -325,7 +365,7 @@ automatically assigns ids to views without ids when pointing to them.)
- Fixed problem using Layout Editor with {@link android.widget.SlidingDrawer} which could
not be dragged into the layout on some platforms.
- - Fixed preview rendering for {@link android.widget.SlidingDrawer} and
+
- Fixed preview rendering for {@link android.widget.SlidingDrawer} and
{@link android.widget.TabHost}.
(Issue 23022).
- Fixed issues that could prevent layout rendering due to unresolvable resources.
diff --git a/docs/html/tools/sdk/ndk/index.jd b/docs/html/tools/sdk/ndk/index.jd
index 6be3168e88fec..216a3048d9b9a 100644
--- a/docs/html/tools/sdk/ndk/index.jd
+++ b/docs/html/tools/sdk/ndk/index.jd
@@ -1,16 +1,16 @@
ndk=true
-ndk.win_download=android-ndk-r8-windows.zip
-ndk.win_bytes=109928336
-ndk.win_checksum=37b1a2576f28752fcc09e1b9c07e3f14
+ndk.win_download=android-ndk-r8b-windows.zip
+ndk.win_bytes=188724991
+ndk.win_checksum=6d290d4f2729ef2063c5ae5b1e335622
-ndk.mac_download=android-ndk-r8-darwin-x86.tar.bz2
-ndk.mac_bytes=96650992
-ndk.mac_checksum=81ce5de731f945692123b377afe0bad9
+ndk.mac_download=android-ndk-r8b-darwin-x86.tar.bz2
+ndk.mac_bytes=181255568
+ndk.mac_checksum=94fe392194ea41f8a70cfce0dee3870f
-ndk.linux_download=android-ndk-r8-linux-x86.tar.bz2
-ndk.linux_bytes=88310791
-ndk.linux_checksum=5c9afc9695ad67c61f82fbf896803c05
+ndk.linux_download=android-ndk-r8b-linux-x86.tar.bz2
+ndk.linux_bytes=160466240
+ndk.linux_checksum=6694ccc04d543500f0661a75f6c46526
page.title=Android NDK
@@ -41,7 +41,7 @@ page.title=Android NDK
-
+
The NDK is a toolset that allows you to implement parts
of your app using native-code languages such as C and C++. For certain types of apps,
this can be helpful so that you may reuse existing code libraries written in these
@@ -62,12 +62,12 @@ page.title=Android NDK
Downloads
-
+
-
-
+
+
Revisions
The sections below provide information and notes about successive releases of
@@ -115,12 +115,204 @@ padding: 5px 0 0;
+ Android NDK, Revision 8b (July 2012)
+
+
+
The main features of this release are a new GNU Compiler Collection (GCC) 4.6 toolchain and
+GNU Debugger (GDB) 7.3.x which adds debugging support for the Android 4.1 (API Level 16) system
+image.
+
+
+ - Important bug fixes:
+
+ -
+
+ - Fixed {@code LOCAL_SHORT_COMMANDS} issues on Mac OS, Windows Cygwin environments for
+static libraries. List file generation is faster, and it is not regenerated to avoid repeated
+project rebuilds.
+ - Fixed several issues in {@code ndk-gdb}:
+
+ - Updated tool to pass flags {@code -e}, {@code -d} and {@code -s} to adb more
+consistently.
+ - Updated tool to accept device serial names containing spaces.
+ - Updated tool to retrieve {@code /system/bin/link} information, so {@code gdb} on
+the host can set a breakpoint in {@code __dl_rtld_db_dlactivity} and be aware of linker activity
+(e.g., rescan {@code solib} symbols when {@code dlopen()} is called).
+
+
+ - Fixed {@code ndk-build clean} on Windows, which was failing to remove
+{@code ./libs/*/lib*.so}.
+ - Fixed {@code ndk-build.cmd} to return a non-zero {@code ERRORLEVEL} when {@code make}
+fails.
+ - Fixed {@code libc.so} to stop incorrectly exporting the {@code __exidx_start} and
+{@code __exidx_end} symbols.
+ - Fixed {@code SEGV} when unwinding the stack past {@code __libc_init} for ARM and
+MIPS.
+
+
+
+
+
+ - Important changes:
+
+ -
+
+ - Added GCC 4.6 toolchain ({@code binutils} 2.21 with {@code gold} and GDB 7.3.x) to
+co-exist with the original GCC 4.4.3 toolchain ({@code binutils} 2.19 and GDB 6.6).
+
+ - GCC 4.6 is now the default toolchain. You may set {@code
+NDK_TOOLCHAIN_VERSION=4.4.3} in {@code Android.mk} to select the original one.
+ - Support for the {@code gold} linker is only available for ARM and x86
+architectures on Linux and Mac OS hosts. This support is disabled by default. Add {@code
+LOCAL_C_FLAGS += -fuse-ld=gold} in {@code Android.mk} to enable it.
+ - Programs compiled with {@code -fPIE} require the new {@code GDB} for debugging,
+including binaries in Android 4.1 (API Level 16) system images.
+ - The {@code binutils} 2.21 {@code ld} tool contains back-ported fixes from
+version 2.22:
+
+ - Fixed {@code ld --gc-sections}, which incorrectly retains zombie references to
+external libraries. (more
+info).
+ - Fixed ARM {@code strip} command to preserve the original {@code p_align} and
+{@code p_flags} in {@code GNU_RELRO} section if they are valid. Without this fix, programs
+built with {@code -fPIE} could not be debugged. (more info)
+
+
+ - Disabled {@code sincos()} optimization for compatibility with older
+ platforms.
+
+
+
+ - Updated build options to enable the Never eXecute (NX) bit and {@code relro}/{@code
+bind_now} protections by default:
+
+
+
+ - Added branding for Android executables with the {@code .note.ABI-tag} section (in
+{@code crtbegin_static/dynamic.o}) so that debugging tools can act accordingly. The structure
+member and values are defined as follows:
+
+static const struct {
+ int32_t namesz; /* = 4, sizeof ("GNU") */
+ int32_t descsz; /* = 6 * sizeof(int32_t) */
+ int32_t type; /* = 1 */
+ char name[sizeof "GNU"]; /* = "GNU" */
+ int32_t os; /* = 0 */
+ int32_t major; /* = 2 */
+ int32_t minor; /* = 6 */
+ int32_t teeny; /* = 15 */
+ int32_t os_variant; /* = 1 */
+ int32_t android_api; /* = 3, 4, 5, 8, 9, 14 */
+}
+
+
+
+
+
+
+ - Other bug fixes:
+
+ -
+
+ - Fixed {@code mips-linux-gnu} relocation truncated to fit {@code R_MIPS_TLS_LDM} issue.
+ (more info)
+ - Fixed {@code ld} tool segfaults when using {@code --gc-sections}.
+ (more info)
+
+ - Fixed MIPS {@code GOT_PAGE} counting issue.
+ (more info)
+ - Fixed follow warning symbol link for {@code mips_elf_count_got_symbols}.
+ - Fixed follow warning symbol link for {@code mips_elf_allocate_lazy_stub}.
+ - Moved MIPS {@code .dynamic} to the data segment, so that it is writable.
+ - Replaced hard-coded values for symbols with correct segment sizes for MIPS.
+ - Removed the {@code -mno-shared} option from the defaults in the MIPS toolchain.
+The default for Android toolchain is {@code -fPIC} (or {@code -fpic} if supported). If you do not
+explicitly specify {@code -mshared}, {@code -fpic}, {@code -fPIC}, {@code -fpie}, or {@code -fPIE},
+the MIPS compiler adds {@code -mno-shared} that turns off PIC. Fixed compiler not to add
+{@code -mno-shared} in this case.
+ - Fixed wrong package names in samples {@code hello-jni} and {@code two-libs} so that
+the {@code tests} project underneath it can compile.
+
+
+
+
+
+ - Other Changes:
+
+ -
+
+ - Changed locations of binaries:
+
+ - Moved {@code gdbserver} from
+{@code toolchain/<arch-os-ver>/prebuilt/gdbserver} to
+{@code prebuilt/android-<arch>/gdbserver/gdbserver}.
+ - Renamed x86 toolchain prefix from {@code i686-android-linux-} to
+{@code i686-linux-android-}.
+ - Moved {@code sources/cxx-stl/gnu-libstdc++/include} and {@code lib} to
+{@code sources/cxx-stl/gnu-libstdc++/4.6} when compiled with GCC 4.6, or
+{@code sources/cxx-stl/gnu-libstdc++/4.4.3} when compiled with GCC 4.4.3.
+ - Moved {@code libbfd.a} and {@code libintl.a} from {@code lib/} to {@code
+lib32/}.
+
+
+
+ - Added and improved various scripts in the rebuild and test NDK toolchain:
+
+ - Added {@code build-mingw64-toolchain.sh} to generate a new Linux-hosted toolchain
+that generates Win32 and Win64 executables.
+ - Improved speed of {@code download-toolchain-sources.sh} by using the {@code
+clone} command and only using {@code checkout} for the directories that are needed to build the NDK
+toolchain binaries.
+ - Added {@code build-host-gcc.sh} and {@code build-host-gdb.sh} scripts.
+ - Added {@code tests/check-release.sh} to check the content of a given NDK
+installation directory, or an existing NDK package.
+ - Rewrote the {@code tests/standalone/run.sh} standalone tests .
+
+
+ - Removed {@code if_dl.h} header from all platforms and architectures. The {@code
+AF_LINK} and {@code sockaddr_dl} elements it describes are specific to BSD (i.e., they don't exist
+in Linux).
+
+
+
+
+
+
+
+
+
Android NDK, Revision 8 (May 2012)
This release of the NDK includes support for MIPS ABI and a few additional fixes.
-
+
- New features:
-
@@ -910,7 +1102,7 @@ float AMotionEvent_getHistoricalRawY(const AInputEvent* motion_event,
as well as control over platform audio effects
- Access to assets packaged in an
.apk file.
-
+
@@ -927,7 +1119,7 @@ float AMotionEvent_getHistoricalRawY(const AInputEvent* motion_event,
- Provides a default C++ STL implementation (based on STLport) as a helper module. It can be used either
as a static or shared library (details and usage examples are in sources/android/stlport/README). Prebuilt
binaries for STLport (static or shared) and GNU libstdc++ (static only) are also provided if you choose to
- compile against those libraries instead of the default C++ STL implementation.
+ compile against those libraries instead of the default C++ STL implementation.
C++ Exceptions and RTTI are not supported in the default STL implementation. For more information, see
docs/CPLUSPLUS-SUPPORT.HTML.
@@ -938,8 +1130,8 @@ float AMotionEvent_getHistoricalRawY(const AInputEvent* motion_event,
- Adds an EGL library that lets you create and manage OpenGL ES textures and
services.
-
- - Adds new sample applications,
native-plasma and native-activity,
+
+ - Adds new sample applications,
native-plasma and native-activity,
to demonstrate how to write a native activity.
- Includes many bugfixes and other small improvements; see docs/CHANGES.html for a more
@@ -1103,25 +1295,25 @@ float AMotionEvent_getHistoricalRawY(const AInputEvent* motion_event,
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -1287,32 +1479,32 @@ later)
android:minSdkVersion="8" /> attribute value in its manifest.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Installing the NDK
Installing the NDK on your development computer is straightforward and involves extracting the
NDK from its download package.
@@ -1339,7 +1531,7 @@ Software Requirements
You are now ready to start working with the NDK.
-
+
Getting Started with the NDK
Once you've installed the NDK successfully, take a few minutes to read the documentation
@@ -1402,13 +1594,13 @@ included with the NDK package.
to use them or any other framework API, you can still write JNI code to do so.
-
-
-
-
-
+
+
+
+
+
Contents of the NDK
-
+
The NDK contains the APIs, documentation, and sample
applications that help you write your native code. Specifically:
@@ -1478,9 +1670,9 @@ information)
libjnigraphics (Pixel buffer access) header (for Android 2.2 and above).
A Minimal set of headers for C++ support
-
+
OpenSL ES native audio libraries
-
+
Android native application APIS
@@ -1510,13 +1702,13 @@ information)
system
OVERVIEW.HTML — provides an overview of the NDK capabilities and usage
-
+
ANDROID-MK.HTML — describes the use of the Android.mk file, which defines the native
sources you want to compile
-
+
APPLICATION-MK.HTML — describes the use of the Application.mk file, which describes
- the native sources required by your Android application
-
CPLUSPLUS-SUPPORT.HTML — describes the C++ support provided in the Android NDK
+ the native sources required by your Android application
+
CPLUSPLUS-SUPPORT.HTML — describes the C++ support provided in the Android NDK
CPU-ARCH-ABIS.HTML — a description of supported CPU architectures and how to target
them.
@@ -1527,15 +1719,15 @@ information)
CHANGES.HTML — a complete list of changes to the NDK across all releases.
DEVELOPMENT.HTML — describes how to modify the NDK and generate release packages for it
-
+
HOWTO.HTML — information about common tasks associated with NDK development
-
+
IMPORT-MODULE.HTML — describes how to share and reuse modules
-
+
LICENSES.HTML — information about the various open source licenses that govern the Android NDK
-
+
NATIVE-ACTIVITY.HTML — describes how to implement native activities
-
+
NDK-BUILD.HTML — describes the usage of the ndk-build script
NDK-GDB.HTML — describes how to use the native code debugger
@@ -1544,13 +1736,13 @@ information)
STANDALONE-TOOLCHAIN.HTML — describes how to use Android NDK toolchain as a standalone
compiler (still in beta).
-
+
SYSTEM-ISSUES.HTML — known issues in the Android system images that you should be
aware of, if you are developing using the NDK.
STABLE-APIS.HTML — a complete list of the stable APIs exposed by headers in the
NDK.
-
+
Additionally, the package includes detailed information about the "bionic" C library provided
@@ -1562,10 +1754,10 @@ information)
offers.
-
-
-
-
+
+
+
+
Sample apps
The NDK includes sample applications that illustrate how to use native code in your Android
@@ -1624,10 +1816,10 @@ information)
If you are developing with Ant, use the android tool to create the build file
for each of the sample projects at <ndk>/samples/<name>/.
Then set up an AVD, if necessary, build your project in the usual way, and run it in the
- emulator.
-
+ emulator.
+
-
+
For more information about developing with the Android SDK tools and what
you need to do to create, build, and run your applications, see
the Overview
diff --git a/docs/html/tools/sdk/tools-notes.jd b/docs/html/tools/sdk/tools-notes.jd
index 14d1aa48606ec..039c4b5b60951 100644
--- a/docs/html/tools/sdk/tools-notes.jd
+++ b/docs/html/tools/sdk/tools-notes.jd
@@ -24,51 +24,51 @@ Tools you are using, refer to the "Installed Packages" listing in the Android SD
For a summary of all known issues in SDK Tools, see http://tools.android.com/knownissues.
-
-
-
-
-
- SDK Tools, Revision 20 (June 2012)
+
+
+ SDK Tools, Revision 20.0.1 (July 2012)
+
-
+
+
+
+ - Dependencies:
+ -
+
+ - Android SDK Platform-tools revision 12 or later.
+ - If you are developing in Eclipse with ADT, note that the SDK Tools r20.0.1 is designed
+ for use with ADT 20.0.1 and later. If you haven't already, update your
+ ADT Plugin to 20.0.1.
+ - If you are developing outside Eclipse, you must have
+ Apache Ant 1.8 or later.
+
+
+ - Bug fixes:
+ -
+
+ - Fixed wrong check on build state that forced repetitive Java code recompilation.
+ - Fixed problems with running more than one emulator and running multiple emulators
+with GPU acceleration.
+ - Improved resize algorithm for better rendering on scaled emulator windows.
+ - Fixed a bug in the {@code lint} check for unprotected broadcast receivers to ignore
+unprotected receivers for default Android actions.
+ - Fixed build issue for projects using Renderscript.
+ - Fixed memory leak in the emulator.
+
+
+
+
+
+
+
+
+ SDK Tools, Revision 20 (June 2012)
+
+
+
- Dependencies:
-
@@ -137,13 +137,13 @@ and tested like test applications, including code coverage information.
-
-
-
- SDK Tools, Revision 19 (April 2012)
+
+
+ SDK Tools, Revision 19 (April 2012)
+
-
+
Note: This update of SDK Tools is only available through
the Android SDK Manager. Use this tool to
download and install this update.
@@ -171,13 +171,13 @@ acceleration.
-
-
-
- SDK Tools, Revision 18 (April 2012)
+
+
+ SDK Tools, Revision 18 (April 2012)
+
-
+
Important: To download the new Android
4.0 system components from the Android SDK Manager, you must first update the
SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
@@ -213,13 +213,13 @@ in some cases.
-
-
-
- SDK Tools, Revision 17 (March 2012)
+
+
+ SDK Tools, Revision 17 (March 2012)
+
-
+
Important: To download the new Android
4.0 system components from the Android SDK Manager, you must first update the
SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
@@ -317,13 +317,13 @@ ignore attribute. (
-
-
-
- SDK Tools, Revision 16 (December 2011)
+
+
+ SDK Tools, Revision 16 (December 2011)
+
-
+
Important: To download the new Android
4.0 system components from the Android SDK Manager, you must first update the
SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
@@ -367,13 +367,13 @@ ignore attribute. (
-
-
-
- SDK Tools, Revision 15 (October 2011)
+
+
+ SDK Tools, Revision 15 (October 2011)
+
-
+
Important: To download the new Android
4.0 system components from the Android SDK Manager, you must first update the
SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
@@ -415,13 +415,13 @@ ignore attribute. (
-
-
-
- SDK Tools, Revision 14 (October 2011)
+
+
+ SDK Tools, Revision 14 (October 2011)
+
-
+
Important: To download the new Android
4.0 system components from the Android SDK Manager, you must first update the
SDK tools to revision 14 and restart the Android SDK Manager. If you do not,
@@ -470,12 +470,13 @@ site.
-