Qt 導入手引書

Transcription

1 Qt 導入手引書 (Windows - Visual Studio 用 ) 2009 年 12 月 25 日 第 9 版 株式会社 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 Vista + Service Pack 2 Compiler : Visual Studio Service Pack 1 Qt : Qt (qt-win-commercial vs2005.exe) 上記以外の環境や Microsoft の他のコンパイラ (Visual Studio 2003.NET 用 Visual Studio 2008 用 ) の場合も 同様の手順でインストールできます 3

4 1.1 インストール準備 インストールする前に 以下の手順にしたがってインストール前の準備を行ってください (1) ユーザ権限権限の確認 Qt をインストールするには アドミニストレータ権限が必要です 標準ユーザもしくは制限ユーザの権限ではインストールできません (2) Qt の入手 Qt のインストーラを Qt Development Frameworks のサイトからダウンロードして入手します バージョン番号を とすると Qt のインストーラのファイル名は 次のようになります 開発環境ファイル名 Visual Studio.NET 2003 qt-win-commercial vs2003.exe Visual Studio 2005 qt-win-commercial vs2005.exe Visual Studio 2008 qt-win-commercial vs2008.exe Qt SDK をインストールする場合 qt-sdk-win-commercial-yyyy.xx.exe をダウンロードします この場合 以降のドキュメントの説明で用いている上記の単体インストールとは手順 インストールされる構成 内容が異なる部分がありますのでご注意ください (3) ライセンシー名 ライセンスキーライセンスキーの確認インストール時に ライセンシー名およびライセンスキーを入力する必要があります 次のような記述を含む案内メールが送られてきますので Name および License Key をご確認ください ( ライセンス情報 ) Name: Taro Yamada Company name: Software Research Associates, Inc., Japan License Key: AAAA-BBB BBB-CCC CCC-DDD DDD-EEE EEEEE-FFFFF FFFFF-GGGG Period: 2010/2/1 4

5 1.2 インストール手順 以下の手順にしたがって Qt をインストールします (1) インストーラの起動 Qt のインストーラをエクスプローラ上でダブルクリックします しばらくすると次のようにセットアップウィザードが起動します 起動を確認後 Next > ボタンを押下します 5

6 (2) ライセンシー名とライセンスキーライセンスキーの入力ライセンシー名とライセンスキーを入力する画面が表示されます 案内メールに記載されている情報はそれぞれ以下のように対応します Name License Key Licensee name Qt License key ライセンシー名とライセンスキーを入力後 Next > ボタンを押下します 6

7 (3) ライセンス条項条項へのへの同意同意の確認ライセンス条項に同意するかどうかの確認を求める画面が表示されます ライセンス条項をご確認の上 I accept the terms in the License Agreement のラジオボタンが有効になるようクリックして Next > ボタンを押下します 7

8 (4) インストール対象対象の選択インストール対象をチェックボックスで選択します デフォルトでは全ての項目がインストールされます インストール不要のものがあればチェックを外して下さい なお Qt 本体は選択を解除できません インストール対象を確認し Next > ボタンを押下します 8

9 (5) インストールフォルダの選択インストール先のフォルダを選択する画面が表示されます インストール先を変更する場合は 任意のフォルダを指定してください デフォルトのインストール先は以下の通りとなります 項目 Destination Folder C:\Qt\4.6.0 インストールするフォルダ インストールするフォルダを確認し Next > ボタンを押下します 9

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

11 (7) インストール完了インストール状況を示すプログレスバーを持つ画面が表示されます プログレスバーが最後まで進み その上に Completed と表示されたら Next > ボタンを押下します 11

12 以下のようにインストール完了画面が表示されます Finish ボタンを押下すると セットアップウィザードが終了し Qt Examples and Demos( サンプルプログラムとデモプログラムのランチャーアプリケーション ) および Qt Assistant( ドキュメントブラウザアプリケーション ) が起動します 12

13 (8) インストール後の環境インストールが正しく終了した場合 スタートメニューに Qt by Nokia v4.6.0(vs2005) と言う名前のアプリケーションメニューが 以下のように登録されます ここでは 上記のメニュー内の以下の 2 つの項目について説明します Qt Command Prompt Qt を使用するにあたり 必要な環境変数などが設定された状態でコマンドプロンプトを起動します この中では 使用するコンパイラへのパスや Qt が提供するツール等が収められた場所へのパス等が設定されます このドキュメント内でコマンドプロンプトを使用する場合には この状態のコマンドプロンプトを指します Visual Studio with Qt 上記のコマンドプロンプトと同様に 必要な環境変数などが設定された状態で Visual Studio を起動します (9) 環境変数の設定 Qt を使用するにあたり 以下の環境変数を設定しておくと便利です 環境変数の設定方法はプラットフォームに依存しますが 今回使用する環境 (Windows Vista) では 以下のように辿って設定してください システムのプロパティ 詳細設定 環境変数 13

