Qt

About

参考になる情報源がいくつかある。

• GitHub - PacktPublishing/Mastering-Qt-5: Code repository for Mastering Qt 5 published by Packt
• Mastering Qt5に沿って勉強するページ | taro3.github.io
• examples - qt/qtbase.git - Qt Base (Core, Gui, Widgets, Network, ...): Qtのチュートリアルやサンプルの格納場所。

Mastering Qt5という本があり、それを翻訳している人がいる。

General

License

情報源:

• Qt - Obligations of the GPL and LGPL
• Open Source Development | Open Source License | Qt
• Qt ライセンスについて #Qt - Qiita
• ios - Does App Store accept Qt app linked with QT Library LGPLv3 - Stack Overflow

Qtには3種類のライセンス形態がある。

1. 商用: 有償。不自由ソフトの開発用。
2. GPLv3: 自由ソフト用。
3. LGPLv3: 無償で不自由ソフトの開発に使用可能。ただし、ユーザーにQt部分のライブラリーを置換可能な手順・プロジェクトファイル群の提供が必要で、使用可能なモジュールの制限が多い。Stack Overflowや公式サイト (Open Source Development | Open Source License | Qt) 説明がわかりやすい。

LGPLv3の義務は以下。

• Qtライブラリの再リンクメカニズムを提供する
• ライセンスのコピーを提供し、Qtの使用を明示的に記載する
• Qtソースコードのコピーを顧客が利用できるようにする
• Qtソースコードの変更が独占的でないことを了承する
• 「オープン」なコンシューマデバイスを作成する
• デジタル著作権管理の条件に同意する（GPL FAQをご覧ください）
• ソフトウェア特許を施行しようとするときは、特別な配慮が必要（FAQ

Business

OSSライセンスで開発後、商用ライセンスに移行する場合、不可能ではないが条件がある。

• Qt FAQ: Qt Open source Licensing
• Qt FAQ: Qt Commercial Licensing

まず、Qtの営業に連絡する。商用ライセンスのモジュールは不自由ソフトなので、そこを維持するために、OSS部分を移行する必要があり、以降の支援の業務契約がおそらく必要。そうとう金額がかかるだろう。

Module

ライセンス形態ごとに使用可能なモジュールが変わる (Qt Features, Framework Essentials, Modules, Tools & Add-Ons)。これが個人的には大きい。

2023-12-13 Wed。

GPLv3で使用不能モジュール

• Development Tools
  • Qt Quick Compiler Extensions
  • Qt Quick Ultralight Compiler
  • Qt Quick Ultralight Project Exporter
• Framework Add-Ons
  • Qt Digital Advertising
  • Active Qt
  • Qt WebEngine
  • Qt Safe Renderer
  • Qt Quick Ultralite Controls
  • Qt Quick Ultralite
  • Non-automotive MCU Deployment Platforms
  • Automotive MCU Deployment Platforms
  • Qt Design Studio Bridge
  • Qt for Android Automotive OS Car Service API
  • Simulink support for Qt Design Studio
  • Boot to Qt
  • Qt for Python commercial add-ons

LGPLv3で使用不能なもの

• GPLv3で使用不能なもの
• Framework Add-Ons
  • Qt Wayland Compositor
  • Qt Charts
  • Qt Data Visualization
  • Qt Network Authorization
  • Qt Virtual Keyboard
  • Qt Safe Renderer
  • In-Vehicle Infotainment Reference UI
  • Qt Application Manager
  • Qt Device Utilities
  • Qt MQTT
  • Qt CoAP
  • Qt Design Studio Bridge
  • Qt Quick Calendar
  • Qt Quick TreeView n
  • Qt Quick Timeline
  • Qt Lottie Animation
  • Qt Quick 3D
  • Qt HTTP Server
  • Qt Quick 3D Physics
  • Qt gRPC
  • Qt Protobuf

使用不能なモジュールを見る限り、別にLGPLv3でも通常利用には問題ないように感じる。どうせ元々使いたいものはGPLv3でも使用不能だし。

Style

Qtでの開発のコーディング規約が気になったので調べた。

• Member variable naming convention in Qt and the QtDN wiki | Qt Forum
• Qt Coding Style - Qt Wiki
• Coding Conventions - Qt Wiki
• c++ - Qt naming convention for variables and getters so they don't collide? - Stack Overflow
• The Property System | Qt Core 6.6.1

特に特徴的なものを以下に記載する。

• 関数の波括弧のみ次の行。
• メンバー変数はm_のプレフィクスでmixedCase。

Platform

iOS

出典: Qt for iOS | Qt 6.6。

Xcodeが必須。それ以外はソースコードに手を付けなくてもビルドはできる。

Qt Creator

出典: Qt Creator Manual。

Qtの標準IDE。Qtの開発で非常に重要。

