blob: 549ef6537682acf0f9bc3f80949a5543b9fa750d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** GNU Free Documentation License
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms
** and conditions contained in a signed written agreement between you
** and Nokia.
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\page qmake-tutorial.html
\title qmake チュートリアル
このチュートリアルでは \c qmake の使い方を説明します。
このチュートリアルを読み終わったら \c qmake
のユーザガイドを読むことをお勧めします。
\section1 簡単な例
アプリケーションの基本的な実装は既に完了していて、
次のファイルが作成されていると仮定します。
\list
\o hello.cpp
\o hello.h
\o main.cpp
\endlist
これらのファイルは Qt ディストリビューションの
\c{examples/qmake/tutorial} ディレクトリにあります。
アプリケーションの設定について知っておくべきことは、
それが Qt で書かれているということだけです。
まず、テキストエディタで \c{examples/qmake/tutorial} に
\c hello.pro というファイルを作成します。
最初にすることは、開発プロジェクトに含まれるソースファイルとヘッダファイルを
\c qmake に教える行を追加することです。
ソースファイルをプロジェクトファイルに追加します。
これには \l{qmake Variable Reference#SOURCES}{SOURCES} 変数を使います。
新しい行を作り、\c{SOURCES +=}、続いて hello.cpp を入力します。
つまり、以下のようになります:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 108
これを以下のようになるまでプロジェクトの各ソースファイルに対して行います:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 109
make に似たシンタックスを使いたい場合は、
以下のように改行をエスケープしてすべてのファイルを 1 行に書きます:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 110
ソースファイルの一覧をプロジェクトファイルに追加しました。
次にヘッダファイルを追加します。
ヘッダファイルはソースファイルと全く同じ方法で追加することができます。
ただし変数は \l{qmake Variable Reference#HEADERS}{HEADERS}
を使います。
これを終えると、プロジェクトファイルは以下のようになるでしょう:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 111
ターゲットの名前は自動的に設定され、
プロジェクトファイルと同じ名前になります。
ただしプラットフォームに合わせたサフィックスがつけられます。
例えば、プロジェクトファイルが \c hello.pro である場合、
ターゲットは Windows では \c hello.exe 、Unix では \c hello になります。
プロジェクトファイルで別の名前を指定することもできます:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 112
最後に \l{qmake Variable Reference#CONFIG}{CONFIG} 変数を設定します。
このアプリケーションは Qt アプリケーションなので \c CONFIG に
\c qt を追加する必要があります。
\c qmake は リンクの必要があるライブラリを追加し、
\c moc と \c uic の実行コマンドが Makefile に含まれるようにします。
最終的なプロジェクトファイルは以下のようになります:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 113
\c qmake を使って、このアプリケーションのための Makefile を生成します。
プロジェクトのディレクトリでコマンドラインに次のように入力します:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 114
そして、使用するコンパイラによって \c make または \c nmake を入力します。
Visual Studio ユーザの場合、\c qmake は、以下のように
\c .dsp ファイルまたは \c .vcproj ファイルも作成できます:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 115
\section1 アプリケーションをデバッグできるようにする
アプリケーションのリリースバージョンはデバッグシンボルなどのデバッグ情報を含みません。
開発中は、関連情報を含むアプリケーションのデバッグバージョンを作成するのが便利です。
これは、プロジェクトファイルの \c CONFIG 変数に \c debug
を追加することで簡単に実現できます。
たとえば:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 116
直前の例と同様に、Makefile を生成するには \c qmake を使います。
アプリケーションをデバッグ環境で実行する際に役に立つ情報を得られるようになります。
\section1 プラットフォーム固有のソースファイルを追加する
数時間コーディングをしていると、
アプリケーションにプラットフォーム固有な部分が出てきて
プラットフォーム固有のコードを別のファイルに分けたい場合があるかもしれません。
ここでは 2 つのファイル \c hellowin.cpp と \c hellounix.cpp があるとして、
これをプロジェクトファイルに追加します。
これらのファイルをそのまま \c SOURCES 変数に追加することはできません。
なぜなら、両方のファイルが Makefile に追加されてしまうからです。
\c qmake が実行されたプラットフォームにしたがって処理されるスコープを使う必要があります。
Windows 用のファイルを追加するシンプルなスコープは以下のようになります:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 117
\c qmake が Windows 上で実行されると、ソースファイルのリストに
\c hellowin.cpp が追加されます。
\c qmake が他のプラットフォームで実行された場合、この部分は無視されます。
次に Unix 用ファイルのスコープを作成します。
これを終えると、プロジェクトファイルは以下のようになります:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 118
これまでと同様に、Makefile を生成するには \c qmake を使います。
\section1 ファイルが存在しない場合に qmake を中止する
特定のファイルが存在しない場合に Makefile を作成したくない場合、
exists() 関数を使ってファイルが存在するかどうかを確認することができます。
また error() 関数を使って \c qmake の処理を中止させることができます。
これらの関数はスコープとして動作します。
使い方はスコープの条件をこれらの関数で置き換えるだけです。
\c main.cpp ファイルの確認は以下のようになります :
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 119
記号 \c{!} はテストを否定します。
つまり \c{exists( main.cpp )} はファイルが存在する場合に真になり、
\c{!exists( main.cpp )} はファイルが存在しない場合に真になります。
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 120
前と同様に、\c qmake を実行して Makefile を生成します。
仮に \c main.cpp の名前を変更すると、上記のメッセージが表示され、
\c qmake は処理を中止します。
\section1 複数の条件をチェックする
Windows を使っていて、
コマンドラインからこのアプリケーションを実行したときに
qDebug() の出力を見ることができるようにしたい場合、
アプリケーションをコンソールの設定を追加してビルドする必要があります。
Windows で Makefile をこの設定にするには、
\c CONFIG に \c console を追加します。
Windows で実行されていて、\e{かつ} \c CONFIG にすでに \c debug
がある場合にのみ \c CONFIG を追加したい場合があるかもしれません。
このような場合、2 つのスコープをネストさせて使います。
まず 1 つのスコープを作成し、その中にもう 1 つスコープを作成します。
そして 2 つのスコープの中に設定を書きます。例えば:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 121
ネストされたスコープはコロンを使ってつなぐことができます。
最終的なプロジェクトファイルは以下のようになります:
\snippet doc/src/snippets/code/doc_src_qmake-manual.pro 122
以上です。\c qmake のチュートリアルが終了しました。
それでは、あなたの開発プロジェクトのプロジェクトファイルを作成してみましょう。
*/
|
