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

このページでは、Qt for Android の設定とビルドの手順について説明します。ビルド済みの Qt for Android をダウンロードしてインストールするには、「Qt 入門」ページの手順に従ってください。

前提条件

Qt for Android をソースからビルドするには、Getting Started with Qt for Androidに記載されているすべての要件が満たされていることを確認してください。

Windows

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

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

注意: Qt for Android は Microsoft Visual C++ (MSVC) を使用したソースからのビルドをサポートしていません。

前提条件をインストールし、そのバイナリパスをシステムPATH に追加します:

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

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

where mingw32-make.exe

コマンドは、パス<MINGW_ROOT>の下にある mingw32-make.exe を最初にリストする必要があります。

ソースの入手

QtDownloadsページから Qt のソースをダウンロードするか、wiki のソースコード入手ガイドに従ってください。

設定

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

Qt for Android を構成するには、シャドウ・ビルド・ディレクトリを作成し、ソース・ディレクトリをクリーンな状態に保ちます:

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

Qt for Android は以下のデバイス・アーキテクチャ(ABI)をサポートしています:arm64-v8a x86_64 x86Qt for Android は以下のデバイス・アーキテクチャ(ABI)をサポートしています。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:Windows: C:¥Users<USER>¥AppData¥Local¥Android¥Sdk

注意: ninja の実行ファイルがある場合、configure は常にNinjaジェネレーターとビルドツールを使用します。Ninjaはクロスプラットフォームで、機能が豊富で、パフォーマンスが高く、すべてのプラットフォームで推奨される。他のジェネレータを使っても動作するかもしれませんが、公式にはサポートされていません。

高度な設定引数

このセクションを説明する前に、Qt Configure Options を参照してください。

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

-android-javac-source 8 -android-javac-target 8

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 を使用する必要があります。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.