Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: Updates changelog, "history" page; removes outdated "Extraction" section.

Browse Source 
Bug: 27676973

Change-Id: If99f0b4ddea9a9398db597f7eea7635195aef282
This commit is contained in:
David Friedman
2016-03-16 17:35:01 -07:00
parent 271d2f3e6b
commit deaaac1ef7
3 changed files with 308 additions and 287 deletions
Download Patch File Download Diff File Expand all files Collapse all files

307
docs/html/ndk/downloads/index.jd
View File

@@ -317,295 +317,52 @@ Notwithstanding this, you agree that Google shall still be allowed to apply for
$('#Downloads').after($('#download-table'));
</script>
<h2 id="extract">Extraction</h2>
<p>The NDK package is a self-extracting binary. To unpack it, follow the procedure for your
development platform:</p>
<ul>
<li>On Linux and Mac OS X (Darwin):
<ul>
<ol>
<li>Download the appropriate package from this page.</li>
<li>Open a terminal window.</li>
<li>Go to the directory to which you downloaded the package.</li>
<li>Run <code>chmod a+x</code> on the downloaded package.</li>
<li>Execute the package. For example:
<pre class="no-pretty-print">
ndk$ chmod a+x android-ndk-r10c-darwin-x86_64.bin
ndk$ ./android-ndk-r10c-darwin-x86_64.bin
</pre></li>
<p>The folder containing the NDK extracts itself.</p>
<p>You can also use a program like 7z to extract the package.</p>
</ol>
</ul>
</li>
<li>On Windows:</li>
<ul>
<ol>
<li>Download the appropriate package from this page.</li>
<li>Navigate to the folder to which you downloaded the package.</li>
<li>Double-click the downloaded file. The folder containing the NDK extracts itself.</li>
</ol>
</ul>
</ul>When uncompressed, the NDK files are contained in a directory called
<code>android-ndk-&lt;version&gt;</code>. You can rename the NDK directory if necessary and you
can move it to any location on your computer. This documentation refers to the NDK directory as
<code>&lt;ndk&gt;</code>.
<p>You are now ready to start working with the NDK.</p>
<h2 id="rel">Release Notes</h2>
<p>Android NDK, Revision 11</a> <em>(March 2016)</em></p>
<dl>
<dt>Clang</dt>
<dd>
<ul>
<li>Important announcements
<ul>
<li>We strongly recommend switching to Clang.
<ul>
<li>If you experience problems with Clang, file bugs
<a href="https://github.com/android-ndk/ndk/issues">here</a> for issues
specific to Clang in the NDK. For more general Clang issues,
file bugs by following the instructions on
<a href="http://llvm.org/docs/HowToSubmitABug.html">this page</a>.</li>
</ul>
</li>
<li>Clang has been updated to 3.8svn (r243773, build 2481030).
<ul>
<li>This version is a nearly pure upstream Clang.</li>
<li>The Windows 64-bit downloadable NDK package contains a 32-bit
version of Clang.</li>
</ul>
</li>
</ul>
</li>
<li>Additions
<ul>
<li>Clang now provides support for emulated TLS.
<ul>
<li>The compiler now supports {@code __thread} by emulating
ELF TLS with pthread thread-specific data.</li>
<li>C++11 {@code thread_local} works in some cases, but not
for data with non-trivial destructors, because those cases
require support from libc. This limitation does not
apply when running on Android 6.0 (API level 23) or newer.</li>
<li>Emulated TLS does not yet work with Aarch64 when
TLS variables are accessed from a shared library.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>GCC</dt>
<dd>
<ul>
<li>Important announcements</li>
<ul>
<li>GCC in the NDK is now deprecated in favor of Clang.
<ul>
<li>The NDK will neither be upgrading to 5.x, nor accept
non-critical backports.</li>
<li>Maintenance for miscompiles and internal compiler errors
in 4.9 will be handled on a case by case basis.</li>
</ul>
</li>
</ul>
<li>Removals
<ul>
<li>Removed GCC 4.8. All targets now use GCC 4.9.</li>
</ul>
</li>
<li>Other changes
<ul>
<li>Synchronized google/gcc-4_9 to r224707. Previously, it had been
synchronized with r214835.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<p>Android NDK, Revision 11b</a> <em>(March 2016)</em></p>
<dl>
<dt>NDK</dt>
<dd>
<ul>
<li>Important announcements
<ul>
<li>The samples are no longer included in the NDK package.
They are instead available on
<a href="https://github.com/googlesamples/android-ndk">GitHub.</a>
</li>
<li>The documentation is no longer included in the NDK package.
Instead, it is on the <a href="{@docRoot}ndk/index.html">Android
developer website.</a></li>
</ul>
</li>
<ul>
<li>We’ve moved our bug tracker to <a href="https://github.com/android-ndk/ndk/issues">
GitHub.</a></li>
</ul>
</li>
<li>Additions
<ul>
<li>Added a native tracing API to {@code android-23}.</li>
<li>Added a native multinetwork API to {@code android-23}.</li>
<li>Enabled libc, m, and dl to provide versioned symbols, starting
from API level 21.</li>
<li>Added Vulkan headers and library to API level N.</li>
</ul>
</li>
<li>Removals
<ul>
<li>Removed support for {@code _WCHAR_IS_8BIT}.</li>
<li>Removed sed.</li>
<li>Removed mclinker.</li>
<li>Removed Perl.</li>
<li>Removed from all versions of NDK libc, m, and dl all symbols which
the platform versions of those libs do not support.</li>
<li>Partially removed support for mips64r2. The rest will be removed
in the future.</li>
</ul>
</li>
<li>Other changes
<ul>
<li>Changed ARM standalone toolchains to default to arm7.
<ul>
<li>You can restore the old behavior by passing specifying the
{@code -target} option as {@code armv5te-linux-androideabi}.
</li>
</ul>
</li>
<li>Changed the build system to use {@code -isystem} for platform
includes.
<ul>
<li>Warnings that bionic causes no longer break app builds.</li>
</ul>
<li>Changes
<ul>
<li>{@code ndk-gdb.py} is fixed. It had
<a href="https://github.com/android-ndk/ndk/issues/3">regressed entirely</a>
in r11.</li>
<li>{@code ndk-gdb} for Mac <a href="https://github.com/android-ndk/ndk/issues/2">
is fixed</a>.</li>
<li>Added more top-level shortcuts for command line tools:
<ul>
<li>{@code ndk-depends}.</li>
<li>{@code ndk-gdb}.</li>
<li>{@code ndk-stack}.</li>
<li>{@code ndk-which}. This command had been entirely absent from previous
releases.</li>
</ul>
</li>
<li>Fixed standalone toolchains for libc++, which had been missing
{@code __cxxabi_config.h}.</li>
<li>Fixed help documentation for {@code --toolchain} in
{@code make-standalone-toolchain.sh}.</li>
</li>
<li>Fixed a segfault that occurred when a binary threw exceptions
via gabi++. (Issue <a href="http://b.android.com/179410">179410</a>)
</li>
<li>Changed libc++’s inline namespace to {@code std::__ndk1}
to prevent ODR issues with platform libc++.</li>
<li>All libc++ libraries are now built with libc++abi.
<li>Bumped default {@code APP_PLATFORM} to Gingerbread.
<ul>
<li>Expect support for Froyo and older to be dropped in a
future release.</ul>
</ul>
<li>Updated gabi++ {@code _Unwind_Exception} struct for 64 bits.
<li>Added the following capabilities to cpufeatures:
<ul>
<li>Detect SSE4.1 and SSE4.2.</li>
<li>Detect cpu features on x86_64.</li>
</ul>
</li>
<li>Updated libc++abi to upstream
<a href="http://lists.llvm.org/pipermail/cfe-commits/Week-of-Mon-20150302/124603.html">
r231075</a>.
<li>Updated {@code byteswap.h}, {@code endian.h}, {@code sys/procfs.h},
{@code sys/ucontext.h}, {@code sys/user.h}, and {@code uchar.h} from
ToT Bionic.
<li>Synchronized {@code sys/cdefs.h} across all API levels.
<li>Fixed {@code fegetenv and fesetenv} for arm.
<li>Fix end pointer size/alignment of {@code crtend_*} for mips64
and x86_64.
</ul>
</li>
</ul>
</ul>
</ul>
</dd>
<dl>
<dl>
<dt>Binutils</dt>
<dt>Clang</dt>
<dd>
<ul>
<li>Additions
<ul>
<li>Added a new option: {@code --pic-veneer}.</li>
</ul>
</li>
<li>Removals
<ul>
<li>The 32-bit Windows package no longer contains ld.gold.
You can instead get ld.gold from the 64-bit Windows package.</li>
</ul>
</li>
<li>Changes
<li>Errata</li>
<ul>
<li>Unified binutils source between Android and ChromiumOS.
For more information on this change, see the comments
<a href="https://android-review.googlesource.com/#/c/182865/">
here.</a></li>
<li>Improved reliability of Gold for aarch64. Use
{@code -fuse-ld=gold} at link time to use gold instead of bfd.
The default will likely switch in the next release.</li>
<li>Improved linking time for huge binaries for Gold ARM back end
(up to 50% linking time reduction for debuggable Chrome Browser).
</li>
<li>Contrary to what we reported in the r11 Release Notes, {@code __thread}
does not work. This is because the version of Clang we ship is missing a bug fix for
emulated TLS support.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>GDB</dt>
<dd>
<ul>
<li>Removals
<ul>
<li>Removed ndk-gdb in favor of ndk-gdb.py.</li>
</ul>
</li>
<li>Changes
<ul>
<li>Updated gdb to version 7.10.</li>
<li>Improved performance.</li>
<li>Improved error messages.</li>
<li>Fixed relative project paths.</li>
<li>Stopped Ctrl-C from killing the backgrounded gdbserver.</li>
<li>Improved Windows support.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>YASM</dt>
<dd>
<ul>
<li>Changes
<ul>
<li>Updated YASM to version 1.3.0.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>Known issues</dt>
<dd>
<ul>
<li>x86 ASAN does not currently work. For more information, see the
discussion <a href="https://android-review.googlesource.com/#/c/186276/">
here.</a></li>
<li>The combination of Clang, x86, stlport_static, and optimization
levels higher than {@code -O0} causes test failures with
{@code dynamic_cast}. For more information, see the comments
<a href="https://android-review.googlesource.com/#/c/185920">here</a>.
</li>
<li>Exception handling often fails with c++_shared on ARM32. The root
cause is incompatibility between the LLVM unwinder that libc++abi uses
for ARM32 and libgcc. This behavior is not a regression from r10e.</li>
</ul>
</dd>

