1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/build/stlport/README Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,69 @@
1.4 +STLport for Android
1.5 +
1.6 +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
1.7 +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
1.8 +
1.9 + This feature is currently in beta. In case of issue
1.10 + please contact the android-ndk support forum or
1.11 + file bugs at http://b.android.com
1.12 +
1.13 +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
1.14 +WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
1.15 +
1.16 +This directory contains a port of STLport for Android, which provides
1.17 +a simple STL implementation. Note that it currently does not support
1.18 +C++ exceptions and RTTI. Support for wchar_t and locales is probably buggy.
1.19 +
1.20 +You can either use it as a static or shared library.
1.21 +
1.22 +1/ The static library is recommended if you will only produce
1.23 + one shared library for your project. All necessary STLport functions
1.24 + will be added to it. This option should also generate smaller
1.25 + overall binaries.
1.26 +
1.27 +2/ The shared library, is recommended if you want to produce
1.28 + several shared libraries in your project, because it avoids copying the
1.29 + same STLport functions to each one of them, and having different instances
1.30 + of the same global variables (which can easily conflict or result in
1.31 + undefined behaviour).
1.32 +
1.33 +To use the *static* library, define APP_STL in your Application.mk as follows:
1.34 +
1.35 + APP_STL := stlport_static
1.36 +
1.37 +To use the *shared* library, use "stlport_shared" instead:
1.38 +
1.39 + APP_STL := stlport_shared
1.40 +
1.41 +Note that, in this case, you will need, in your application, to explicitely
1.42 +load the 'stlport_shared' library before any library that depends on it.
1.43 +For example:
1.44 +
1.45 + static {
1.46 + System.loadLibrary("stlport_shared");
1.47 + System.loadLibrary("foo");
1.48 + System.loadLibrary("bar");
1.49 + }
1.50 +
1.51 +If both libfoo.so and libbar.so depend on STLport.
1.52 +
1.53 +You can build the STLport unit test program by doing the following:
1.54 +
1.55 + cd $NDK
1.56 + tests/run-tests.sh --test=test-stlport
1.57 +
1.58 +If you have an Android device connected to your machine, this will
1.59 +automatically try to run the generated test command. Note that for now
1.60 +a few tests are still failing (mostly related to wchar_t and locales).
1.61 +
1.62 +They should be fixed hopefully by a later release of this library.
1.63 +
1.64 +The NDK comes with prebuilt binaries for this library to speed up development.
1.65 +You can however rebuild them from sources in your own application build by
1.66 +defining STLPORT_FORCE_REBUILD to 'true' in your Application.mk as in:
1.67 +
1.68 + STLPORT_FORCE_REBUILD := true
1.69 +
1.70 +
1.71 +VERSION INFORMATION: This module is based on STLport version 5.2.0
1.72 +
