目次 1 Qt のインストール インストール準備 インストール手順 インストールファイル アンインストール手順 Qt の簡単な使い方 サンプルプログラムの実行方法 開発手

Transcription

1 Qt 導入手引書 (Windows - Visual Studio 用 ) 2013 年 8 月 9 日 第 10 版 株式会社 SRA

2 目次 1 Qt のインストール インストール準備 インストール手順 インストールファイル アンインストール手順 Qt の簡単な使い方 サンプルプログラムの実行方法 開発手順 Qt を習得するには Qt に付属する情報 Qt に関する書籍 Qt の情報源 改訂履歴 Copyright (C) Software Research Associates, Inc. All Rights Reserved 2

3 1 Qt のインストール この文書では 以下の環境に Qt のバイナリ版をインストールする手順について説明します OS Windows 7 + Service Pack 1 Compiler Visual Studio Service Pack 1 Qt Qt (qt-enterprise-windows-x online.exe) 上記以外の環境や Microsoft の他のコンパイラ (Visual Studio 2012 用 ) の場合も 同様の 手順でインストールできます Qt に付属する統合環境である Qt Creator でデバッグを行う場合は 別途 Windows 用デバッグツールのインストールが必要です Windows 用デバッグツールの入手に関しては下記の URL を参照してください なお 仮想環境では OpenGL の動作に問題がある可能性が高く Qt Quick 2 が正常に動作 しない場合やアクセラレーションが有効にならずに非常に遅くなる場合があります その ため 仮想環境へのインストールは推奨しません Qt のインストール前に下記の情報を参照してください Qt for Windows Requirements Windows で Qt に必要な環境の情報です Known Issues Qt Qt の既知の不具合の情報です Qt Creator : Setting Up Debugger Qt Creator でデバッグする際の設定方法や必要環境の情報です 3

4 1.1 インストール準備 インストールする前に 以下の手順にしたがって準備を行ってください (1) ユーザ権限の確認 Qt をインストールするには アドミニストレータ権限が必要です 標準ユーザもしくは制限ユーザの権限ではインストールできません (2) Qt の入手 Qt のインストーラを Digia 社のサイトからダウンロードして入手します Qt のインストーラのファイル名は 次のようになります qt-enterprise-windows-x online.exe (3) ライセンシー名 ライセンスキーの確認ライセンスキーの確認インストール時に ライセンシー名およびライセンスキーを入力する必要があります 次のような記述を含む案内メールが送られてきますので Name および License Key をご確認ください ( ライセンス情報 ) Name: Taro Yamada Company name: Software Research Associates, Inc., Japan Period: 2013/9/30 ( ダウンロードサイト ) <Win> Qt4 License Key: AAAA-BBB-CCC-DDD-EEEEE-FFFFF-GGGG Qt5 License Key: HHHH-III-JJJ-KKK-LLLLL-MMMMM-NNNN 4

5 1.2 インストール手順 以下の手順にしたがって Qt をインストールします (1) ライセンシー名とライセンスキーの入力ダウンロード済みの Qt のインストーラをエクスプローラ上でダブルクリックします しばらくすると次のようにライセンス情報入力用ダイアログが表示されます ( 以前に別のバージョンの Qt をインストールしていた場合などでライセンス情報 (.qt-license ファイル ) がホームディレクトリに存在する場合は表示されません ) 案内メールに記載されている情報はそれぞれ以下の項目に対応します ダイアログ Licensee Qt4 License Key Qt5 License Key 案内メール Name Qt4 License key Qt5 License key ライセンシー名とライセンスキーを入力後 Done ボタンを押下します 5

6 (2) インストーラの起動ライセンス情報を入力後 セットアップウィザードが起動します Firewall の内側などでプロキシーの設定が必要な場合は Settings ボタンを押下します プロキシーの設定方法については次ページに記載します プロキシーの設定が不要あるいは終了した後は Next ボタンを押下します ネットワークからインストール用データの情報の取得後 次の画面に移行します 6

7 プロキシーの設定セットアップウィザードで Settings ボタンを押下すると設定用ダイアログが表示されます ここではプロキシーの設定とインストールリポジトリの設定が行えます リポジトリを変更するとインストールが行えなくなるため 変更は行わないでください ネットワークのアクセスにプロキシーの設定が必要な場合にはダイアログにしたがって設定を変更します システムの設定で問題ない場合には System proxy settings を 特別な設定が必要な場合には Manual proxy configuration を選択して設定してください プロキシーの設定が終了後は OK を押下します 7

