Qt for Android を始める

Qt Creator IDE を含む Qt for Android ツールチェインを使って Android アプリの開発を始めるための初心者向けガイドです。

Qt for Android の基本的な使い方を学ぶには、Qt Academy のGetting Started with Qt for Androidコースを受講してください。

このページの残りの部分には、より詳細な入門情報があります。

Qt for Android をダウンロードしてインストールするには、Qt 入門のページの指示に従ってください。

Android 開発の前提条件

Qt for Android で開発を行うには、以下の前提条件が必要です：

• Java Development Kit (JDK)
• Android コマンドラインツール
  • Android NDK: C++ コードのビルド用。
  • Android SDK PlatformとAndroid SDK Build Tools: 特定の API バージョンの Android アプリをビルドします。
  • Android SDK Platform Tools：Androidの依存関係をデプロイおよび管理します。

これらの依存関係を管理する最も簡単な方法は、Qt Creator に組み込まれている Android 開発セットアップを使用することです。詳細はQt Creator を参照してください：Android デバイス設定の指定」を参照してください。

前提条件を手動でインストールする

前提条件を手動でインストールする場合は、次の手順に従ってください。

Java開発キット（JDK）

Qt for Android の開発には、以下のディストリビューションで提供されている JDK 17 以上が必要です：

• Adoptium
• OpenJDK
• Java SE 開発キット

お好みのJDKをインストールする。インストーラーがインストールされたJDKの場所を指すJAVA_HOME 環境変数を設定しない場合は、手動で設定することができます。例えばLinuxの場合

sudo apt-get install openjdk-17-jdk
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

またはmacOSの場合：

brew install openjdk@17
sudo ln -sfn "$(brew --prefix openjdk@17)/libexec/openjdk.jdk" \
    "/Library/Java/JavaVirtualMachines/openjdk-17.jdk"
export JAVA_HOME="$(/usr/libexec/java_home -v 17)"

Android SDKコマンドラインツール

お使いのオペレーティング・システムに対応するAndroid SDK Command Line Toolsの最新バージョンをダウンロードし、以下の適切なパスに解凍してください。

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

• Linux: ~/Android/Sdk/
• macOS: ~/Library/Android/sdk/
• WindowsWindows: C:¥Users¥AppData¥Local¥Android¥Sdk

または、OSのパッケージ・マネージャーを使う：

brew install android-commandlinetool

Android SDK必須パッケージ

SDK Platform、Platform Tools、Build Tools をインストールしてください。Qt 6.8の場合は

sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

Android NDK

Qt 6.8はNDK 26.1.10909125を使用します：

sdkmanager "ndk;26.1.10909125"

例えばmacOSの場合：

エミュレータ

Android Emulatorを使用したい場合は、以下のコマンドを実行してインストールします：

sdkmanager "emulator" "patcher;v4"

プラットフォーム固有の設定

ウィンドウズ

WindowsのデフォルトUSBドライバでは、Android Debug Bridge（ADB）ツールを使用したデバッグができません。Android SDKパッケージが提供する追加USBドライバをインストールする必要があります。以下を実行してインストールしてください：

sdkmanager.bat "extras;google;usb_driver"

Linux

Qt Creator で使用できるadb やgdb などのツールを使用するには、以下の依存関係が必要です：

sudo apt-get install libstdc++6 libncurses5

Android エミュレータを実行するには、以下の依存関係も必要です：

セットアップのテスト

Qt インストールに同梱されているサンプルを実行することで、開発セットアップをテストすることができます。詳細はMobile Examples を参照してください。

簡単なアプリケーションをゼロから開発するには、Qt Creator を参照してください：モバイルアプリケーションの作成」を参照してください。