Qt for Android の前提条件

Qt を使用して Android 向けアプリケーションを開発するには、必要なツールや依存関係を備えた開発環境をセットアップする必要があります。このページでは、開発を始めるための手順を段階的に説明します。

Android 開発の前提条件

Qt for Android を使用して開発を行うには、以下の前提条件が必要です。

• Java Development Kit (JDK)
• Android コマンドラインツール（以下を含む）：
  • Android NDK：C++コードのビルド用。
  • Android SDK PlatformおよびAndroid SDK Build Tools：Android アプリのビルドに使用します。
  • Android SDK Platform Tools：Androidの依存関係のデプロイおよび管理用。

前提条件のインストール

Qt Creator のAndroid開発セットアップの使用

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

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

すでにAndroid SDKがセットアップされている場合は、このウィザードを実行する必要はありません。その代わりに、Qt Creator でPreferences > Devices > Android を開き、既存のJDKおよびSDKのパスを指定してください。一般的なAndroid SDKのパスについては、「commonAndroid SDK paths」を参照してください。詳細については、「Qt Creator ：Android開発環境のセットアップ」を参照してください。

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

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

1. Java Development Kit (JDK) をインストールします。

   Android 開発用の Qt には、以下のサポート対象ディストリビューションのいずれかによって提供される JDK 21 以降が必要です。

   • Adoptium
   • OpenJDK
   • Java SE Development Kit

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

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

   または、macOSの場合は：

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

2. Android SDK コマンドラインツールをインストールします。お使いのオペレーティングシステムに対応したAndroid SDK コマンドラインツールの最新バージョンをダウンロードし、以下に記載されている適切なパスに解凍してください。

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

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

   または、お使いのOSのパッケージマネージャーを使用してください。例えばmacOSの場合は：

   brew install android-commandlinetools

3. Android SDK Platform、Build Tools、および Platform Tools をインストールしてください。

   必ず SDK Platform、Platform Tools、および Build Tools をインストールしてください。Qt 6.12 の場合は、以下を使用してください：

   sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

4. Android NDK をインストールします。

   Qt 6.12 では NDK 27.2.12479018 が使用されています。以下のコマンドを実行してインストールできます:

   sdkmanager "ndk;27.2.12479018"

5. (オプション) Androidエミュレータをインストールします。

   Androidエミュレータを使用する場合は、次のコマンドを実行してインストールできます:

   sdkmanager "emulator"

6. プラットフォーム固有の設定
   • Windows の場合、Android SDK の「extras」パッケージに含まれる追加の USB ドライバーをインストールする必要があります。以下のコマンドを実行してインストールしてください：

     sdkmanager.bat "extras;google;usb_driver"

   • Linux の場合、Qt Creator で利用可能なadb やgdb などのツールを使用するには、以下の依存関係が必要です：

     sudo apt-get install libstdc++6 libncurses5

     注： Androidエミュレータを十分なパフォーマンスで動作させるには、ハードウェアアクセラレーション が必要です。これが利用できない場合、エミュレータはソフトウェアによるCPUエミュレーションを使用することになり、動作が著しく遅くなります。詳細については、「Android: Emulator Acceleration」を参照してください。

セットアップのテスト

前提条件のインストールと設定が完了したら、Qtのインストールに同梱されているサンプルを実行して、開発環境をテストできます。詳細については、「モバイルサンプル」を参照してください。