8 (3) インストールパスの指定ネットワークからインストール用データの情報の取得が完了すると インストール先のフォルダを選択する画面が表示されます インストール先を変更する場合は スペースや漢字 ひらがななどが含まれていない任意のフォルダを指定してください デフォルトのインストール先は以下の通りとなります なお インストールするフォルダはアンインストール時にすべて消去されますので 必要なデータなどのあるフォルダは指定しないようにしてください 項目 Installation Folder C: Qt インストールするフォルダ また インストール時にヘッダファイル (*.h) やソースファイル (*.cpp) ファイルが Qt の統合環境である Qt Creator に関連付けされます この関連付けを行いたくない場合にはウィンドウ下側のチェックをはずしてください インストールするフォルダを確認し Next ボタンを押下します 8

9 (4) インストールコンポーネントの選択インストール対象をチェックボックスで選択します デフォルトでは各種環境向けの Qt のバイナリと Qt Creator および MinGW がインストールされます Qt のソースファイルの追加や Add-On モジュールのインストールが不要の場合には該当するコンポーネントのチェックを変更してください なお Qt Creator の選択は解除できません デフォルトでは大量のパッケージがインストールされるため インストールにかかる時 間やディスク容量の削減のために インストールするパッケージをできるだけ少なくす ることを推奨します 選択可能なパッケージについては次ページに記載します インストール対象を確認し Next ボタンを押下します 9

10 インストールコンポーネントの選択選択可能なパッケージは以下のとおりです 太字太字の項目はデフォルトでインストール対象となっているパッケージです 項目 備考 Qt Qt msvc bit Visual Studio 2010, 32 bit msvc bit OpenGL msvc bit msvc bit msvc bit OpenGL MinGW 4.8(32 bit) Android x86 Android armv7 Visual Studio 2010, 32 bit, 要 OpenGL Visual Studio 2012, 32 bit Visual Studio 2010, 64 bit Visual Studio 2010, 64 bit, 要 OpenGL MinGW 4.8 用, 32 bit, GCC Android(x86) 用アプリ作成用 ( テクノロジープレビュー版 ) Android(armv7) 用アプリ作成用 ( テクノロジープレビュー版 ) Source Components ソースコード (Qt 5.1.0) Qt msvc bit Visual Studio 2010, 32 bit msvc bit (OpenGL) msvc bit MinGW 4.7 Visual Studio 2010, 32 bit, 要 OpenGL Visual Studio 2010, 64 bit MinGW 4.7 用, 32 bit, GCC Source Components ソースコード (Qt 5.0.2) Tools MinGW 4.7 Qt MinGW 4.7 のインストールに必要 Qt Enterprise Qt Creator MinGW 4.8 Charts 選択解除不可能 Qt MinGW 4.8 のインストールに必要 Qt でグラフを作成するためのコンポーネント Add-ons 比較などを行う予定が無ければターゲットとなる環境に合わせた Qt を一つだけ選択してインストールすれば問題ありません なお インストール後にこれらのパッケージの追加インストールや 選択したパッケージのみをアンインストールすることも可能です 10

11 (5) ライセンス条項への同意の確認ライセンス条項に同意するかどうかの確認を求める画面が表示されます ライセンス条項をご確認の上 I have read and agree to the following terms contained in the license agreements のラジオボタンが選択されるようにクリックして Next ボタンを押下します 11

12 (6) スタートメニューの選択スタートメニューに表示するプログラムフォルダを選択するための画面が表示されます 内容を確認し Next ボタンを押下します 12

13 (7) インストール開始インストールの準備ができました インストールの詳細を確認する場合には Show Details ボタンを押下します Install ボタンを押下すると パッケージのダウンロードとインストールが始まります 13

14 (8) インストール完了インストール状況を示すプログレスバーを持つ画面が表示されます プログレスバーが進み ダウンロードおよびインストールが完了するまで待ちます 14

15 インストールが完了すると以下のようにインストール完了画面が表示されます Finish ボタンを押下すると セットアップウィザードが終了し Qt Creator( 統合開発 環境 ) が起動し Qt の README.txt がメモ帳で表示されます 15

16 (9) インストール後の環境インストールが正しく終了した場合 スタートメニューに Qt Enterprise という ( あるいはインストーラで指定した ) 名前のアプリケーションメニューが登録されます ここでは 上記のメニュー内の以下の項目について説明します Qt Enterprise Maintenance Tool Qt の各モジュールのアップデートや追加インストール アンインストールを行います Qt for Desktop Qt を使用するにあたり 必要な環境変数などが設定された状態でコマンドプロンプトを起動します この中では 使用するコンパイラへのパスや Qt が提供するツール等が収められた場所へのパス等が設定されます 16

