mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2025-11-04 16:27:18 +01:00
Major plugin refactor and cleanup.
Switched to POCO library for unified platform/library interface. Deprecated the external module API. It was creating more problems than solving. Removed most built-in libraries in favor of system libraries for easier maintenance. Cleaned and secured code with help from static analyzers.
This commit is contained in:
Sandu Liviu Catalin
114
vendor/POCO/doc/99300-AndroidPlatformNotes.page
vendored
Normal file
114
vendor/POCO/doc/99300-AndroidPlatformNotes.page
vendored
Normal file
@@ -0,0 +1,114 @@
|
||||
POCO C++ Libraries Android Platform Notes
|
||||
AAAIntroduction
|
||||
|
||||
!!!Introduction
|
||||
|
||||
Starting with release 1.4.2 the POCO C++ Libraries can be used on
|
||||
Android.
|
||||
In the past the android NDK used a gmake-based build system. They provided a
|
||||
a standalone "customized" toolchain. Also they used gcc and the gnu-stl as
|
||||
build environment. But these are all obsolete.
|
||||
|
||||
The newest android NDK is using a cmake based build system with a provided
|
||||
toolchain for cmake. Also they use now clang as compiler and the libc++ as
|
||||
standard library.
|
||||
|
||||
!!!Requirements
|
||||
|
||||
To build Poco for android you need as minimum the android NDK plus cmake executable.
|
||||
You can download the newest NDK from: https://developer.android.com/ndk and
|
||||
cmake from http://www.cmake.org or if you have already installed Android SDK,
|
||||
then install the NDK and cmake executable via the <*Android SDK Manager*>.
|
||||
|
||||
!!!Quick start
|
||||
|
||||
<path_to_android_sdk>/cmake/<cmake_version>/bin/cmake
|
||||
-H<path_to_poco_sourcen>
|
||||
-B/tmp/poco-build
|
||||
-G'Ninja'
|
||||
-DCMAKE_BUILD_TYPE=Release
|
||||
-DCMAKE_MAKE_PROGRAM=<path_to_android_sdk>/cmake/<cmake_version>/bin/ninja
|
||||
-DCMAKE_TOOLCHAIN_FILE=<path_to_android_sdk>/ndk-bundle/build/cmake/android.toolchain.cmake
|
||||
-DANDROID_NATIVE_API_LEVEL=24
|
||||
-DANDROID_ABI=armeabi-v7a
|
||||
|
||||
!!!Using Android's Build System
|
||||
|
||||
To start with build Poco for android you need following tools/executables:
|
||||
|
||||
- cmake executable from the host or Android SDK
|
||||
- Toolchain for cmake from Android NDK
|
||||
- Build tool executable make or ninja (ninja-build). Ninja is the prefered way to build and is
|
||||
also provided by the Android SDK.
|
||||
|
||||
If you are using cmake from the Android SDK, then you can found this executable in:
|
||||
<path_to_android_sdk>/cmake/<cmake_version>/bin/cmake
|
||||
also the ninja build tool:
|
||||
<path_to_android_sdk>/cmake/<cmake_version>/bin/ninja
|
||||
|
||||
The easiest way is to set the PATH environment to <path_to_android_sdk>/cmake/<cmake_version>/bin
|
||||
then cmake and ninja is found via the environment.
|
||||
If you not set the PATH environment you should add -DCMAKE_MAKE_PROGRAM=<path_to_android_sdk>/cmake/<cmake_version>/bin/ninja
|
||||
as parameter for cmake.
|
||||
|
||||
If you have didn't installed the Android SDK, it is also possible to use make as build tool:
|
||||
<path_to_android_sdk>/ndk-bundle/prebuilt/linux-x86_64/bin/make
|
||||
or
|
||||
<path_to_android_sdk>/ndk/<ndk_version>/prebuilt/linux-x86_64/bin/make
|
||||
|
||||
The easiest way is to set the PATH environment to <path_to_android_sdk>/ndk/<ndk_version>/prebuilt/linux-x86_64/bin.
|
||||
If you not set the PATH environment you should add -DCMAKE_MAKE_PROGRAM=<path_to_android_sdk>/ndk/<ndk_version>/prebuilt/linux-x86_64/bin/make
|
||||
as parameter for cmake.
|
||||
|
||||
The toolchain file can be found in the android NDK:
|
||||
<path_to_android_sdk>/ndk-bundle/build/cmake/android.toolchain.cmake
|
||||
or
|
||||
<path_to_android_sdk>/ndk/<ndk_version>/build/cmake/android.toolchain.cmake
|
||||
|
||||
To build poco with the default value from the NDK:
|
||||
|
||||
cmake -H<path_to_poco_sourcen> -B<path_to_build_dir>/poco_build -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=<path_to_android_sdk>/ndk-bundle/build/cmake/android.toolchain.cmake
|
||||
|
||||
The prefered way is to build with ninja:
|
||||
|
||||
cmake -H<path_to_poco_sourcen> -B<path_to_build_dir>/poco_build -G'Ninja' -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=<path_to_android_sdk>/ndk-bundle/build/cmake/android.toolchain.cmake
|
||||
|
||||
To build with the tools from the Android SDK:
|
||||
|
||||
<path_to_android_sdk>/cmake/<cmake_version>/bin/cmake
|
||||
-H<path_to_poco_sourcen>
|
||||
-B/tmp/poco-build
|
||||
-G'Ninja'
|
||||
-DCMAKE_BUILD_TYPE=Release
|
||||
-DCMAKE_MAKE_PROGRAM=<path_to_android_sdk>/cmake/<cmake_version>/bin/ninja
|
||||
-DCMAKE_TOOLCHAIN_FILE=<path_to_android_sdk>/ndk-bundle/build/cmake/android.toolchain.cmake
|
||||
|
||||
If you didn't set the <*ANDROID_NATIVE_API_LEVEL*> and <*ANDROID_ABI*> the android toolchain is using the default values.
|
||||
How to set <*ANDROID_NATIVE_API_LEVEL*> and <*ANDROID_ABI*> and what are the default values you can read this in the Android NDK documentation:
|
||||
https://developer.android.com/ndk/guides/cmake#options
|
||||
|
||||
To set poco build options see in GettingStarted.page#Building using CMake
|
||||
|
||||
!!!Restrictions
|
||||
|
||||
For the most part, the Linux and Android ports of the POCO C++ Libraries are very similar.
|
||||
However, there are a few restrictions due to the Binoic C library used by Android.
|
||||
|
||||
!!Poco::NamedEvent and Poco::NamedMutex
|
||||
|
||||
These classes are not supported on Android. While Poco::NamedEvent and
|
||||
Poco::NamedMutex objects can be created, any attempt to call a method
|
||||
of these classes will result in a Poco::NotImplementedException being thrown.
|
||||
|
||||
!!Poco::SharedMemory
|
||||
|
||||
Shared memory is not supported on Android.
|
||||
|
||||
!!Poco::FPEnvironment
|
||||
|
||||
The Poco::FPEnvironment class is not available on Android and
|
||||
cannot be used.
|
||||
|
||||
!!Poco::RWLock
|
||||
|
||||
On Android, Poco::RWLock is an ordinary mutex.
|
||||
Reference in New Issue
Block a user