264
docs/html/ndk/downloads/revision_history.jd
View File

@@ -4,6 +4,270 @@ page.title=NDK Revision History
<p>This page provides information on previous releases of the NDK, enumerating the changes that
took place in each new version.</p>
<div class="toggle-content closed">
<a name="11"></a>
<p>
<a href="#" onclick="return toggleContent(this)"> <img
src="/assets/images/triangle-closed.png" class="toggle-content-img" alt=""
>Android NDK, Revision 11</a> <em>(March 2016)</em>
</p>
<div class="toggle-content-toggleme">
<dl>
<dt>Clang</dt>
<dd>
<ul>
<li>Important announcements
<ul>
<li>We strongly recommend switching to Clang.
<ul>
<li>If you experience problems with Clang, file bugs
<a href="https://github.com/android-ndk/ndk/issues">here</a> for issues
specific to Clang in the NDK. For more general Clang issues,
file bugs by following the instructions on
<a href="http://llvm.org/docs/HowToSubmitABug.html">this page</a>.</li>
</ul>
</li>
<li>Clang has been updated to 3.8svn (r243773, build 2481030).
<ul>
<li>This version is a nearly pure upstream Clang.</li>
<li>The Windows 64-bit downloadable NDK package contains a 32-bit
version of Clang.</li>
</ul>
</li>
</ul>
</li>
<li>Additions
<ul>
<li>Clang now provides support for emulated TLS.
<ul>
<li>The compiler now supports {@code __thread} by emulating
ELF TLS with pthread thread-specific data.</li>
<li>C++11 {@code thread_local} works in some cases, but not
for data with non-trivial destructors, because those cases
require support from libc. This limitation does not
apply when running on Android 6.0 (API level 23) or newer.</li>
<li>Emulated TLS does not yet work with Aarch64 when
TLS variables are accessed from a shared library.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>GCC</dt>
<dd>
<ul>
<li>Important announcements</li>
<ul>
<li>GCC in the NDK is now deprecated in favor of Clang.
<ul>
<li>The NDK will neither be upgrading to 5.x, nor accept
non-critical backports.</li>
<li>Maintenance for miscompiles and internal compiler errors
in 4.9 will be handled on a case by case basis.</li>
</ul>
</li>
</ul>
<li>Removals
<ul>
<li>Removed GCC 4.8. All targets now use GCC 4.9.</li>
</ul>
</li>
<li>Other changes
<ul>
<li>Synchronized google/gcc-4_9 to r224707. Previously, it had been
synchronized with r214835.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>NDK</dt>
<dd>
<ul>
<li>Important announcements
<ul>
<li>The samples are no longer included in the NDK package.
They are instead available on
<a href="https://github.com/googlesamples/android-ndk">GitHub.</a>
</li>
<li>The documentation is no longer included in the NDK package.
Instead, it is on the <a href="{@docRoot}ndk/index.html">Android
developer website.</a></li>
</ul>
</li>
<li>Additions
<ul>
<li>Added a native tracing API to {@code android-23}.</li>
<li>Added a native multinetwork API to {@code android-23}.</li>
<li>Enabled libc, m, and dl to provide versioned symbols, starting
from API level 21.</li>
<li>Added Vulkan headers and library to API level N.</li>
</ul>
</li>
<li>Removals
<ul>
<li>Removed support for {@code _WCHAR_IS_8BIT}.</li>
<li>Removed sed.</li>
<li>Removed mclinker.</li>
<li>Removed Perl.</li>
<li>Removed from all versions of NDK libc, m, and dl all symbols which
the platform versions of those libs do not support.</li>
<li>Partially removed support for mips64r2. The rest will be removed
in the future.</li>
</ul>
</li>
<li>Other changes
<ul>
<li>Changed ARM standalone toolchains to default to arm7.
<ul>
<li>You can restore the old behavior by passing specifying the
{@code -target} option as {@code armv5te-linux-androideabi}.
</li>
</ul>
</li>
<li>Changed the build system to use {@code -isystem} for platform
includes.
<ul>
<li>Warnings that bionic causes no longer break app builds.</li>
</ul>
</li>
<li>Fixed a segfault that occurred when a binary threw exceptions
via gabi++. (Issue <a href="http://b.android.com/179410">179410</a>)
</li>
<li>Changed libc++’s inline namespace to {@code std::__ndk1}
to prevent ODR issues with platform libc++.</li>
<li>All libc++ libraries are now built with libc++abi.
<li>Bumped default {@code APP_PLATFORM} to Gingerbread.
<ul>
<li>Expect support for Froyo and older to be dropped in a
future release.</ul>
</ul>
<li>Updated gabi++ {@code _Unwind_Exception} struct for 64 bits.
<li>Added the following capabilities to cpufeatures:
<ul>
<li>Detect SSE4.1 and SSE4.2.</li>
<li>Detect cpu features on x86_64.</li>
</ul>
</li>
<li>Updated libc++abi to upstream
<a href="http://lists.llvm.org/pipermail/cfe-commits/Week-of-Mon-20150302/124603.html">
r231075</a>.
<li>Updated {@code byteswap.h}, {@code endian.h}, {@code sys/procfs.h},
{@code sys/ucontext.h}, {@code sys/user.h}, and {@code uchar.h} from
ToT Bionic.
<li>Synchronized {@code sys/cdefs.h} across all API levels.
<li>Fixed {@code fegetenv and fesetenv} for arm.
<li>Fix end pointer size/alignment of {@code crtend_*} for mips64
and x86_64.
</ul>
</li>
</ul>
</ul>
</dd>
<dl>
<dl>
<dt>Binutils</dt>
<dd>
<ul>
<li>Additions
<ul>
<li>Added a new option: {@code --pic-veneer}.</li>
</ul>
</li>
<li>Removals
<ul>
<li>The 32-bit Windows package no longer contains ld.gold.
You can instead get ld.gold from the 64-bit Windows package.</li>
</ul>
</li>
<li>Changes
<ul>
<li>Unified binutils source between Android and ChromiumOS.
For more information on this change, see the comments
<a href="https://android-review.googlesource.com/#/c/182865/">
here.</a></li>
<li>Improved reliability of Gold for aarch64. Use
{@code -fuse-ld=gold} at link time to use gold instead of bfd.
The default will likely switch in the next release.</li>
<li>Improved linking time for huge binaries for Gold ARM back end
(up to 50% linking time reduction for debuggable Chrome Browser).
</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>GDB</dt>
<dd>
<ul>
<li>Removals
<ul>
<li>Removed ndk-gdb in favor of ndk-gdb.py.</li>
</ul>
</li>
<li>Changes
<ul>
<li>Updated gdb to version 7.10.</li>
<li>Improved performance.</li>
<li>Improved error messages.</li>
<li>Fixed relative project paths.</li>
<li>Stopped Ctrl-C from killing the backgrounded gdbserver.</li>
<li>Improved Windows support.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>YASM</dt>
<dd>
<ul>
<li>Changes
<ul>
<li>Updated YASM to version 1.3.0.</li>
</ul>
</li>
</ul>
</dd>
<dl>
<dl>
<dt>Known issues</dt>
<dd>
<ul>
<li>x86 ASAN does not currently work. For more information, see the
discussion <a href="https://android-review.googlesource.com/#/c/186276/">
here.</a></li>
<li>The combination of Clang, x86, stlport_static, and optimization
levels higher than {@code -O0} causes test failures with
{@code dynamic_cast}. For more information, see the comments
<a href="https://android-review.googlesource.com/#/c/185920">here</a>.
</li>
<li>Exception handling often fails with c++_shared on ARM32. The root
cause is incompatibility between the LLVM unwinder that libc++abi uses
for ARM32 and libgcc. This behavior is not a regression from r10e.</li>
</ul>
</dd>
</dl>
</div>
</div>
<div class="toggle-content closed">
<a name="10e"></a>
<p>

