summaryrefslogtreecommitdiffstats
path: root/9/sources/cxx-stl/EH/stlport/README
diff options
context:
space:
mode:
authorAndrew Hsieh <andrewhsieh@google.com>2013-09-06 19:09:51 +0800
committerAndrew Hsieh <andrewhsieh@google.com>2013-09-27 09:21:13 +0800
commit128c2d12428669556e6f2a9f0cd2bebe2ce24594 (patch)
treecf0e35cd599127b67cab2e0e5163cd0787ef3a80 /9/sources/cxx-stl/EH/stlport/README
parenta991515cbfa86149dfea7a9cd3af2300977b410b (diff)
downloadprebuilts_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/README69
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
+