17 (10) 環境変数の設定 Qt を使用するにあたり 以下の環境変数を設定しておくと便利です 環境変数の設定方法はプラットフォームに依存しますが 今回使用する環境 (Windows 7) では 以下のように辿って設定してください コントロールパネル を起動してシステムとセキュリティ システム システムの詳細設定 システムのプロパティ ウィンドウが表示され詳細設定 環境変数 PATH Qt をインストールしたフォルダ以下の bin を既存の PATH に追加します ここには Qt アプリケーションに必要な Qt のライブラリと Qt アプリケーションを実装 ビルドする際に必要となるツール類が格納されています これを設定することで エクスプローラ上から Qt アプリケーション (Qt が提供するツールや例題アプリケーション 自身で実装したアプリケーション等 ) を直接起動することができるようになります 17

18 1.3 インストールファイル インストールされたファイルについて記載します インストールに使用した Qt のパッケー ジによらず共通なディレクトリと パッケージごとに異なるディレクトリがあるため そ れぞれについて代表的なものについてのみ記載します 共通ディレクトリどのパッケージでインストールしても同じパスにインストールされます インストール時に選択したインストール先の直下にサブディレクトリとして作成されます (1) Licenses ディレクトリライセンス条項を記述したテキストファイルが格納されています (2) Tools ディレクトリ Qt の統合開発環境である Qt Creator が格納されています 個別ディレクトリインストール時に選択したインストール先の下に バージョン番号 パッケージ種類 の形式でディレクトリが作成され その下に Qt 本体がインストールされます 各パッケージのディレクトリ名は以下の通りとなっています インストールしたパッケパッケージ ディレクトリ名 msvc bit msvc2010 msvc bit OpenGL msvc2010_opengl msvc bit msvc2012 msvc bit msvc2012_64 msvc bit OpenGL msvc2012_64_opengl 各個別ディレクトリ以下の代表的なディレクトリについて記載します (1) bin ディレクトリ Qt が提供する各種コマンド ツール Qt ライブラリ本体が格納されています 代表的なツールは以下の通りです 18

19 assistant ( ドキュメントブラウザ ) designer (GUI レイアウトツール ) linguist ( ローカライズ支援ツール ) qmake ( ビルドルール生成コマンド ) qmlviewer (Qt Quick 1 の開発用実行環境 ) qmlscene (Qt Quick 2 の開発用実行環境 ) lupdate ( ローカライズ対象フレーズ抽出コマンド ) lrelease ( ローカライズファイルリリース用コンパイラ ) lconvert ( ローカライズファイル形式変換コマンド ) moc ( メタオブジェクトコンパイラ ) uic ( ユーザインタフェースコンパイラ ) (2) examples ディレクトリサンプルプログラム (examples) が格納されています (3) doc ディレクトリ Qt のドキュメントが格納されています html サブディレクトリ以下に HTML 形式で格納されています (4) include ディレクトリインクルードファイルが格納されています include ディレクトリ以下は モジュール毎にサブディレクトリが作成 分類されています (5) lib ディレクトリアプリケーションのビルド時に必要なライブラリ等が格納されています (6) mkspecs ディレクトリプラットフォーム コンパイラ固有の設定ファイルが格納されています (7) plugins ディレクトリプラグイン形式のライブラリが格納されています プラグインの用途毎に格納されるサブディレクトリが分類されています (8) translations ディレクトリ 19

20 Qt ライブラリ本体内で使用されているフレーズについての翻訳ファイルとロード可能モ ジュールファイルが格納されています (9) imports ディレクトリ QML / Qt Quick 用コンポーネントが格納されています (10) qml ディレクトリ QML / Qt Quick 用コンポーネントが格納されています 20

21 1.4 アンインストール手順 アンインストールを行う方法として 以下の 2 通りの方法があります アンインストールには アドミニストレータ権限が必要です 標準ユーザもしくは制限ユーザの権限では アンインストールできませんのでご注意ください (1) スタートメニューから実行スタートメニューの すべてのプログラム から Qt のアンインストーラを起動します スタート Qt Enterprise Uninstall Qt Enterprise アンインストーラが起動しますので 指示に従ってアンインストールしてください (2) コントロールパネルから実行 1. コントロールパネルから プログラムのアンインストール を開きます 2. Qt Enterprise を選び アンインストール ボタンを押します アンインストーラが起動しますので 指示にしたがってアンインストールしてください 21

