Qt for Android を始める

以下のビデオは、Qt for Android アプリの開発を始めるための、Qt Creator IDE を含む Qt for Android ツールチェインの使い方についての初心者向けガイドです。

Qt for Android を使い始めるための基礎を学ぶには、Qt Academy の「Getting Started with Qt for Android」コースを受講してください。

このページでは、Qt for Android の使い方をより詳しく説明します。

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

Android 開発の前提条件

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

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

依存関係を管理する最も簡単な方法は、Qt Creator の組み込み Android 開発セットアップを使用することです。Qt for Android をインストールした後にQt Creator を最初に開くと、Android セットアップウィザードを実行するかどうか尋ねられます。これは Android 用の OpenSSL もセットアップします。

既存の SDK の場所を使用する

すでに Android SDK をセットアップしている場合は、このウィザードを実行する必要はありません。代わりに、Qt Creator でPreferences > Devices > Android にアクセスし、既存の JDK と SDK のパスを参照します。一般的なAndroid SDKパスを参照してください。詳細については、Qt Creator: Set up Android development environmentを参照してください。

前提条件の手動インストール

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

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のパス

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

• Linux: ~/Android/Sdk/
• macOS: ~/Library/Android/sdk/
• WindowsWindows: C:¥Users<USER>¥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:Creating a Mobile Application を参照してください。