Android NDK でのクロスコンパイルを成功させる CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX 設定方法

CMakeにおけるCMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX変数の詳細解説

概要

例:

• ホストプラットフォームがx86_64-linux-gnuの場合、CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXは-x86_64になります。
• ホストプラットフォームがarmv7-linux-androideabiの場合、CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXは-armになります。

用途

CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXは、以下の目的で使用されます。

• クロスコンパイル用のツールチェーンを特定する
• 生成される実行ファイルの接尾辞を設定する

設定方法

CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXは、以下の方法で設定できます。

• CMakeLists.txtファイルで直接設定する
• cmakeコマンドラインオプションで設定する
• 環境変数で設定する

例:

CMakeLists.txtファイルで設定する場合:

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

cmakeコマンドラインオプションで設定する場合:

cmake -DCMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX="-arm" ..

環境変数で設定する場合:

export CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX="-arm"

関連変数

• CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX: ターゲットとなるホストプラットフォームのツールチェーンにおけるコンパイラとbinutilsの接頭辞を表します。
• CMAKE_LANG_ANDROID_TOOLCHAIN_MACHINE: ターゲットとなるホストプラットフォームのアーキテクチャを表します。

補足

• CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXは、Android NDKを使用してAndroid向けにクロスコンパイルする場合にのみ使用されます。
• CMakeのバージョンによって、CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXの動作が異なる場合があります。

CMakeLists.txtファイルでの設定例

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

add_executable(hello_world
  hello_world.c)

target_link_libraries(hello_world
  log)

C++言語のサンプルコード

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

add_executable(hello_world
  hello_world.cpp)

target_link_libraries(hello_world
  log)

Java言語のサンプルコード

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

add_library(hello_world SHARED
  hello_world.java)

target_link_libraries(hello_world
  log)

Kotlin言語のサンプルコード

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

add_library(hello_world SHARED
  hello_world.kt)

target_link_libraries(hello_world
  log)

NDK Modulesを使用したサンプルコード

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

find_package(NDK REQUIRED)

add_library(hello_world SHARED
  hello_world.c)

target_link_libraries(hello_world
  log
  ndk)

cmakeコマンドラインオプションでの設定例

cmake -DCMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX="-arm" ..

環境変数での設定例

export CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX="-arm"

補足

上記のサンプルコードは、あくまで参考です。実際のコードは、プロジェクトの環境に合わせて変更する必要があります。

参考になれば幸いです。

CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXを設定する他の方法

CMake GUI

1. File > New > CMakeLists.txtを選択して、新しいCMakeLists.txtファイルを作成します。
2. ツールバーの Browse Source ボタンをクリックして、プロジェクトのソースディレクトリを選択します。
3. ツールバーの Configure ボタンをクリックします。
4. CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX変数を検索します。
5. 変数の値を、ターゲットとなるホストプラットフォームのツールチェーンにおけるコンパイラとbinutilsの接尾辞に設定します。
6. Configure ボタンをクリックして、設定を保存します。

NDK Modules

NDK Modulesを使用している場合は、以下の方法でCMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXを設定できます。

1. Android.cmakeファイルに、以下のコードを追加します。

set(CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX "-arm")

1. プロジェクトのCMakeLists.txtファイルで、Android.cmakeファイルをインクルードします。

include(Android.cmake)

上記の方法以外にも、以下の方法でCMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIXを設定できます。

• Custom build script
• Pre-build event

どの方法を選択するかは、プロジェクトの環境と開発スタイルによって異なります。

参考になれば幸いです。