98 lines
6.8 KiB
Markdown
98 lines
6.8 KiB
Markdown
# main.cpp — точка входа
|
||
|
||
## Обзор
|
||
|
||
`Minecraft_launcher` — десктопный лаунчер Minecraft на Qt 6 Quick. Интерфейс написан на QML,
|
||
вся работа — авторизация, скачивание версий, установка модлоадеров и Java, запуск игры — лежит в
|
||
C++-классе [LauncherBackend](LauncherBackend.md) и его сервисах.
|
||
|
||
`main.cpp` — стартовая последовательность приложения: здесь при необходимости инициализируется
|
||
Qt WebEngine, создаётся объект приложения, читается каталог переводов, выбирается стиль
|
||
Qt Quick Controls, загружается QML-модуль и запускается цикл событий. Файл намеренно короткий:
|
||
ни одного объекта предметной области он не создаёт — всё, что нужно, QML заводит сам.
|
||
|
||
## Настройка приложения Qt
|
||
|
||
Создаётся `QGuiApplication` — не `QApplication`: интерфейс целиком на Qt Quick, виджеты не
|
||
используются, и модуль Qt Widgets в проект не подключён.
|
||
|
||
До создания приложения, при сборке с Qt WebEngine, вызывается `QtWebEngineQuick::initialize()`.
|
||
Порядок здесь принципиален: инициализация выставляет общий контекст OpenGL, а после создания
|
||
объекта приложения это уже не действует. Вызов обёрнут в условную компиляцию по макросу
|
||
`LAUNCHER_HAS_WEBENGINE`.
|
||
|
||
## Каталог переводов
|
||
|
||
Сразу после создания приложения вызывается `Localization::instance().load()` — он читает
|
||
`i18n/translations.json` из ресурсов и определяет язык интерфейса. Порядок важен: язык нужно
|
||
знать до того, как QML вычислит первую привязку, а [LauncherBackend](LauncherBackend.md),
|
||
который ведёт `settings.json`, появляется только вместе с движком — поэтому ключ `language`
|
||
[Localization](Localization.md) читает из файла сам.
|
||
|
||
Неудача — не повод продолжать: каталог вкомпилирован в бинарник, значит его отсутствие или
|
||
поломка означают ошибку сборки. `main()` пишет причину и возвращает `-1`.
|
||
|
||
## Стиль Qt Quick Controls
|
||
|
||
Стиль Qt Quick Controls принудительно выставляется в `Basic`
|
||
вызовом `QQuickStyle::setStyle()`. Причина в оформлении: всё окно лаунчера стилизовано вручную, а
|
||
нативный стиль Windows игнорирует пользовательские `contentItem` и `background` и сыплет
|
||
предупреждениями.
|
||
|
||
## Обработка командной строки
|
||
|
||
Аргументы командной строки не разбираются: `argc` и `argv` передаются в конструктор
|
||
`QGuiApplication` и дальше не используются. Ни `QCommandLineParser`, ни собственного разбора в
|
||
файле нет.
|
||
|
||
## Создание объектов верхнего уровня
|
||
|
||
В `main()` создаётся ровно два объекта.
|
||
|
||
| Объект | Тип | Роль |
|
||
|--------|-----|------|
|
||
| `app` | `QGuiApplication` | объект приложения и цикл событий |
|
||
| `engine` | `QQmlApplicationEngine` | загружает и исполняет QML-модуль лаунчера |
|
||
|
||
Экземпляр `LauncherBackend` здесь не создаётся: тип зарегистрирован через `QML_ELEMENT`, и главное
|
||
окно объявляет его само декларативно. Поэтому в `main.cpp` нет ни одного `#include` классов
|
||
предметной области.
|
||
|
||
## Связывание и подключения
|
||
|
||
Единственное подключение — обработка неудачи создания корневого объекта: сигнал
|
||
`QQmlApplicationEngine::objectCreationFailed` замыкается на лямбду, которая завершает приложение
|
||
с кодом `-1`. Соединение создаётся с типом `Qt::QueuedConnection` и с объектом `app` в роли
|
||
контекста, чтобы выход из приложения происходил уже внутри цикла событий, а не в разгар загрузки
|
||
QML.
|
||
|
||
Контекстные свойства не задаются, начальные свойства корневому объекту не передаются: связь между
|
||
QML и C++ идёт исключительно через зарегистрированный тип.
|
||
|
||
## Цикл событий
|
||
|
||
QML загружается вызовом `engine.loadFromModule("Minecraft_launcher", "Main")` — по URI модуля и
|
||
имени типа, а не по пути к файлу. Модуль объявлен в `CMakeLists.txt` через `qt_add_qml_module`, а
|
||
`Main` — это [Main.qml](../qml/Main.md), корневой элемент которого `Window` с `visible: true`,
|
||
поэтому окно показывается само.
|
||
|
||
Цикл событий запускается `app.exec()`, его результат возвращается из `main()` как код завершения
|
||
процесса.
|
||
|
||
## Зависимости
|
||
|
||
| Заголовок | Что даёт |
|
||
|-----------|----------|
|
||
| `QGuiApplication` | объект приложения и цикл событий для приложения без виджетов |
|
||
| `QQmlApplicationEngine` | загрузка QML-модуля и создание корневого объекта |
|
||
| `QQuickStyle` | выбор стиля Qt Quick Controls до загрузки QML |
|
||
| `QtWebEngineQuick` | инициализация WebEngine; подключается только при сборке с Qt WebEngine |
|
||
|
||
Модули сборки: `Qt6::Quick`, `Qt6::QuickControls2`, `Qt6::Core`, `Qt6::CorePrivate`, `Qt6::Gui`,
|
||
`Qt6::Network` и опционально `Qt6::WebEngineQuick`. Макрос `LAUNCHER_HAS_WEBENGINE` определяется в
|
||
`CMakeLists.txt` только тогда, когда `find_package` нашёл `Qt6WebEngineQuick`.
|
||
|
||
---
|
||
|
||
При создании этого документа использовался ИИ.
|