Tutorial

出典: Creating a Qt Widget Based Application | Qt Creator Manual。

Other

MacのBackspace

出典: [QTCREATORBUG-26764] Backspace is not working in Mac Qt Creator 6.0.1 - Qt Bug Tracker。

MacのQt Createorだと、Google日本語入力のIMEだとBackspaceやDeleteキーがうまく動作しない模様。

しかたないので、開発作業中だけデフォルトIMEのKotoeriを使う。

Qt Widgets

出典: Qt Widgets 6.6.1。

Qtの原点。昔ながらのC++デスクトップアプリ用のモジュール。古くから存在していて、一番安定している。C++のフル機能を利用できる。Qt Quickも悪くはないが、こちらはモバイルファースト。C++技術者ならC++の勉強のためにもQt Widgetsを使うのがいい。Qt QuickはC++をあまり使わなくて、C++の知識の流用・学習が利かない。

main.cpp

出典: Widgets Tutorial | Qt Widgets 6.6.1。

Qt Widgetを使ったアプリは以下のmain.cppから始まるのが基本。

#include <QtWidgets>

// Include header files for application components.
// ...

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // Set up and show widgets.
    // ...

    return app.exec();
}

QtのアプリはQObjectクラスを全て継承しており、内部で連携している。

QApplicationでインスタンスを生成したら、それ以後にQObject派生クラスを生成したりすると、内部的に連携しているこれでアプリを作っていく感じになる。

Getting Started Programming with Qt Widgets

出典: Getting Started Programming with Qt Widgets | Qt Widgets 6.6.1。

このチュートリアルが良くできている。この中身を理解できれば、それで基本的なアプリを作れると思う。

signal/slot

slots named on_foo_bar are error prone

Qt Deisgnerで [Go to slot] で自動生成されるslotはon_[widget name]_[signal]() のような命名規則になっている。この命名規則だと自分でconnectで結び付けなくてもいい。ただ、Qt Creatorで以下の警告がでる。

slots named on_foo_bar are error prone [clazy-connect-by-name]

出典:

• qt - How may I fix my error prone on_foo_bar slots - Stack Overflow
• what does 'Slots named on_foo_bar are error prone' mean? | Qt Forum
• clazy/docs/checks/README-connect-by-name.md at master · KDE/clazy · GitHub
• QObject Class | Qt Core 6.6.1
• Using a Designer UI File in Your C++ Application | Qt Designer Manual

この規則は便利ではあるが、例えばウィジェット名を変更した場合に反映されないので問題になりやすいので警告が出る模様。

自分でconnectで指定するのがよいとか。後で理解できたところで対応する。

Qt Designer

出典: Qt Designer Manual。

Qt DesignerはQt WidgetsのGUIエディター。画面でUI部品を構築できて、UI部品をxmlにしてくれる。

Qt Widgetsでの画面開発をかなり簡単にしてくれる。Qt Widgetsの基本を学習したら、たぶんQt Designerを使ったほうがいい。

元々は専用のアプリだったが、今はQt Creatorに組み込まれている。

Connect the signals to the slots

出典: A Quick Start to Qt Designer | Qt Designer Manual。

Qt Designerでウィジェットを右クリック-[Go to slot] を選ぶと、スロットを設定できる。

[Select signal] 画面で対象のsignalを選択して、該当slotの作成となる。

Menu

左上のツールバー？部分に [Type Here] と表示されている。ここにメニューの項目名を入力する (例: File)。

するとメニューが生成されて、メニュー項目に対して [Type Here] が表示される。同じようにここを入力すると (例: New)、メニューのサブ項目が生成される。そして、[Action Editor] にActionも追加される。

追加されたActionに対して、右クリック-[Go to slot]-[triggered()] を選ぶと、該当slot関数の雛形が生成される。

HTTP

情報源:

• HTTPデータの送受信 | taro3.github.io
• c++ - How do I write a Qt HTTP GET request? - Stack Overflow
• HTTP Client | Qt Network 6.6.1

HTTPサーバーへのリクエストは頻出処理。curlで自分で実装してもいいが、Qtで専用のクラス類が用意されているので使うといい。

具体的には以下の3クラスにお世話になる。

• QNetworkAccessManager: このクラスは、アプリケーションが要求を送信し、応答を受信することを可能にします。
• QNetworkRequest: このクラスは、送信するリクエストをすべての情報（ヘッダ、URL、データなど）と一緒に保持します。
• QNetworkReply: このクラスは、ヘッダーとデータを持つQNetworkRequestクラスの結果を含みます。

QML

http://doc.qt.io/qt-6/qtqml-documents-structure.html

2種類から構成。

1. import文
2. rootオブジェクト宣言

importとオブジェクトは空行で分離。

エンコーディングはUTF-8。