diff options
author | Andrew Hsieh <andrewhsieh@google.com> | 2013-09-06 19:09:51 +0800 |
---|---|---|
committer | Andrew Hsieh <andrewhsieh@google.com> | 2013-09-27 09:21:13 +0800 |
commit | 128c2d12428669556e6f2a9f0cd2bebe2ce24594 (patch) | |
tree | cf0e35cd599127b67cab2e0e5163cd0787ef3a80 /9/sources/cxx-stl/EH/stlport/README | |
parent | a991515cbfa86149dfea7a9cd3af2300977b410b (diff) | |
download | prebuilts_ndk-128c2d12428669556e6f2a9f0cd2bebe2ce24594.zip prebuilts_ndk-128c2d12428669556e6f2a9f0cd2bebe2ce24594.tar.gz prebuilts_ndk-128c2d12428669556e6f2a9f0cd2bebe2ce24594.tar.bz2 |
Switch prebuilts/ndk "current" from r8 to r9
Also symlink sources/cxx-stl/{gabi++,stlport} to the ones in
8/ (which stay at r8c before exception handling is added). This is
temporary workaround due to
1. Some projects compile with prebuilts/ndk but link with platform's old
stlport, causing error reads:
prebuilts/ndk/current/sources/cxx-stl/stlport/stlport/stl/_ostream.h:187:
error: undefined reference to 'std::uncaught_exception()'
2. Some projects don't have -ldl when link with stlport in prebuilts/ndk
which now uses dlopen
3. Some [vendor] binaries linked with platform's stlport may run erratically
when used in unbundled apps which link with new stlport
Change-Id: Icb7c56a69ceac860636f1c4d0abe98369bbf1c19
Diffstat (limited to '9/sources/cxx-stl/EH/stlport/README')
-rw-r--r-- | 9/sources/cxx-stl/EH/stlport/README | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/9/sources/cxx-stl/EH/stlport/README b/9/sources/cxx-stl/EH/stlport/README new file mode 100644 index 0000000..8f602fe --- /dev/null +++ b/9/sources/cxx-stl/EH/stlport/README @@ -0,0 +1,69 @@ +STLport for Android + +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING + + This feature is currently in beta. In case of issue + please contact the android-ndk support forum or + file bugs at http://b.android.com + +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING + +This directory contains a port of STLport for Android, which provides +a simple STL implementation. Note that it currently does not support +C++ exceptions and RTTI. Support for wchar_t and locales is probably buggy. + +You can either use it as a static or shared library. + +1/ The static library is recommended if you will only produce + one shared library for your project. All necessary STLport functions + will be added to it. This option should also generate smaller + overall binaries. + +2/ The shared library, is recommended if you want to produce + several shared libraries in your project, because it avoids copying the + same STLport functions to each one of them, and having different instances + of the same global variables (which can easily conflict or result in + undefined behaviour). + +To use the *static* library, define APP_STL in your Application.mk as follows: + + APP_STL := stlport_static + +To use the *shared* library, use "stlport_shared" instead: + + APP_STL := stlport_shared + +Note that, in this case, you will need, in your application, to explicitely +load the 'stlport_shared' library before any library that depends on it. +For example: + + static { + System.loadLibrary("stlport_shared"); + System.loadLibrary("foo"); + System.loadLibrary("bar"); + } + +If both libfoo.so and libbar.so depend on STLport. + +You can build the STLport unit test program by doing the following: + + cd $NDK + tests/run-tests.sh --test=test-stlport + +If you have an Android device connected to your machine, this will +automatically try to run the generated test command. Note that for now +a few tests are still failing (mostly related to wchar_t and locales). + +They should be fixed hopefully by a later release of this library. + +The NDK comes with prebuilt binaries for this library to speed up development. +You can however rebuild them from sources in your own application build by +defining STLPORT_FORCE_REBUILD to 'true' in your Application.mk as in: + + STLPORT_FORCE_REBUILD := true + + +VERSION INFORMATION: This module is based on STLport version 5.2.0 + |