14 PATH Qt をインストールしたフォルダ以下の bin を既存の PATH に追加します ここには Qt アプリケーションに必要な Qt のライブラリと Qt アプリケーションを実装 ビルドする際に必要となるツール類が格納されています これを設定することで エクスプローラ上から Qt アプリケーション (Qt が提供するツールや例題アプリケーション 自身で実装したアプリケーション等 ) を直接起動することができるようになります 14

15 1.3 インストールファイル インストールされたファイルについて記載します ここでは インストール先をトップデ ィレクトリとした場合のサブディレクトリ単位で代表的なものについてのみ記載します (1) bin ディレクトリ Qt が提供する各種コマンド ツール Qt ライブラリ本体が格納されています 代表的なツールは以下の通りです assistant ( ドキュメントブラウザ ) designer (GUI レイアウトツール ) linguist ( ローカライズ支援ツール ) qmake ( ビルドルール生成コマンド ) qtdemo ( デモンストレーションランチャ ) lupdate ( ローカライズ対象フレーズ抽出コマンド ) lrelease ( ローカライズファイル変換コマンド ) moc ( メタオブジェクトコンパイラ ) uic ( ユーザインタフェースコンパイラ ) (2) demos, examples ディレクトリデモンストレーションプログラム (demos) とサンプルプログラム (examples) が格納されています (3) doc ディレクトリ Qt のドキュメントが格納されています html サブディレクトリ以下に HTML 形式で格納されています (4) include ディレクトリインクルードファイルが格納されています include ディレクトリ以下は モジュール毎にサブディレクトリが作成 分類されています (5) lib ディレクトリアプリケーションのビルド時に必要なライブラリ等が格納されています 15

16 (6) mkspecs ディレクトリプラットフォーム コンパイラ固有の設定ファイルが格納されています (7) plugins ディレクトリプラグイン形式のライブラリが格納されています プラグインの用途毎に格納されるサブディレクトリが分類されています (8) translations ディレクトリ Qt ライブラリ本体内で使用されているフレーズについての翻訳ファイルとロード可能モジュールファイルが格納されています 16

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

18 2 Qt の簡単な使い方 ここでは Qt を使用してのアプリケーション開発方法についてご説明します まずは 付属のサンプルプログラムの実行方法についてご説明します その後 Qt API を使用した Qt アプリケーションの実装方法 ビルド方法 実行方法についてご説明します 18

19 2.1 サンプルプログラムの実行方法 Qt には数多くのサンプルプログラムが含まれています Qt のインストール後 以下の方法で付属のサンプルプログラムを実行することができます Qt をインストールしたトップディレクトリを C: Qt とした場合 以下のフォルダ内にサンプルプログラムがカテゴリ毎に分類されて置かれています C:\Qt\4.6.0\examples\ 例えば C: Qt examples widgets calculator には 計算機のプログラムがありま す これを起動するには 次のいずれかのようにします 環境変数 PATH の設定が必要です エクスプローラから実行 エクスプローラで C: Qt examples widgets calculator release を開き calculator.exe をダブルクリック コマンドプロンプトから実行 次のコマンドを実行します C:\> cd C:\Qt\4.6.0\examples\widgets\calculator\release C:\Qt\4.6.0\examples\widgets\calculator\release> calculator.exe 実行すると 次のようなウィンドウが表示されます 19

20 2.2 開発手順 ここでは Qt を使用したプログラム開発における手順について説明します Qt を使用したプログラムのソースファイルを作成し ビルド 実行する一般的な手順は次 のようになります (1) プロジェクトディレクトリの作成 (2) ソースファイルの作成 編集 (3) プロジェクトファイルの作成 編集 (4) ビルドルールの作成 (5) ビルド (6) 実行 この手順の例として Qt を使用した簡単なプログラムを最初から作成してみます ここで は Hello World! と言う文字列が書かれたボタンを表示するプログラムを作成します 以 下で手順を説明します (1) プロジェクトディレクトリの作成実行可能ファイルやライブラリ等を作成するための単位を プロジェクト と呼びます プロジェクトは実装ファイルやヘッダファイル リソースファイル等で構成されます まずは これらのファイルを格納するためのフォルダを作成します コマンドプロンプトを起動し 以下のコマンドを実行します ここでは taro ユーザの My Documents フォルダ以下に hello と言う名前のフォルダを作成するものとします C:\Documents and Settings\taro\My Documents> mkdir hello (2) ソースファイルの作成作成 編集プロジェクトディレクトリへ移動します C:\Documents and Settings\taro\My Documents> cd hello 必要なソースファイルやヘッダファイルを テキストエディタを使用して作成します 今回はこのフォルダ内にソースファイル main.cpp を以下の内容で作成します 20

