diff options
author | Richard Levitte <levitte@openssl.org> | 2020-03-03 17:20:07 +0100 |
---|---|---|
committer | Richard Levitte <levitte@openssl.org> | 2020-06-28 18:43:04 +0200 |
commit | 16b0e0fcb32f553b9302db997045950c6af5f805 (patch) | |
tree | 933de4b46a9bdd3984032548bb5b2292f708dd92 /NOTES.ANDROID | |
parent | 180626159e31f04021fdb20b48b1e61b62a06073 (diff) |
DOC: Mention Configure consistently
'config' is now a mere wrapper for backward compatibility.
All documentation is changed accordingly.
Reviewed-by: Tim Hudson <tjh@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/11230)
Diffstat (limited to 'NOTES.ANDROID')
-rw-r--r-- | NOTES.ANDROID | 42 |
1 files changed, 23 insertions, 19 deletions
diff --git a/NOTES.ANDROID b/NOTES.ANDROID index 57c1ee9d1b..0173eca73b 100644 --- a/NOTES.ANDROID +++ b/NOTES.ANDROID @@ -15,19 +15,22 @@ Configuration ------------- - Android is a naturally cross-compiled target and you can't use ./config. - You have to use ./Configure and name your target explicitly; there are - android-arm, android-arm64, android-mips, android-mip64, android-x86 - and android-x86_64 (*MIPS targets are no longer supported with NDK R20+). - Do not pass --cross-compile-prefix (as you might be tempted), as it will - be "calculated" automatically based on chosen platform. Though you still - need to know the prefix to extend your PATH, in order to invoke - $(CROSS_COMPILE)clang [*gcc on NDK 19 and lower] and company. (Configure - will fail and give you a hint if you get it wrong.) Apart from PATH - adjustment you need to set ANDROID_NDK_ROOT environment to point at the - NDK directory. If you're using a side-by-side NDK the path will look - something like /some/where/android-sdk/ndk/<ver>, and for a standalone - NDK the path will be something like /some/where/android-ndk-<ver>. + Android is a cross-compiled target and you can't rely on ./Configure + to find out the configuration target for you. You have to name your + target explicitly; there are android-arm, android-arm64, android-mips, + android-mip64, android-x86 and android-x86_64 (*MIPS targets are no + longer supported with NDK R20+). + + Do not pass --cross-compile-prefix (as you might be tempted), as it + will be "calculated" automatically based on chosen platform. However, + you still need to know the prefix to extend your PATH, in order to + invoke $(CROSS_COMPILE)clang [*gcc on NDK 19 and lower] and company. + (Configure will fail and give you a hint if you get it wrong.) + + Apart from PATH adjustment you need to set ANDROID_NDK_ROOT environment + to point at the NDK directory. If you're using a side-by-side NDK the path + will look something like /some/where/android-sdk/ndk/<ver>, and for a + standalone NDK the path will be something like /some/where/android-ndk-<ver>. Both variables are significant at both configuration and compilation times. The NDK customarily supports multiple Android API levels, e.g. android-14, android-21, etc. By default latest API level is chosen. If you need to @@ -35,13 +38,14 @@ with N being the numerical value of the target platform version. For example, to compile for Android 10 arm64 with a side-by-side NDK r20.0.5594570 - export ANDROID_NDK_ROOT=/home/whoever/Android/android-sdk/ndk/20.0.5594570 - PATH=$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/bin:$ANDROID_NDK_ROOT/toolchains/arm-linux-androideabi-4.9/prebuilt/linux-x86_64/bin:$PATH - ./Configure android-arm64 -D__ANDROID_API__=29 - make + export ANDROID_NDK_ROOT=/home/whoever/Android/android-sdk/ndk/20.0.5594570 + PATH=$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/bin:$ANDROID_NDK_ROOT/toolchains/arm-linux-androideabi-4.9/prebuilt/linux-x86_64/bin:$PATH + ./Configure android-arm64 -D__ANDROID_API__=29 + make - Older versions of the NDK have GCC under their common prebuilt tools directory, so the bin path - will be slightly different. EG: to compile for ICS on ARM with NDK 10d: + Older versions of the NDK have GCC under their common prebuilt tools + directory, so the bin path will be slightly different. EG: to compile + for ICS on ARM with NDK 10d: export ANDROID_NDK_ROOT=/some/where/android-ndk-10d PATH=$ANDROID_NDK_ROOT/toolchains/arm-linux-androideabi-4.8/prebuilt/linux-x86_64/bin:$PATH |