+ 
Android NDK, Revision 9 (July 2013)
+
+
+-
+
- Important changes: +
-
+
-
+
- Added support for Android 4.3 (API level 18). For more information, see + {@code STABLE-APIS.html} and new code examples in {@code samples/gles3jni/README}. +
- Added headers and libraries for OpenGL ES 3.0, which is supported by Android 4.3 + (API level 18) and higher. +
- Added GNU Compiler Collection (GCC) 4.8 compiler to the NDK. Since GCC 4.6 is still
+ the default, you must explicitly enable this option:
+
-
+
- For {@code ndk-build} builds, export {@code NDK_TOOLCHAIN_VERSION=4.8} or + add it in {@code Application.mk}. +
- For standalone builds, use the {@code --toolchain=} option in
+ {@code make-standalone-toolchain.sh}, for example:
+ {@code --toolchain=arm-linux-androideabi-4.8}
+
Note: + The {@code -Wunused-local-typedefs} option is enabled by {@code -Wall}. Be + sure to add {@code __attribute__((unused))} if you use compile-time asserts like + {@code sources/cxx-stl/stlport/stlport/stl/config/features.h}, line #311. For more + information, see + Change 55460
+Note: + In the GCC 4.7 release and later, ARM compilers generate unaligned access code by + default for ARMv6 and higher build targets. You may need to add the + {@code -mno-unaligned-access} build option when building for kernels that do not support + this feature.
+
+ - Added Clang 3.3 support. The {@code NDK_TOOLCHAIN_VERSION=clang} build option
+ now picks Clang 3.3 by default.
+
Note: + Both GCC 4.4.3 and Clang 3.1 are deprecated, and will be removed from the next NDK + release.
+ - Updated GNU Project Debugger (GDB) to support python 2.7.5. +
- Added MCLinker to support Windows hosts. Since {@code ld.gold} + is the default where available, you must add {@code -fuse-ld=mcld} in + {@code LOCAL_LDFLAGS} or {@code APP_LDFLAGS} to enable MCLinker. +
- Added {@code ndk-depends} tool which prints ELF library dependencies. + For more information, see {@code NDK-DEPENDS.html}. + (Issue 53486) +
+
+ - Important bug fixes: +
-
+
-
+
- Fixed potential event handling issue in {@code android_native_app_glue}. + (Issue 41755) +
- Fixed ARM/GCC-4.7 build to generate sufficient alignment for NEON load and store + instructions VST and VLD. + (GCC Issue 57271) +
- Fixed a GCC 4.4.3/4.6/4.7 internal compiler error (ICE) for a constant negative index + value on a string literal. + (Issue 54623) +
- Fixed GCC 4.7 segmentation fault for constant initialization with an object address. + (Issue 56508) +
- Fixed GCC 4.6 ARM segmentation fault for
-Ovalues when using Boost + 1.52.0. (Issue 42891) + - Fixed {@code libc.so} and {@code libc.a} to support the {@code wait4()} function. + (Issue 19854) +
- Updated the x86 libc.so and libc.a files to include the {@code clone()} + function. +
- Fixed {@code LOCAL_SHORT_COMMANDS} bug where the {@code linker.list} file is + empty or not used. +
- Fixed GCC MIPS build on Mac OS to use CFI directives, without which + {@code ld.mcld --eh-frame-hdr} fails frequently. +
- Fixed Clang 3.2 X86/MIPS internal compiler error in {@code llvm/lib/VMCore/Value.cpp}. + (Change 59021) +
- Fixed GCC 4.7 64-bit Windows assembler crash. (Error: {@code out of memory allocating + 4294967280 bytes}). +
- Updated {@code ndk-gdb} script so that the {@code --start} or {@code --launch} actions
+ now wait for the GNU Debug Server, so that it can more reliably hit breakpoints set
+ early in the execution path (such as breakpoints in JNI code).
+ (Issue 41278)
+
Note: + This feature requires jdb and produces warning about pending breakpoints. + Specify the {@code --nowait} option to restore previous behavior. +
+
+ - Fixed GDB crash when library list is empty. +
- Fixed GDB crash when using a {@code stepi} command past a {@code bx pc} or + {@code blx pc} Thumb instruction. + (Issue 56962, + Issue 36149) +
- Fixed MIPS {@code gdbserver} to look for {@code DT_MIPS_RLD_MAP} instead of + {@code DT_DEBUG}. (Issue 56586) +
- Fixed a circular dependency in the ndk-build script, for example: If A->B and + B->B, then B was dropped from build. + (Issue 56690) +
+
+ - Other bug fixes: +
-
+
-
+
- Fixed the {@code ndk-build} script to enable you to specify a version of Clang as a + command line option (e.g., {@code NDK_TOOLCHAIN_VERSION=clang3.2}). Previously, only + specifying the version as an environment variable worked. +
- Fixed gabi++ size of {@code _Unwind_Exception} to be 24 for MIPS build targets when + using the Clang compiler. + (Change 54141) +
- Fixed the {@code ndk-build} script to ensure that built libraries are actually + removed from projects that include prebuilt static libraries when using the + {@code ndk-build clean} command. + (Change 54461, + Change 54480) +
- Modified the {@code NDK_ANALYZE=1} option to be less verbose. +
- Fixed {@code gnu-libstdc++/Android.mk} to include a {@code backward/} path for builds + that use backward compability. + (Issue 53404) +
- Fixed a problem where {@code stlport new} sometimes returned random values. +
- Fixed {@code ndk-gdb} to match the order of {@code CPU_ABIS}, not {@code APP_ABIS}. + (Issue 54033) +
- Fixed a problem where the NDK 64-bit build on MacOSX choses the wrong path for + compiler. + (Issue 53769) +
- Fixed build scripts to detect 64-bit Windows Vista. + (Issue 54485) +
- Fixed x86 {@code ntonl/swap32} error: {@code invalid 'asm': operand number + out of range}. + (Issue 54465, + Change 57242) +
- Fixed {@code ld.gold} to merge string literals. +
- Fixed {@code ld.gold} to handle large symbol alignment. +
- Updated {@code ld.gold} to enable the {@code --sort-section=name} option. +
- Fixed GCC 4.4.3/4.6/4.7 to suppress the {@code -export-dynamic} option for + statically linked programs. GCC no longer adds an {@code .interp} section for statically + linked programs. +
- Fixed GCC 4.4.3 {@code stlport} compilation error about inconsistent {@code typedef} + of {@code _Unwind_Control_Block}. + (Issue 54426) +
- Fixed {@code awk} scripts to handle {@code AndroidManifest.xml} files created on + Windows which may contain trailing {@code \r} characters and cause build errors. + (Issue 42548) +
- Fixed {@code make-standalone-toolchain.sh} to probe the {@code prebuilts/} + directory to detect if the host is 32 bit or 64 bit. +
- Fixed the Clang 3.2 {@code -integrated-as} option. +
- Fixed the Clang 3.2 ARM EHABI compact model {@code pr1} and {@code pr2} handler data. + +
- Added clang {@code -mllvm -arm-enable-ehabi} option to fix the following clang error:
+
clang: for the -arm-enable-ehabi option: may only occur zero or one times!
+
+ - Fixed build failure when there is no {@code uses-sdk} element in application + manifest. (Issue 57015) +
+ - Other changes: +
-
+
-
+
- Header Fixes
+
-
+
- Modified headers to make {@code __set_errno} an inlined function, since + {@code __set_errno} in {@code errno.h} is deprecated, and {@code libc.so} no longer + exports it. +
- Modified {@code elf.h} to include {@code stdint.h}. + (Issue 55443) +
- Fixed {@code sys/un.h} to be included independently of other headers. + (Issue 53646) +
- Fixed all of the {@code MotionEvent_getHistorical} API family to take the + {@code const AInputEvent* motion_event}. + (Issue 55873) +
- Fixed {@code malloc_usable_size} to take {@code const void*}. + (Issue 55725) +
- Fixed stdint.h to be more compatible with C99. + (Change 46821) +
- Modified {@code wchar.h} to not redefine {@code WCHAR_MAX} and + {@code WCHAR_MIN} +
- Fixed {@code <inttypes.h>} declaration for pointer-related {@code PRI} and + {@code SCN} macros. (Issue 57218) +
- Changed the {@code sys/cdefs.h} header so that {@code __WCHAR_TYPE__} is 32-bit + for API levels less than 9, which means that {@code wchat_t} is 32-bit for all + API levels. To restore the previous behavior, define the {@code _WCHAR_IS_8BIT} + boolean variable. (Issue 57267) +
+ - Added more formatting in NDK {@code docs/} and miscellaneous documentation fixes. + +
- Added support for a thin archive technique when building static libraries. + (Issue 40303) +
- Updated script {@code make-standalone-toolchain.sh} to support the {@code stlport} + library in addition to {@code gnustl}, when you specify the option + {@code --stl=stlport}. For more information, see {@code STANDALONE-TOOLCHAIN.html}. +
- Updated the {@code make-standalone-toolchain.sh} script so that the + {@code --llvm-version=} option creates the {@code $TOOLCHAIN_PREFIX-clang} and + {@code $TOOLCHAIN_PREFIX-clang++} scripts in addition to {@code clang} and + {@code clang++}, to avoid using the host's clang and clang++ definitions by accident. + +
- Added two flags to re-enable two optimizations in upstream Clang but disabled in
+ NDK for better compatibility with code compiled by GCC:
+
-
+
- Added a {@code -fcxx-missing-return-semantics} flag to re-enable missing return + semantics in Clang 3.2+. Normally, all paths should terminate with a return + statement for a value-returning function. If this is not the case, clang inserts + an undefined instruction (or trap in debug mode) at the path without a return + statement. If you are sure your code is correct, use this flag to allow the + optimizer to take advantage of the undefined behavior. If you are not sure, do not + use this flag. The caller may still receive a random incorrect value, but the + optimizer will not exploit it and make your code harder to debug. +
- Added a {@code -fglobal-ctor-const-promotion} flag to re-enable + promoting global variables with static constructor to be constants. With this flag, + the global variable optimization pass of LLVM tries to evaluate the global + variables with static constructors and promote them to global constants. Although + this optimization is correct, it may cause some incompatability with code compiled + by GCC. For example, code may do {@code const_cast} to cast the constant to mutable + and modify it. In GCC, the variable is in read-write and the code is run by + accident. In Clang, the const variable is in read-only memory and may cause your + application to crash. +
+ - Added {@code -mldc1-sdc1} to the MIPS GCC and Clang compilers. By default, compilers + align 8-byte objects properly and emit the {@code ldc1} and {@code sdc1} instructions + to move them around. If your app uses a custom allocator that does not always align + with a new object's 8-byte boundary in the same way as the default allocator, your app + may crash due to {@code ldc1} and {@code sdc1} operations on unaligned memory. In this + case, use the {@code -mno-ldc1-sdc1} flag to workaround the problem. +
- Downgraded the event severity from warning to info if {@code APP_PLATFORM_LEVEL} is + larger than {@code APP_MIN_PLATFORM_LEVEL}. The {@code APP_PLATFORM_LEVEL} may be lower + than {@code APP_PLATFORM} in {@code jni/Application.mk} because the NDK does not have + headers for all levels. In this case, the actual level is shifted downwards. The + {@code APP_MIN_PLATFORM_LEVEL} is specified by the {@code android:minSdkVersion} in + your application's manifest. + (Issue 39752) +
- Added the {@code android_getCpuIdArm()} and {@code android_setCpuArm()} methods to + {@code cpu-features.c}. This addition enables easier retrieval of the ARM CPUID + information. (Issue 53689) +
- Modified {@code ndk-build} to use GCC 4.7's {@code as/ld} for Clang compiling.
+
Note: + In GCC 4.7, {@code monotonic_clock} and {@code is_monotonic} have been renamed to + {@code steady_clock} and {@code is_steady}, respectively.
+ - Added the following new warnings to the {@code ndk-build} script:
+
-
+
- Added warnings if {@code LOCAL_LDLIBS/LDFLAGS} are used in static library + modules. +
- Added a warning if a configuration has no module to build. +
- Added a warning for non-system libraries being used in + {@code LOCAL_LDLIBS/LDFLAGS} of a shared library or executable modules. +
+ - Updated build scripts, so that if {@code APP_MODULES} is not defined and only static + libraries are listed in {@code Android.mk}, the script force-builds all of them. + (Issue 53502) +
- Updated {@code ndk-build} to support absolute paths in {@code LOCAL_SRC_FILES}. +
- Removed the {@code *-gdbtui} executables, which are duplicates of the {@code *-gdb} + executables with the {@code -tui} option enabled. +
- Updated the build scripts to warn you when the Edison Design Group (EDG) compiler + front-end turns {@code _STLP_HAS_INCLUDE_NEXT} back on. + (Issue 53646) +
- Added the environment variable {@code NDK_LIBS_OUT} to allow overriding of the + path for {@code libraries/gdbserver} from the default {@code $PROJECT/libs}. + For more information, see {@code OVERVIEW.html}. +
- Changed ndk-build script defaults to compile code with format string protection + {@code -Wformat -Werror=format-security}. You may set + {@code LOCAL_DISABLE_FORMAT_STRING_CHECKS=true} to disable it. + For more information, see {@code ANDROID-MK.html} +
- Added STL pretty-print support in {@code ndk-gdb-py}. For more information, see + {@code NDK-GDB.html}. +
- Added tests based on the googletest frameworks. +
- Added a notification to the toolchain build script that warns you if the current shell + is not {@code bash}. +
+ - Header Fixes
+