1STLport for Android
2
3WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
4WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
5
6     This feature is currently in beta. In case of issue
7     please contact the android-ndk support forum or
8     file bugs at http://b.android.com
9
10WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
11WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
12
13This directory contains a port of STLport for Android, which provides
14a simple STL implementation. Note that it currently does not support
15C++ exceptions and RTTI. Support for wchar_t and locales is probably buggy.
16
17You can either use it as a static or shared library.
18
191/ The static library is recommended if you will only produce
20   one shared library for your project. All necessary STLport functions
21   will be added to it. This option should also generate smaller
22   overall binaries.
23
242/ The shared library, is recommended if you want to produce
25   several shared libraries in your project, because it avoids copying the
26   same STLport functions to each one of them, and having different instances
27   of the same global variables (which can easily conflict or result in
28   undefined behaviour).
29
30To use the *static* library, define APP_STL in your Application.mk as follows:
31
32    APP_STL := stlport_static
33
34To use the *shared* library, use "stlport_shared" instead:
35
36    APP_STL := stlport_shared
37
38Note that, in this case, you will need, in your application, to explicitely
39load the 'stlport_shared' library before any library that depends on it.
40For example:
41
42    static {
43        System.loadLibrary("stlport_shared");
44        System.loadLibrary("foo");
45        System.loadLibrary("bar");
46    }
47
48If both libfoo.so and libbar.so depend on STLport.
49
50You can build the STLport unit test program by doing the following:
51
52  cd $NDK
53  tests/run-tests.sh --test=test-stlport
54
55If you have an Android device connected to your machine, this will
56automatically try to run the generated test command. Note that for now
57a few tests are still failing (mostly related to wchar_t and locales).
58
59They should be fixed hopefully by a later release of this library.
60
61The NDK comes with prebuilt binaries for this library to speed up development.
62You can however rebuild them from sources in your own application build by
63defining STLPORT_FORCE_REBUILD to 'true' in your Application.mk as in:
64
65    STLPORT_FORCE_REBUILD := true
66
67
68VERSION INFORMATION: This module is based on STLport version 5.2.0
69
70