1# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
2# file Copyright.txt or https://cmake.org/licensing for details.
3
4# When CMAKE_SYSTEM_NAME is "Android", CMakeDetermineSystem loads this module.
5# This module detects platform-wide information about the Android target
6# in order to store it in "CMakeSystem.cmake".
7
8# Include the NDK hook.
9# It can be used by NDK to inject necessary fixes for an earlier cmake.
10if(CMAKE_ANDROID_NDK)
11  include(${CMAKE_ANDROID_NDK}/build/cmake/hooks/pre/Android-Determine.cmake OPTIONAL)
12endif()
13
14# Support for NVIDIA Nsight Tegra Visual Studio Edition was previously
15# implemented in the CMake VS IDE generators.  Avoid interfering with
16# that functionality for now.
17if(CMAKE_GENERATOR_PLATFORM STREQUAL "Tegra-Android")
18  return()
19endif()
20
21# Commonly used Android toolchain files that pre-date CMake upstream support
22# set CMAKE_SYSTEM_VERSION to 1.  Avoid interfering with them.
23if(CMAKE_SYSTEM_VERSION EQUAL 1)
24  return()
25endif()
26
27# Natively compiling on an Android host doesn't use the NDK cross-compilation
28# tools.
29if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Android")
30  return()
31endif()
32
33cmake_policy(PUSH)
34cmake_policy(SET CMP0057 NEW) # if IN_LIST
35
36# If using Android tools for Visual Studio, compile a sample project to get the
37# sysroot.
38if(CMAKE_GENERATOR MATCHES "Visual Studio")
39  if(NOT CMAKE_SYSROOT)
40    set(vcx_platform ${CMAKE_GENERATOR_PLATFORM})
41    if(CMAKE_GENERATOR MATCHES "Visual Studio 1[45]")
42      set(vcx_sysroot_var "Sysroot")
43    else()
44      set(vcx_sysroot_var "SysrootLink")
45    endif()
46    if(CMAKE_GENERATOR MATCHES "Visual Studio 14")
47      set(vcx_revision "2.0")
48    elseif(CMAKE_GENERATOR MATCHES "Visual Studio 1[56]")
49      set(vcx_revision "3.0")
50    else()
51      set(vcx_revision "")
52    endif()
53    configure_file(${CMAKE_ROOT}/Modules/Platform/Android/VCXProjInspect.vcxproj.in
54      ${CMAKE_PLATFORM_INFO_DIR}/VCXProjInspect.vcxproj @ONLY)
55    cmake_host_system_information(RESULT _msbuild QUERY VS_MSBUILD_COMMAND) # undocumented query
56    execute_process(
57      COMMAND "${_msbuild}" "VCXProjInspect.vcxproj"
58        "/p:Configuration=Debug" "/p:Platform=${vcx_platform}"
59      WORKING_DIRECTORY ${CMAKE_PLATFORM_INFO_DIR}
60      OUTPUT_VARIABLE VCXPROJ_INSPECT_OUTPUT
61      ERROR_VARIABLE VCXPROJ_INSPECT_OUTPUT
62      RESULT_VARIABLE VCXPROJ_INSPECT_RESULT
63      )
64    unset(_msbuild)
65    if(NOT CMAKE_SYSROOT AND VCXPROJ_INSPECT_OUTPUT MATCHES "CMAKE_SYSROOT=([^%\r\n]+)[\r\n]")
66      # Strip VS diagnostic output from the end of the line.
67      string(REGEX REPLACE " \\(TaskId:[0-9]*\\)$" "" _sysroot "${CMAKE_MATCH_1}")
68      if(EXISTS "${_sysroot}")
69        file(TO_CMAKE_PATH "${_sysroot}" CMAKE_SYSROOT)
70      endif()
71    endif()
72    if(VCXPROJ_INSPECT_RESULT)
73      file(APPEND ${CMAKE_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/CMakeError.log
74        "Determining the sysroot for the Android NDK failed.
75The output was:
76${VCXPROJ_INSPECT_RESULT}
77${VCXPROJ_INSPECT_OUTPUT}
78
79")
80    else()
81      file(APPEND ${CMAKE_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/CMakeOutput.log
82        "Determining the sysroot for the Android NDK succeeded.
83The output was:
84${VCXPROJ_INSPECT_RESULT}
85${VCXPROJ_INSPECT_OUTPUT}
86
87")
88    endif()
89  endif()
90  if(NOT CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION)
91    set(CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION "clang")
92  endif()
93endif()
94
95# If the user provided CMAKE_SYSROOT for us, extract information from it.
96set(_ANDROID_SYSROOT_NDK "")
97set(_ANDROID_SYSROOT_API "")
98set(_ANDROID_SYSROOT_ARCH "")
99set(_ANDROID_SYSROOT_STANDALONE_TOOLCHAIN "")
100if(CMAKE_SYSROOT)
101  if(NOT IS_DIRECTORY "${CMAKE_SYSROOT}")
102    message(FATAL_ERROR
103      "Android: The specified CMAKE_SYSROOT:\n"
104      "  ${CMAKE_SYSROOT}\n"
105      "is not an existing directory."
106      )
107  endif()
108  if(CMAKE_SYSROOT MATCHES "^([^\\\n]*)/platforms/android-([0-9]+)/arch-([a-z0-9_]+)$")
109    set(_ANDROID_SYSROOT_NDK "${CMAKE_MATCH_1}")
110    set(_ANDROID_SYSROOT_API "${CMAKE_MATCH_2}")
111    set(_ANDROID_SYSROOT_ARCH "${CMAKE_MATCH_3}")
112  elseif(CMAKE_SYSROOT MATCHES "^([^\\\n]*)/sysroot$")
113    set(_ANDROID_SYSROOT_STANDALONE_TOOLCHAIN "${CMAKE_MATCH_1}")
114  else()
115    message(FATAL_ERROR
116      "The value of CMAKE_SYSROOT:\n"
117      "  ${CMAKE_SYSROOT}\n"
118      "does not match any of the forms:\n"
119      "  <ndk>/platforms/android-<api>/arch-<arch>\n"
120      "  <standalone-toolchain>/sysroot\n"
121      "where:\n"
122      "  <ndk>  = Android NDK directory (with forward slashes)\n"
123      "  <api>  = Android API version number (decimal digits)\n"
124      "  <arch> = Android ARCH name (lower case)\n"
125      "  <standalone-toolchain> = Path to standalone toolchain prefix\n"
126      )
127  endif()
128endif()
129
130# Find the Android NDK.
131if(CMAKE_ANDROID_NDK)
132  if(NOT IS_DIRECTORY "${CMAKE_ANDROID_NDK}")
133    message(FATAL_ERROR
134      "Android: The NDK root directory specified by CMAKE_ANDROID_NDK:\n"
135      "  ${CMAKE_ANDROID_NDK}\n"
136      "does not exist."
137      )
138  endif()
139elseif(CMAKE_ANDROID_STANDALONE_TOOLCHAIN)
140  if(NOT IS_DIRECTORY "${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}")
141    message(FATAL_ERROR
142      "Android: The standalone toolchain directory specified by CMAKE_ANDROID_STANDALONE_TOOLCHAIN:\n"
143      "  ${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}\n"
144      "does not exist."
145      )
146  endif()
147  if(NOT EXISTS "${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot/usr/include/android/api-level.h")
148    message(FATAL_ERROR
149      "Android: The standalone toolchain directory specified by CMAKE_ANDROID_STANDALONE_TOOLCHAIN:\n"
150      "  ${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}\n"
151      "does not contain a sysroot with a known layout.  The file:\n"
152      "  ${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot/usr/include/android/api-level.h\n"
153      "does not exist."
154      )
155  endif()
156else()
157  if(IS_DIRECTORY "${_ANDROID_SYSROOT_NDK}")
158    set(CMAKE_ANDROID_NDK "${_ANDROID_SYSROOT_NDK}")
159  elseif(IS_DIRECTORY "${_ANDROID_SYSROOT_STANDALONE_TOOLCHAIN}")
160    set(CMAKE_ANDROID_STANDALONE_TOOLCHAIN "${_ANDROID_SYSROOT_STANDALONE_TOOLCHAIN}")
161  elseif(IS_DIRECTORY "${ANDROID_NDK}")
162    file(TO_CMAKE_PATH "${ANDROID_NDK}" CMAKE_ANDROID_NDK)
163  elseif(IS_DIRECTORY "${ANDROID_STANDALONE_TOOLCHAIN}")
164    file(TO_CMAKE_PATH "${ANDROID_STANDALONE_TOOLCHAIN}" CMAKE_ANDROID_STANDALONE_TOOLCHAIN)
165  elseif(IS_DIRECTORY "$ENV{ANDROID_NDK_ROOT}")
166    file(TO_CMAKE_PATH "$ENV{ANDROID_NDK_ROOT}" CMAKE_ANDROID_NDK)
167  elseif(IS_DIRECTORY "$ENV{ANDROID_NDK}")
168    file(TO_CMAKE_PATH "$ENV{ANDROID_NDK}" CMAKE_ANDROID_NDK)
169  elseif(IS_DIRECTORY "$ENV{ANDROID_STANDALONE_TOOLCHAIN}")
170    file(TO_CMAKE_PATH "$ENV{ANDROID_STANDALONE_TOOLCHAIN}" CMAKE_ANDROID_STANDALONE_TOOLCHAIN)
171  endif()
172  # TODO: Search harder for the NDK or standalone toolchain.
173endif()
174
175set(_ANDROID_STANDALONE_TOOLCHAIN_API "")
176if(CMAKE_ANDROID_STANDALONE_TOOLCHAIN)
177  # Try to read the API level from the toolchain launcher.
178  if(EXISTS "${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/bin/clang")
179    set(_ANDROID_API_LEVEL_CLANG_REGEX "__ANDROID_API__=([0-9]+)")
180    file(STRINGS "${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/bin/clang" _ANDROID_STANDALONE_TOOLCHAIN_BIN_CLANG
181      REGEX "${_ANDROID_API_LEVEL_CLANG_REGEX}" LIMIT_COUNT 1 LIMIT_INPUT 65536)
182    if(_ANDROID_STANDALONE_TOOLCHAIN_BIN_CLANG MATCHES "${_ANDROID_API_LEVEL_CLANG_REGEX}")
183      set(_ANDROID_STANDALONE_TOOLCHAIN_API "${CMAKE_MATCH_1}")
184    endif()
185    unset(_ANDROID_STANDALONE_TOOLCHAIN_BIN_CLANG)
186    unset(_ANDROID_API_LEVEL_CLANG_REGEX)
187  endif()
188  if(NOT _ANDROID_STANDALONE_TOOLCHAIN_API)
189    # The compiler launcher does not know __ANDROID_API__.  Assume this
190    # is not unified headers and look for it in the api-level.h header.
191    set(_ANDROID_API_LEVEL_H_REGEX "^[\t ]*#[\t ]*define[\t ]+__ANDROID_API__[\t ]+([0-9]+)")
192    file(STRINGS "${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot/usr/include/android/api-level.h"
193      _ANDROID_API_LEVEL_H_CONTENT REGEX "${_ANDROID_API_LEVEL_H_REGEX}")
194    if(_ANDROID_API_LEVEL_H_CONTENT MATCHES "${_ANDROID_API_LEVEL_H_REGEX}")
195      set(_ANDROID_STANDALONE_TOOLCHAIN_API "${CMAKE_MATCH_1}")
196    endif()
197  endif()
198  if(NOT _ANDROID_STANDALONE_TOOLCHAIN_API)
199    message(WARNING
200      "Android: Did not detect API level from\n"
201      "  ${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/bin/clang\n"
202      "or\n"
203      "  ${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot/usr/include/android/api-level.h\n"
204      )
205  endif()
206endif()
207
208if(NOT CMAKE_ANDROID_NDK AND NOT CMAKE_ANDROID_STANDALONE_TOOLCHAIN)
209  message(FATAL_ERROR "Android: Neither the NDK or a standalone toolchain was found.")
210endif()
211
212if(CMAKE_ANDROID_NDK)
213  # NDK >= 18 has platforms.cmake. It provides:
214  #   NDK_MIN_PLATFORM_LEVEL
215  #   NDK_MAX_PLATFORM_LEVEL
216  include("${CMAKE_ANDROID_NDK}/build/cmake/platforms.cmake" OPTIONAL RESULT_VARIABLE _INCLUDED_PLATFORMS)
217  # NDK >= 18 has abis.cmake. It provides:
218  #   NDK_KNOWN_DEVICE_ABI32S
219  #   NDK_KNOWN_DEVICE_ABI64S
220  # NDK >= 23 also provides:
221  #   NDK_KNOWN_DEVICE_ABIS
222  #   NDK_ABI_<abi>_PROC
223  #   NDK_ABI_<abi>_ARCH
224  #   NDK_ABI_<abi>_TRIPLE
225  #   NDK_ABI_<abi>_LLVM_TRIPLE
226  #   NDK_PROC_<processor>_ABI
227  #   NDK_ARCH_<arch>_ABI
228  include("${CMAKE_ANDROID_NDK}/build/cmake/abis.cmake" OPTIONAL RESULT_VARIABLE _INCLUDED_ABIS)
229endif()
230
231if(CMAKE_ANDROID_NDK AND EXISTS "${CMAKE_ANDROID_NDK}/source.properties")
232  # Android NDK revision
233  # Possible formats:
234  # * r16, build 1234: 16.0.1234
235  # * r16b, build 1234: 16.1.1234
236  # * r16 beta 1, build 1234: 16.0.1234-beta1
237  #
238  # Canary builds are not specially marked.
239  file(READ "${CMAKE_ANDROID_NDK}/source.properties" _ANDROID_NDK_SOURCE_PROPERTIES)
240
241  set(_ANDROID_NDK_REVISION_REGEX
242    "^Pkg\\.Desc = Android NDK\nPkg\\.Revision = ([0-9]+)\\.([0-9]+)\\.([0-9]+)(-beta([0-9]+))?")
243  if(NOT _ANDROID_NDK_SOURCE_PROPERTIES MATCHES "${_ANDROID_NDK_REVISION_REGEX}")
244    string(REPLACE "\n" "\n  " _ANDROID_NDK_SOURCE_PROPERTIES "${_ANDROID_NDK_SOURCE_PROPERTIES}")
245    message(FATAL_ERROR
246      "Android: Failed to parse NDK revision from:\n"
247      " ${CMAKE_ANDROID_NDK}/source.properties\n"
248      "with content:\n"
249      "  ${_ANDROID_NDK_SOURCE_PROPERTIES}")
250  endif()
251
252  set(_ANDROID_NDK_MAJOR "${CMAKE_MATCH_1}")
253  set(_ANDROID_NDK_MINOR "${CMAKE_MATCH_2}")
254  set(_ANDROID_NDK_BUILD "${CMAKE_MATCH_3}")
255  set(_ANDROID_NDK_BETA "${CMAKE_MATCH_5}")
256  if(_ANDROID_NDK_BETA STREQUAL "")
257    set(_ANDROID_NDK_BETA "0")
258  endif()
259  set(CMAKE_ANDROID_NDK_VERSION "${_ANDROID_NDK_MAJOR}.${_ANDROID_NDK_MINOR}")
260
261  unset(_ANDROID_NDK_SOURCE_PROPERTIES)
262  unset(_ANDROID_NDK_REVISION_REGEX)
263  unset(_ANDROID_NDK_MAJOR)
264  unset(_ANDROID_NDK_MINOR)
265  unset(_ANDROID_NDK_BUILD)
266  unset(_ANDROID_NDK_BETA)
267endif()
268
269if(CMAKE_ANDROID_NDK)
270  # Identify the host platform.
271  if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Darwin")
272    if(CMAKE_HOST_SYSTEM_PROCESSOR MATCHES "64")
273      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "darwin-x86_64")
274    else()
275      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "darwin-x86")
276    endif()
277  elseif(CMAKE_HOST_SYSTEM_NAME STREQUAL "Linux")
278    if(CMAKE_HOST_SYSTEM_PROCESSOR STREQUAL "x86_64")
279      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "linux-x86_64")
280    else()
281      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "linux-x86")
282    endif()
283  elseif(CMAKE_HOST_SYSTEM_NAME STREQUAL "Windows")
284    if(CMAKE_HOST_SYSTEM_PROCESSOR STREQUAL "AMD64")
285      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "windows-x86_64")
286    else()
287      set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "windows")
288    endif()
289  else()
290    message(FATAL_ERROR "Android: Builds hosted on '${CMAKE_HOST_SYSTEM_NAME}' not supported.")
291  endif()
292
293  # Look for a unified toolchain/sysroot provided with the NDK.
294  set(CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED "${CMAKE_ANDROID_NDK}/toolchains/llvm/prebuilt/${CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG}")
295  if(NOT IS_DIRECTORY "${CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED}/sysroot")
296    set(CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED "")
297  endif()
298else()
299  set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG "")
300  set(CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED "")
301endif()
302
303if(_INCLUDED_ABIS)
304  if(NDK_KNOWN_DEVICE_ABIS)
305    set(_ANDROID_KNOWN_ABIS ${NDK_KNOWN_DEVICE_ABIS})
306  else()
307    set(_ANDROID_KNOWN_ABIS ${NDK_KNOWN_DEVICE_ABI32S} ${NDK_KNOWN_DEVICE_ABI64S})
308  endif()
309endif()
310
311if(NOT DEFINED NDK_KNOWN_DEVICE_ABIS)
312  # The NDK is not new enough to provide ABI information.
313  # https://developer.android.com/ndk/guides/abis.html
314
315  set(NDK_ABI_arm64-v8a_PROC           "aarch64")
316  set(NDK_ABI_arm64-v8a_ARCH           "arm64")
317  set(NDK_ABI_arm64-v8a_TRIPLE         "aarch64-linux-android")
318  set(NDK_ABI_arm64-v8a_LLVM_TRIPLE    "aarch64-none-linux-android")
319  set(NDK_ABI_armeabi-v7a_PROC         "armv7-a")
320  set(NDK_ABI_armeabi-v7a_ARCH         "arm")
321  set(NDK_ABI_armeabi-v7a_TRIPLE       "arm-linux-androideabi")
322  set(NDK_ABI_armeabi-v7a_LLVM_TRIPLE  "armv7-none-linux-androideabi")
323  set(NDK_ABI_armeabi-v6_PROC          "armv6")
324  set(NDK_ABI_armeabi-v6_ARCH          "arm")
325  set(NDK_ABI_armeabi-v6_TRIPLE        "arm-linux-androideabi")
326  set(NDK_ABI_armeabi-v6_LLVM_TRIPLE   "armv6-none-linux-androideabi")
327  set(NDK_ABI_armeabi_PROC             "armv5te")
328  set(NDK_ABI_armeabi_ARCH             "arm")
329  set(NDK_ABI_armeabi_TRIPLE           "arm-linux-androideabi")
330  set(NDK_ABI_armeabi_LLVM_TRIPLE      "armv5te-none-linux-androideabi")
331  set(NDK_ABI_mips_PROC                "mips")
332  set(NDK_ABI_mips_ARCH                "mips")
333  set(NDK_ABI_mips_TRIPLE              "mipsel-linux-android")
334  set(NDK_ABI_mips_LLVM_TRIPLE         "mipsel-none-linux-android")
335  set(NDK_ABI_mips64_PROC              "mips64")
336  set(NDK_ABI_mips64_ARCH              "mips64")
337  set(NDK_ABI_mips64_TRIPLE            "mips64el-linux-android")
338  set(NDK_ABI_mips64_LLVM_TRIPLE       "mips64el-none-linux-android")
339  set(NDK_ABI_x86_PROC                 "i686")
340  set(NDK_ABI_x86_ARCH                 "x86")
341  set(NDK_ABI_x86_TRIPLE               "i686-linux-android")
342  set(NDK_ABI_x86_LLVM_TRIPLE          "i686-none-linux-android")
343  set(NDK_ABI_x86_64_PROC              "x86_64")
344  set(NDK_ABI_x86_64_ARCH              "x86_64")
345  set(NDK_ABI_x86_64_TRIPLE            "x86_64-linux-android")
346  set(NDK_ABI_x86_64_LLVM_TRIPLE       "x86_64-none-linux-android")
347
348  set(NDK_PROC_aarch64_ABI "arm64-v8a")
349  set(NDK_PROC_armv7-a_ABI "armeabi-v7a")
350  set(NDK_PROC_armv6_ABI   "armeabi-v6")
351  set(NDK_PROC_armv5te_ABI "armeabi")
352  set(NDK_PROC_i686_ABI    "x86")
353  set(NDK_PROC_mips_ABI    "mips")
354  set(NDK_PROC_mips64_ABI  "mips64")
355  set(NDK_PROC_x86_64_ABI  "x86_64")
356
357  set(NDK_ARCH_arm64_ABI  "arm64-v8a")
358  set(NDK_ARCH_arm_ABI    "armeabi")
359  set(NDK_ARCH_mips_ABI   "mips")
360  set(NDK_ARCH_mips64_ABI "mips64")
361  set(NDK_ARCH_x86_ABI    "x86")
362  set(NDK_ARCH_x86_64_ABI "x86_64")
363endif()
364
365# Validate inputs.
366if(CMAKE_ANDROID_ARCH_ABI AND NOT DEFINED "NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_PROC")
367  message(FATAL_ERROR "Android: Unknown ABI CMAKE_ANDROID_ARCH_ABI='${CMAKE_ANDROID_ARCH_ABI}'.")
368endif()
369if(CMAKE_SYSTEM_PROCESSOR AND NOT DEFINED "NDK_PROC_${CMAKE_SYSTEM_PROCESSOR}_ABI")
370  message(FATAL_ERROR "Android: Unknown processor CMAKE_SYSTEM_PROCESSOR='${CMAKE_SYSTEM_PROCESSOR}'.")
371endif()
372if(_ANDROID_SYSROOT_ARCH AND NOT DEFINED "NDK_ARCH_${_ANDROID_SYSROOT_ARCH}_ABI")
373  message(FATAL_ERROR
374    "Android: Unknown architecture '${_ANDROID_SYSROOT_ARCH}' specified in CMAKE_SYSROOT:\n"
375    "  ${CMAKE_SYSROOT}"
376    )
377endif()
378
379# Select an ABI.
380if(NOT CMAKE_ANDROID_ARCH_ABI)
381  if(CMAKE_SYSTEM_PROCESSOR)
382    set(CMAKE_ANDROID_ARCH_ABI "${NDK_PROC_${CMAKE_SYSTEM_PROCESSOR}_ABI}")
383  elseif(_ANDROID_SYSROOT_ARCH)
384    set(CMAKE_ANDROID_ARCH_ABI "${NDK_ARCH_${_ANDROID_SYSROOT_ARCH}_ABI}")
385  elseif(_INCLUDED_ABIS)
386    # Default to the oldest ARM ABI.
387    foreach(abi armeabi armeabi-v7a arm64-v8a)
388      if("${abi}" IN_LIST _ANDROID_KNOWN_ABIS)
389        set(CMAKE_ANDROID_ARCH_ABI "${abi}")
390        break()
391      endif()
392    endforeach()
393    if(NOT CMAKE_ANDROID_ARCH_ABI)
394      message(FATAL_ERROR
395        "Android: Can not determine the default ABI. Please set CMAKE_ANDROID_ARCH_ABI."
396      )
397    endif()
398  else()
399    # https://developer.android.com/ndk/guides/application_mk.html
400    # Default is the oldest ARM ABI.
401
402    # Lookup the available ABIs among all toolchains.
403    set(_ANDROID_ABIS "")
404    file(GLOB _ANDROID_CONFIG_MKS
405      "${CMAKE_ANDROID_NDK}/build/core/toolchains/*/config.mk"
406      "${CMAKE_ANDROID_NDK}/toolchains/*/config.mk"
407      )
408    foreach(config_mk IN LISTS _ANDROID_CONFIG_MKS)
409      file(STRINGS "${config_mk}" _ANDROID_TOOL_ABIS REGEX "^TOOLCHAIN_ABIS :=")
410      string(REPLACE "TOOLCHAIN_ABIS :=" "" _ANDROID_TOOL_ABIS "${_ANDROID_TOOL_ABIS}")
411      separate_arguments(_ANDROID_TOOL_ABIS UNIX_COMMAND "${_ANDROID_TOOL_ABIS}")
412      list(APPEND _ANDROID_ABIS ${_ANDROID_TOOL_ABIS})
413      unset(_ANDROID_TOOL_ABIS)
414    endforeach()
415    unset(_ANDROID_CONFIG_MKS)
416
417    # Choose the oldest among the available arm ABIs.
418    if(_ANDROID_ABIS)
419      list(REMOVE_DUPLICATES _ANDROID_ABIS)
420      foreach(abi armeabi armeabi-v7a arm64-v8a)
421        if("${abi}" IN_LIST _ANDROID_ABIS)
422          set(CMAKE_ANDROID_ARCH_ABI "${abi}")
423          break()
424        endif()
425      endforeach()
426    endif()
427    unset(_ANDROID_ABIS)
428
429    if(NOT CMAKE_ANDROID_ARCH_ABI)
430      set(CMAKE_ANDROID_ARCH_ABI "armeabi")
431    endif()
432  endif()
433endif()
434if(_INCLUDED_ABIS AND NOT CMAKE_ANDROID_ARCH_ABI IN_LIST _ANDROID_KNOWN_ABIS)
435  message(FATAL_ERROR
436    "Android: ABI '${CMAKE_ANDROID_ARCH_ABI}' is not supported by the NDK.\n"
437    "Supported ABIS: ${_ANDROID_KNOWN_ABIS}."
438  )
439endif()
440set(CMAKE_ANDROID_ARCH "${NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_ARCH}")
441if(_ANDROID_SYSROOT_ARCH AND NOT "x${_ANDROID_SYSROOT_ARCH}" STREQUAL "x${CMAKE_ANDROID_ARCH}")
442  message(FATAL_ERROR
443    "Android: Architecture '${_ANDROID_SYSROOT_ARCH}' specified in CMAKE_SYSROOT:\n"
444    "  ${CMAKE_SYSROOT}\n"
445    "does not match architecture '${CMAKE_ANDROID_ARCH}' for the ABI '${CMAKE_ANDROID_ARCH_ABI}'."
446    )
447endif()
448set(CMAKE_ANDROID_ARCH_TRIPLE "${NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_TRIPLE}")
449set(CMAKE_ANDROID_ARCH_LLVM_TRIPLE
450    "${NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_LLVM_TRIPLE}")
451
452# Select a processor.
453if(NOT CMAKE_SYSTEM_PROCESSOR)
454  set(CMAKE_SYSTEM_PROCESSOR "${NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_PROC}")
455endif()
456
457# If the user specified both an ABI and a processor then they might not match.
458if(NOT NDK_ABI_${CMAKE_ANDROID_ARCH_ABI}_PROC STREQUAL CMAKE_SYSTEM_PROCESSOR)
459  message(FATAL_ERROR "Android: The specified CMAKE_ANDROID_ARCH_ABI='${CMAKE_ANDROID_ARCH_ABI}' and CMAKE_SYSTEM_PROCESSOR='${CMAKE_SYSTEM_PROCESSOR}' is not a valid combination.")
460endif()
461
462# Select an API.
463if(CMAKE_SYSTEM_VERSION)
464  set(_ANDROID_API_VAR CMAKE_SYSTEM_VERSION)
465elseif(CMAKE_ANDROID_API)
466  set(CMAKE_SYSTEM_VERSION "${CMAKE_ANDROID_API}")
467  set(_ANDROID_API_VAR CMAKE_ANDROID_API)
468elseif(_ANDROID_SYSROOT_API)
469  set(CMAKE_SYSTEM_VERSION "${_ANDROID_SYSROOT_API}")
470  set(_ANDROID_API_VAR CMAKE_SYSROOT)
471elseif(_ANDROID_STANDALONE_TOOLCHAIN_API)
472  set(CMAKE_SYSTEM_VERSION "${_ANDROID_STANDALONE_TOOLCHAIN_API}")
473endif()
474if(CMAKE_SYSTEM_VERSION)
475  if(CMAKE_ANDROID_API AND NOT "x${CMAKE_ANDROID_API}" STREQUAL "x${CMAKE_SYSTEM_VERSION}")
476    message(FATAL_ERROR
477      "Android: The API specified by CMAKE_ANDROID_API='${CMAKE_ANDROID_API}' is not consistent with CMAKE_SYSTEM_VERSION='${CMAKE_SYSTEM_VERSION}'."
478      )
479  endif()
480  if(_ANDROID_SYSROOT_API)
481    foreach(v CMAKE_ANDROID_API CMAKE_SYSTEM_VERSION)
482      if(${v} AND NOT "x${_ANDROID_SYSROOT_API}" STREQUAL "x${${v}}")
483        message(FATAL_ERROR
484          "Android: The API specified by ${v}='${${v}}' is not consistent with CMAKE_SYSROOT:\n"
485          "  ${CMAKE_SYSROOT}"
486          )
487      endif()
488    endforeach()
489  endif()
490  if(CMAKE_ANDROID_NDK)
491    if (_INCLUDED_PLATFORMS)
492      if(CMAKE_SYSTEM_VERSION GREATER NDK_MAX_PLATFORM_LEVEL OR
493         CMAKE_SYSTEM_VERSION LESS NDK_MIN_PLATFORM_LEVEL)
494        message(FATAL_ERROR
495          "Android: The API level ${CMAKE_SYSTEM_VERSION} is not supported by the NDK.\n"
496          "Choose one in the range of [${NDK_MIN_PLATFORM_LEVEL}, ${NDK_MAX_PLATFORM_LEVEL}]."
497        )
498      endif()
499    else()
500      if(NOT IS_DIRECTORY "${CMAKE_ANDROID_NDK}/platforms/android-${CMAKE_SYSTEM_VERSION}")
501        message(FATAL_ERROR
502          "Android: The API specified by ${_ANDROID_API_VAR}='${${_ANDROID_API_VAR}}' does not exist in the NDK.  "
503          "The directory:\n"
504          "  ${CMAKE_ANDROID_NDK}/platforms/android-${CMAKE_SYSTEM_VERSION}\n"
505          "does not exist."
506          )
507      endif()
508    endif()
509  endif()
510elseif(CMAKE_ANDROID_NDK)
511  if (_INCLUDED_PLATFORMS)
512    set(CMAKE_SYSTEM_VERSION ${NDK_MIN_PLATFORM_LEVEL})
513    # And for LP64 we need to pull up to 21. No diagnostic is provided here because
514    # minSdkVersion < 21 is valid for the project even though it may not be for this
515    # ABI.
516    if(CMAKE_ANDROID_ARCH_ABI MATCHES "64(-v8a)?$" AND CMAKE_SYSTEM_VERSION LESS 21)
517      set(CMAKE_SYSTEM_VERSION 21)
518    endif()
519  else()
520    file(GLOB _ANDROID_APIS_1 RELATIVE "${CMAKE_ANDROID_NDK}/platforms" "${CMAKE_ANDROID_NDK}/platforms/android-[0-9]")
521    file(GLOB _ANDROID_APIS_2 RELATIVE "${CMAKE_ANDROID_NDK}/platforms" "${CMAKE_ANDROID_NDK}/platforms/android-[0-9][0-9]")
522    list(SORT _ANDROID_APIS_1)
523    list(SORT _ANDROID_APIS_2)
524    set(_ANDROID_APIS ${_ANDROID_APIS_1} ${_ANDROID_APIS_2})
525    unset(_ANDROID_APIS_1)
526    unset(_ANDROID_APIS_2)
527    if(_ANDROID_APIS STREQUAL "")
528      message(FATAL_ERROR
529        "Android: No APIs found in the NDK.  No\n"
530        "  ${CMAKE_ANDROID_NDK}/platforms/android-*\n"
531        "directories exist."
532        )
533    endif()
534    string(REPLACE "android-" "" _ANDROID_APIS "${_ANDROID_APIS}")
535    list(REVERSE _ANDROID_APIS)
536    list(GET _ANDROID_APIS 0 CMAKE_SYSTEM_VERSION)
537    unset(_ANDROID_APIS)
538  endif()
539endif()
540if(NOT CMAKE_SYSTEM_VERSION MATCHES "^[0-9]+$")
541  message(FATAL_ERROR "Android: The API specified by CMAKE_SYSTEM_VERSION='${CMAKE_SYSTEM_VERSION}' is not an integer.")
542endif()
543
544if(CMAKE_ANDROID_NDK AND NOT DEFINED CMAKE_ANDROID_NDK_DEPRECATED_HEADERS)
545  if(IS_DIRECTORY "${CMAKE_ANDROID_NDK}/sysroot/usr/include/${CMAKE_ANDROID_ARCH_TRIPLE}")
546    # Unified headers exist so we use them by default.
547    set(CMAKE_ANDROID_NDK_DEPRECATED_HEADERS 0)
548  else()
549    # Unified headers do not exist so use the deprecated headers.
550    set(CMAKE_ANDROID_NDK_DEPRECATED_HEADERS 1)
551  endif()
552endif()
553
554# Save the Android-specific information in CMakeSystem.cmake.
555set(CMAKE_SYSTEM_CUSTOM_CODE "
556set(CMAKE_ANDROID_NDK \"${CMAKE_ANDROID_NDK}\")
557set(CMAKE_ANDROID_STANDALONE_TOOLCHAIN \"${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}\")
558set(CMAKE_ANDROID_ARCH \"${CMAKE_ANDROID_ARCH}\")
559set(CMAKE_ANDROID_ARCH_ABI \"${CMAKE_ANDROID_ARCH_ABI}\")
560")
561
562if(CMAKE_ANDROID_NDK)
563  string(APPEND CMAKE_SYSTEM_CUSTOM_CODE
564    "set(CMAKE_ANDROID_ARCH_TRIPLE \"${CMAKE_ANDROID_ARCH_TRIPLE}\")\n"
565    "set(CMAKE_ANDROID_ARCH_LLVM_TRIPLE \"${CMAKE_ANDROID_ARCH_LLVM_TRIPLE}\")\n"
566    "set(CMAKE_ANDROID_NDK_VERSION \"${CMAKE_ANDROID_NDK_VERSION}\")\n"
567    "set(CMAKE_ANDROID_NDK_DEPRECATED_HEADERS \"${CMAKE_ANDROID_NDK_DEPRECATED_HEADERS}\")\n"
568    "set(CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG \"${CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG}\")\n"
569    "set(CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED \"${CMAKE_ANDROID_NDK_TOOLCHAIN_UNIFIED}\")\n"
570    )
571endif()
572
573# Select an ARM variant.
574if(CMAKE_ANDROID_ARCH_ABI MATCHES "^armeabi")
575  if(CMAKE_ANDROID_ARM_MODE)
576    set(CMAKE_ANDROID_ARM_MODE 1)
577  else()
578    set(CMAKE_ANDROID_ARM_MODE 0)
579  endif()
580  string(APPEND CMAKE_SYSTEM_CUSTOM_CODE
581    "set(CMAKE_ANDROID_ARM_MODE \"${CMAKE_ANDROID_ARM_MODE}\")\n"
582    )
583elseif(DEFINED CMAKE_ANDROID_ARM_MODE)
584  message(FATAL_ERROR "Android: CMAKE_ANDROID_ARM_MODE is set but is valid only for 'armeabi' architectures.")
585endif()
586
587if(CMAKE_ANDROID_ARCH_ABI STREQUAL "armeabi-v7a")
588  if(CMAKE_ANDROID_ARM_NEON)
589    set(CMAKE_ANDROID_ARM_NEON 1)
590  else()
591    set(CMAKE_ANDROID_ARM_NEON 0)
592  endif()
593  string(APPEND CMAKE_SYSTEM_CUSTOM_CODE
594    "set(CMAKE_ANDROID_ARM_NEON \"${CMAKE_ANDROID_ARM_NEON}\")\n"
595    )
596elseif(DEFINED CMAKE_ANDROID_ARM_NEON)
597  message(FATAL_ERROR "Android: CMAKE_ANDROID_ARM_NEON is set but is valid only for 'armeabi-v7a' architecture.")
598endif()
599
600# Report the chosen architecture.
601message(STATUS "Android: Targeting API '${CMAKE_SYSTEM_VERSION}' with architecture '${CMAKE_ANDROID_ARCH}', ABI '${CMAKE_ANDROID_ARCH_ABI}', and processor '${CMAKE_SYSTEM_PROCESSOR}'")
602
603cmake_policy(POP)
604
605# Include the NDK hook.
606# It can be used by NDK to inject necessary fixes for an earlier cmake.
607if(CMAKE_ANDROID_NDK)
608  include(${CMAKE_ANDROID_NDK}/build/cmake/hooks/post/Android-Determine.cmake OPTIONAL)
609endif()
610