21 #include <QApplication> #include <QPushButton> int main(int argc, char *argv[]) { QApplication app(argc, argv); } QPushButton hello("hello World!"); hello.show(); return app.exec(); (3) プロジェクトファイルの作成プロジェクトファイルとは プロジェクトをビルドするために必要な情報が記述されたファイルです また その内容はプラットフォーム非依存なものになります プロジェクトファイルを基に 各プラットフォーム上でビルドするためのビルドルールが記述されたファイルを生成することができます プロジェクトファイルを手動で記述することもできますが Qt ではプロジェクトのフォ ルダ内の情報から自動的にプロジェクトファイルを生成する方法も提供しています 自 動的にプロジェクトファイルを生成するには以下のコマンドを実行します C:\Documents and Settings\taro\My Documents\hello> qmake project qmake コマンドにオプション引数 project を付けて実行すると プロジェクトフォルダに収められたファイルの情報を読み込み それらをビルドするためのプロジェクト情報として デフォルトのプロジェクトファイルが生成されます デフォルトのプロジェクトファイルは プロジェクトフォルダ名に対して 拡張子.pro が付加されたものになります この場合 hello.pro と言う名前でプロジェクトファイルが生成されます 開発者はこのデフォルトのプロジェクトファイルに対して 追加 修正を加えることで 開発者の要求に応じたプロジェクトファイルとしてカスタマイズを行なう事ができます このコマンドを実行する必要があるのは 主に次のような場合です 21

22 新しくプロジェクトを作成して まだ.pro ファイルが存在しないとき プロジェクトを構成するファイルを追加もしくは削除したとき あるいはファイル 名が変更されたとき ファイルを編集して内容が変わっても プロジェクトを構成するファイルの名前や数が 変わらなければ このコマンドを実行する必要はありません プロジェクトファイルに対して手動で追加 修正した場合 qmake project を実行する ことで プロジェクトファイルが上書きされ 変更した部分が失われてしまいますので ご注意ください (4) ビルドルールの作成先ほど作成したプロジェクトファイルを基に ビルドルールが記述されたファイルを生成します ビルドルールの作成は コマンドプロンプト上で 次のように qmake コマンドを引数無しで実行します C:\Documents and Settings\taro\My Documents\hello> qmake 上記のように実行すると qmake コマンドが プロジェクトファイル hello.pro の内容 を読み込み あらかじめ設定されている環境に合わせたビルドルールが生成されます 今回は nmake コマンド用の Makefile が生成されます このコマンドを実行する必要があるのは 次のような場合です ビルドルールが記述されたファイルが存在しない場合 Qt プロジェクトファイルが更新された場合 実装したクラスに新たに Q_OBJECT マクロを追加した場合 (5) ビルド先ほど作成したビルドルールが記述されたファイルにしたがって プロジェクトをビルドします 開発環境として Windows 上で Visual Studio を使用する場合 ビルドには Visual Studio に付属するコンパイラやコマンドを使用します 今回は生成されるビルドルールが 22

23 nmake コマンド用になりますので 以下のようにコマンドを実行して ビルドを行いま す C:\Documents and Settings\taro\My Documents\hello> nmake このように実行した場合 デバッグ用の実行可能ファイルが生成されます デバッグ用 ではなくリリース用実行可能ファイルを作成するには 次のようにターゲットとして release を指定して実行します C:\Documents and Settings\taro\My Documents\hello> nmake release (6) 実行ビルドが成功すると debug もしくは release ディレクトリにプログラムの実行形式が生成されます 実行可能ファイルの名前は プロジェクトディレクトリ名に.exe 拡張子が付いたものになります 今回の場合は hello.exe という実行可能ファイルが作成されます release の場合 C:\Documents and Settings\taro\My Documents\hello>.\release\hello debug の場合 C:\Documents and Settings\taro\My Documents\hello>.\debug\hello 上記のように実行すると 以下のようなウィンドウが表示されます ビルドルール生成生成についてのについての補足開発環境として Windows 上で Visual Studio を使用する場合 ビルドルールとして nmake 用の Makefile の代わりに Visual Studio 用プロジェクトファイルを使用することも可能です この場合 ビルドルールの生成時に以下のようにオプションを付けて qmake 23