22 2 Qt の簡単な使い方 ここでは Qt を使用してのアプリケーション開発方法についてご説明します まずは 付属のサンプルプログラムの実行方法についてご説明します その後 Qt API を使用した Qt アプリケーションの実装方法 ビルド方法 実行方法についてご説明します 2.1 サンプルプログラムの実行方法 Qt には数多くのサンプルプログラムが含まれています Qt のインストール後 以下の方法 で付属のサンプルプログラムを実行することができます まずはスタートメニューから Qt Creator を起動してください デフォルトでは上記のように Qt Creator スタートガイド が表示されています サンプル をクリックして サンプルプログラムのリストを表示させてください 22

23 ここでは Application Example を動かしてみます Application Example を押下してくだ さい 23

24 Application Example のドキュメントが表示されるので 左下の緑色の三角形の実行ボタン を押下します 24

25 実行すると 次のようなウィンドウが表示されます 25

26 2.2 開発手順 ここでは Qt を使用したプログラム開発における手順について説明します Qt を使用したプログラムのソースファイルを作成し ビルド 実行する一般的な手順は次 のようになります (1) プロジェクトの新規作成 (2) ソースファイルの作成 編集 (3) ビルド (4) 実行 この手順の例として Qt を使用した簡単なプログラムを最初から作成してみます ここで は Hello World! と言う文字列が書かれたボタンを表示するプログラムを作成します 以 下で手順を説明します 26

27 (1) プロジェクトの新規新規作成実行可能ファイルやライブラリ等を作成するための単位を プロジェクト と呼びます プロジェクトは実装ファイルやヘッダファイル リソースファイル等で構成されます まずは これらのファイルを格納するためのフォルダを作成します Qt Creator を起動し ファイル メニューから ファイル / プロジェクトの新規作成 を選 択します 27

28 以下のダイアログが表示されますので 左の列から プロジェクト の アプリケーション を 中央の列からは Qt GUI アプリケーション を選択し 選択 ボタンを押下します 28

29 パス以下のダイアログが表示されるため プロジェクト名とプロジェクトを生成するディレクトリを指定します ここでは以下を入力します 項目値名前 : Hello パス にはユーザのホームディレクトリが入力されていますので 今回はそのまま使用します それぞれ 任意のパスを指定していただいてかまいませんが スペースや漢字 ひらがななど ASCII 以外の文字が含まれるパスは指定しないでください パスを確認したら 次へ を押下します 29

30 キット キット とはコンパイル時に使用する Qt とコンパイラをセットとして環境として定義したものです 複数の Qt やコンパイラを使い分けする場合にキットを切り替えて使用します この状況では ( 複数の Qt をインストールしていなければ ) キットは一つしかないため そのまま 次へ ボタンを押下します クラス情報生成するアプリケーションの形式を選択します デフォルトでは QMainWindow クラスが選択されています QMainWindow クラスを使用することで本格的なデスクトップアプリケーションが容易に作成することができますが 今回は簡易なアプリケーションの生成を目的とするため 基底クラス を QWidget に変更して 次へ ボタンを押下します 30

31 プロジェクト管理 Subversion や git などのバージョン管理システムを使用している場合はここでリポジトリの生成などが行えます 今回は < なし > のまま 完了 ボタンを押下します (2) ソースファイルの作成 編集プロジェクトが生成され Qt Creator の画面がプロジェクトの編集画面に移行します 初期状態では widget.cpp ファイルを開きます 31

32 プロジェクトの フォーム を展開して widget.ui をダブルクリックして開いてください 32

33 下記のように Qt Designer の画面が表示され widget.ui が開きます 33

34 左の列にある Push Button をドラッグして 中央上の領域にドロップします 34

35 背景の Widget( グリッドが表示されている灰色の枠 ) をクリックして選択し 右クリック して表示されるコンテキストメニューから レイアウト 垂直に並べる を選択します 35

36 PushButton をダブルクリックし テキストを Hello World! に変更します 36

37 ファイル メニューから widget.ui の保存 を選択して保存します 37

38 (3) ビルド ビルド メニューから すべてビルド あるいは プロジェクト hello をビルド を選択します 38

39 (4) 実行サンプル実行時と同様に左下の緑色の三角形の実行ボタンを押下します 以下のようなウィンドウが表示されます 39

