README
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
README.android
README.original
1**********************************************************************
2* README file for STLport 5.0 *
3* *
4**********************************************************************
5
6This directory contains the STLport-5.0 release.
7
8What's inside :
9
10README - this file
11INSTALL - installation instructions
12
13bin - installation directory for STLport unit tests;
14 it may contain more subdirs, if you use
15 crosscompilation
16build/lib - build directory for STLport library (if you use
17 STLport iostreams and/or locale only)
18build/test/unit - build directory for regression (unit) tests
19build/test/eh - build directory for exception handling tests
20stlport - main STLport include directory
21src - source for iostreams implementation and other parts
22 that aren't pure template code
23lib - installation directory for STLport library (if you
24 use STLport iostreams and/or locale only);
25 it may contain more subdirs, if you use
26 crosscompilation
27test/unit - unit (regression) tests
28test/eh - exception handling test using STLport iostreams
29etc - miscellanous files (ChangeLog, TODO, scripts, etc.)
30
31GETTING STLPORT
32
33To download the latest version of STLport, please be sure to visit
34https://sourceforge.net/project/showfiles.php?group_id=146814
35
36LEGALESE
37
38This software is being distributed under the following terms:
39
40 *
41 *
42 * Copyright (c) 1994
43 * Hewlett-Packard Company
44 *
45 * Copyright (c) 1996-1999
46 * Silicon Graphics Computer Systems, Inc.
47 *
48 * Copyright (c) 1997
49 * Moscow Center for SPARC Technology
50 *
51 * Copyright (c) 1999-2003
52 * Boris Fomitchev
53 *
54 * This material is provided "as is", with absolutely no warranty expressed
55 * or implied. Any use is at your own risk.
56 *
57 * Permission to use or copy this software for any purpose is hereby granted
58 * without fee, provided the above notices are retained on all copies.
59 * Permission to modify the code and to distribute modified code is granted,
60 * provided the above notices are retained, and a notice that the code was
61 * modified is included with the above copyright notice.
62 *
63
64**********************************************************************
65