24
docs/html/sdk/sdk_vars.cs
View File

@@ -39,18 +39,18 @@ set:sdk.win_installer_bytes='151659917' ?><?cs
set:sdk.win_installer_checksum='f9b59d72413649d31e633207e31f456443e7ea0b' ?><?cs
set:ndk.mac64_download='android-ndk-r11-darwin-x86_64.zip' ?><?cs
set:ndk.mac64_bytes='772314112' ?><?cs
set:ndk.mac64_checksum='a3764714eff7d187c80d989a9bf1ff8ebf5a0dfa' ?><?cs
set:ndk.mac64_download='android-ndk-r11b-darwin-x86_64.zip' ?><?cs
set:ndk.mac64_bytes='772411311' ?><?cs
set:ndk.mac64_checksum='c64fb355fec4da57d329ab45bf0aa29a1aec58dc' ?><?cs
set:ndk.linux64_download='android-ndk-r11-linux-x86_64.zip' ?><?cs
set:ndk.linux64_bytes='794012672' ?><?cs
set:ndk.linux64_checksum='7b4e0d13f6bbf48dd87475be9d052273dc766fb6' ?><?cs
set:ndk.linux64_download='android-ndk-r11b-linux-x86_64.zip' ?><?cs
set:ndk.linux64_bytes='794138413' ?><?cs
set:ndk.linux64_checksum='cf0658956945c81d3d3fad5f9a24fa062d4c9d41' ?><?cs
set:ndk.win64_download='android-ndk-r11-windows-x86_64.zip' ?><?cs
set:ndk.win64_bytes='771291648' ?><?cs
set:ndk.win64_checksum='49fcdae88724c74bb52b332b648edba9700b9529' ?><?cs
set:ndk.win32_download='android-ndk-r11-windows-x86.zip' ?><?cs
set:ndk.win32_bytes='728773632' ?><?cs
set:ndk.win32_checksum='0c9e895e400ab539c2005759410ef3e33d048291'
set:ndk.win64_download='android-ndk-r11b-windows-x86_64.zip' ?><?cs
set:ndk.win64_bytes='771396549' ?><?cs
set:ndk.win64_checksum='480eca1b29cfe73a5b35374730e6a82ca65c2aa6' ?><?cs
set:ndk.win32_download='android-ndk-r11b-windows-x86.zip' ?><?cs
set:ndk.win32_bytes='728894948' ?><?cs
set:ndk.win32_checksum='b42da395440cc1c5dc4eeeb383679331addeb3ea'
?>