24 コマンドを実行することにより Visual Studio 用プロジェクトファイルを生成すること ができます C:\Documents and Settings\taro\My Documents\hello> qmake tp vc 上記のように実行すると hello.vcproj と言う名前でプロジェクトファイルが生成されま す その後は Visual Studio が提供している機能 操作方法にしたがって プロジェクト のビルド 実行ができます 24

25 3 Qt を習得するには Qt には アプリケーション実装の際に参考になるプログラムが多数含まれています これらに目を通しておくことで アプリケーションを開発する際のヒントが得られます また 書籍として発行されている情報や Qt Development Frameworks, Nokia 社のサイトにも開発の際に役に立つ多数のドキュメントが提供されていますので ここではそれらの情報について記述します 25

26 3.1 Qt に付属する情報 ここでは Qt を導入するにあたり参考になるような情報として Qt に付属しているサンプ ルプログラムやドキュメントについてご紹介します Qt 付属のサンプルプログラム Qt をインストールしたディレクトリ直下の examples 以下に多数のサンプルプログラムが含まれています これらは Qt 個々の機能のサンプルプログラムであり 機能ごとに分かれて置かれています この中でももっとも自習用にお勧めのプログラムがチュートリアル (examples/tutorial) です Qt 付属のドキュメントにチュートリアルの解説がありますので合わせてご参照ください Qt 付属のデモンストレーションプログラム Qt をインストールしたディレクトリ直下の demos 以下にデモンストレーション用のプログラムが含まれています Qt Examples and Demos は Qt のデモンストレーションプログラムおよびサンプルプログラムを起動するためのランチャプログラムです ランチャプログラムを通して Qt が提供するデモンストレーションプログラム等を簡単な操作で確認する事ができます Qt 付属のドキュメント Qt には Qt Reference Documentation というオンラインマニュアルが付属しています 次の二つのツールで参照できますが 内容は同じです なお Qt Reference Documentation および Qt Assistant のインストール先については 1.3 インストールファイル をご覧ください Qt Assistant( ドキュメントブラウザ ) で表示 Qt Assistant は Qt のドキュメントブラウザです Qt Assistant が表示する内容は 次項のウェブブラウザで表示できるものとほぼ同じですが ドキュメントの階層表示や キーワードによる全文検索ができるなど やや高機能になっています チュートリアルの解説ページは 以下の要領で辿る事ができます Qt Reference Documentation Getting Started Tutorials, Examples and Demonstrations 26

27 ウェブブラウザで表示 Qt Reference Documentation は HTML 形式ですので ウェブブラウザを使用して表示できます index.html がトップページです トップページの Tutorial and Examples というリンクをクリックすると チュートリアルやサンプルプログラムの解説ページを辿ることができます 27

28 3.2 Qt に関する書籍 ここでは Qt について記述されている書籍についてご紹介します 英語で記述されたもの と その日本語訳の書籍があります 入門 Qt 4 プログラミング ( 既刊 Qt 4.1 ベース ) Jasmin Blanchette, Mark Summerfield 著 杵渕聡 杉田研治訳 オライリー ジャパン Qt GUI プログラミング ( 既刊 Qt 3 ベース ) Jasmin Blanchette, Mark Summerfield 著 杵渕聡 杉田研治訳 ソフトバンクパブリッシング株式会社 C++ GUI Programming With Qt 4 Second Edition (2008 年 2 月 8 日発売 洋書 Qt 4.3 ベース ) Jasmin Blanchette, Mark Summerfield 著 Prentice Hall C++ GUI Programming With Qt 4 (2006 年 7 月 7 日発売 洋書 Qt 4.1 ベース ) Jasmin Blanchette, Mark Summerfield 著 Prentice Hall 28

29 3.3 Qt の情報源 Qt Development Frameworks, Nokia 社の公式サイト ( に Qt の情報が集約されています 開発者向けページ ( か ら辿ることができる 以下のページが特にお勧めです Supported Platforms プラットフォームに関する情報です FAQ FAQ のページです Qt Bug Tracker ユーザから報告のあった不具合や提案などの一覧があります Online Reference Documentation リファレンスマニュアルや各種ツール 定期刊行記事へのリンクがあります 29

30 改訂履歴 日付 内容 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 日 新規作成 30