Android向けQt - ソースからのビルド

このページでは、Qt for Android の設定およびビルドの手順について説明します。あらかじめビルド済みの Qt for Android をダウンロードしてインストールするには、「Qt のはじめ方」ページの手順に従ってください。

前提条件

ソースから Qt for Android をビルドするには、続行する前に「Qt for Android の前提条件」に記載されているすべての要件が満たされていることを確認してください。

Windows

Windows で Qt for Android をビルドするには、以下のソフトウェアも必要です：

• Mingw-w64 13.1 ツールチェーン

前提条件をインストールし、そのバイナリパスをシステムのPATH に追加してください：

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

インストールを確認するには、次のコマンドを実行します:

where mingw32-make.exe

このコマンドを実行すると、<MINGW_ROOT>パス下に mingw32-make.exe が最初に表示されるはずです。

ソースコードの入手

Qtのソースコードは、Qtのダウンロードページからダウンロードするか、Wikiの「ソースコードの入手方法」ガイドに従って入手できます。

設定

Qt 6 では、CMake を使用して、ソースコードから Android 版 Qt をビルドできます。Android 版 Qt 6 にはホスト側の Qt ビルドが必要です。つまり、Android 版 Qt をビルドするには、ホストとして使用されるデスクトッププラットフォーム（Linux、macOS、または Windows）用の Qt をビルドする必要があります。 詳細については、「Qtのクロスコンパイル」を参照してください。

Android 向け Qt を設定するには、ソースディレクトリをクリーンに保つために、シャドウビルドディレクトリを作成してください:

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Android向けQtは、以下のデバイスアーキテクチャ（ABI）をサポートしています：arm64-v8a 、x86_64 、x86 、およびarmeabi-v7a

その後、先ほど作成したビルドディレクトリ内から configure スクリプトを実行します：

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

Android SDKは通常、Qt Creator またはAndroid Studioによって以下の場所にインストールされます：

• Linux:~/Android/Sdk/
• macOS:~/Library/Android/sdk/
• Windows:C:\Users\<USER>\AppData\Local\Android\Sdk\

高度な configure 引数

このセクションを読む前に、configure オプションに関する詳細情報が記載された「Qt の configure オプション」を参照してください。

Android向けQtには、javacコンパイラで*.jarファイルにコンパイルされたJavaコードが含まれています。ソースおよびターゲット用のjavacバージョンを設定するには、それぞれ-android-javac-sourceおよび-android-javac-targetを使用します:

-android-javac-source 17 -android-javac-target 17

プレフィックスビルドではなく開発者向けビルドとしてQtをビルドするには、-prefix 引数の代わりに以下を使用します：

-developer-build

-qt-host-path は、ホスト開発ビルドにおいて、ホストのビルドディレクトリ内にあるqtbase ディレクトリを指す必要があります。例：~/dev/build-qt-host/qtbase 。

ビルド

Qtをビルドするには、次のコマンドを実行します:

cmake --build . --parallel

インストール

プレフィックスビルドの場合、Qtをインストールするには、次のコマンドを実行します：

cmake --install .

Unix では、-prefix <install_path> という configure オプションを指定していない場合、インストール先は/usr/local/Qt-<version> になります。その場合は、install コマンドでsudo を使用する必要があります。