40 3 Qt を習得するには Qt には アプリケーション実装の際に参考になるプログラムが多数含まれています これらに目を通しておくことで アプリケーションを開発する際のヒントが得られます また 書籍として発行されている情報や Qt Project のサイトにも開発の際に役に立つ多数のドキュメントが提供されていますので ここではそれらの情報について記述します 3.1 Qt に付属する情報 ここでは Qt を導入するにあたり参考になるような情報として Qt に付属しているサンプルプログラムやドキュメントについてご紹介します Qt 付属のサンプルプログラム Qt をインストールした個別ディレクトリ下の examples 以下に多数のサンプルプログラムが含まれています これらは Qt 個々の機能のサンプルプログラムであり 機能ごとに分かれて置かれています この中でももっとも自習用にお勧めのプログラムがチュートリアル (examples/tutorial) です Qt 付属のドキュメントにチュートリアルの解説があり Qt Creator の起動直後の画面から表示できますので合わせてご参照ください Qt 付属のドキュメント Qt には Qt Reference Documentation というオンラインマニュアルが付属しています 次の二つのツールで参照できますが 内容は同じです なお Qt Reference Documentation および Qt Assistant のインストール先については 1.3 インストールファイル をご覧ください Qt Assistant( ドキュメントブラウザ ) で表示 Qt Assistant は Qt のドキュメントブラウザです Qt Assistant が表示する内容は 次項のウェブブラウザで表示できるものとほぼ同じですが ドキュメントの階層表示や キーワードによる全文検索ができるなど やや高機能になっています チュートリアルの解説ページは 以下の要領で辿る事ができます Qt Reference Documentation Getting Started with Qt Examples and Tutorials 40

41 また Qt Assistant は Qt Creator に組み込まれているため Qt Creator からドキュ メントを参照することもできます Qt Creator 起動後に ウィンドウ左にあるサイ ドバーの ヘルプ を押下してください ウェブブラウザで表示 Qt Reference Documentation は HTML 形式ですので ウェブブラウザを使用して表示できます index.html がトップページです トップページの Tutorial and Examples というリンクをクリックすると チュートリアルやサンプルプログラムの解説ページを辿ることができます 41

42 3.2 Qt に関する書籍 ここでは Qt について記述されている書籍についてご紹介します 英語で記述されたものと その日本語訳の書籍があります 入門 Qt 4 プログラミング ( 既刊 Qt 4.1 ベース ) Jasmin Blanchette, Mark Summerfield 著 杵渕聡 杉田研治訳 オライリー ジャパン Qt 4 向けの書籍ですが 第 5 刷以降では付録に Qt 4 アプリーションの Qt 5 への 移行 を追記し サンプルプログラムも Qt 4 と Qt 5 の双方で動くように修正して あります 実践 Qt 4 プログラミング ( 既刊 Qt 4.3 ベース ) Jasmin Blanchette, Mark Summerfield 著 山田亮介 杉田研治訳 オライリー ジャパン C++ GUI Programming With Qt 4 Second Edition ( 既刊 洋書 Qt 4.3 ベース ) Jasmin Blanchette, Mark Summerfield 著 Prentice Hall C++ GUI Programming With Qt 4 ( 既刊 洋書 Qt 4.1 ベース ) Jasmin Blanchette, Mark Summerfield 著 Prentice Hall 42

43 3.3 Qt の情報源 Qt Project の公式サイト ( や Digia 社の公式サイト ( に Qt の情報が集約されています Supported Platforms プラットフォームに関する情報です FAQ FAQ のページです Qt Bug Tracker ユーザから報告のあった不具合や提案などの一覧があります Online Reference Documentation リファレンスマニュアルや各種ツール 定期刊行記事へのリンクがあります SRA のサイトにも Qt 関連情報を記載してあります Qt 関連情報 Qt 関連書籍の紹介などを行っています 43

44 改訂履歴 日付 内容 2013 年 8 月 9 日 Qt に対応 2009 年 12 月 25 日 Qt に対応 商用版向けに共用化 2009 年 10 月 6 日 Visual Studio Integration に関する記述を削除 2009 年 6 月 1 日 Qt に対応 2008 年 7 月 25 日 Qt に対応 2007 年 2 月 19 日 Visual Studio 2005 SP1 に関する注意事項を削除 2007 年 2 月 6 日 Visual Studio 2005 SP1 に関する注意事項を追加 2006 年 10 月 16 日 Qt に対応 2006 年 9 月 10 日 インストール先のディレクトリ構成 アンインストール手 順を追加 2006 年 7 月 13 日 新規作成 44