78 lines
4.2 KiB
Markdown
78 lines
4.2 KiB
Markdown
|
# javalocator.h — JavaLocator
|
||
|
|
|
||
|
|
## Обзор
|
||
|
|
|
||
|
|
Для запуска Minecraft нужна Java подходящей версии: старым версиям игры — восьмая, новым —
|
||
|
|
семнадцатая или двадцать первая. Лаунчер умеет скачивать сборки Java сам (см.
|
||
|
|
[JavaInstaller](JavaInstaller.md)), но сначала стоит посмотреть, что уже есть на машине.
|
||
|
|
|
||
|
|
`JavaLocator` отвечает за поиск: собирает все доступные java, определяет их версии и выбирает
|
||
|
|
подходящую под требование версии игры. Пространство имён используется при подготовке запуска и при
|
||
|
|
показе списка найденных Java в настройках.
|
||
|
|
|
||
|
|
## Пространства имён
|
||
|
|
|
||
|
|
`JavaLocator` группирует четыре функции поиска и выбора. Состояния нет, но результат определения
|
||
|
|
версии кэшируется внутри реализации.
|
||
|
|
|
||
|
|
## Функции
|
||
|
|
|
||
|
|
#### QStringList findAll(const QString &gameDir)
|
||
|
|
|
||
|
|
Все java, которые удалось найти, без дублей и в порядке приоритета. Просматриваются четыре
|
||
|
|
источника: рантайм самого Minecraft внутри папки игры, переменная `JAVA_HOME`, переменная `PATH` и
|
||
|
|
стандартные каталоги установки JDK и JRE.
|
||
|
|
|
||
|
|
Параметр `gameDir` — папка игры; из неё берётся первый источник.
|
||
|
|
|
||
|
|
Результат показывается в диалоге настроек списком «что нашлось в системе».
|
||
|
|
|
||
|
|
#### int majorVersion(const QString &javaPath)
|
||
|
|
|
||
|
|
Мажорная версия java по её пути: 8, 17, 21 и так далее. Возвращает `0`, если запустить
|
||
|
|
исполняемый файл не удалось — путь неверен, файл не исполняемый или это не java.
|
||
|
|
|
||
|
|
Результат кэшируется: определение версии требует запуска процесса, а один и тот же путь
|
||
|
|
проверяется многократно.
|
||
|
|
|
||
|
|
#### QString windowlessVariant(const QString &javaPath)
|
||
|
|
|
||
|
|
Заменяет `java.exe` на `javaw.exe`, чтобы игра не открывала окно консоли. На Unix возвращает вход
|
||
|
|
без изменений — там разницы нет.
|
||
|
|
|
||
|
|
#### QString select(const QString &gameDir, int requiredMajor, const QString &preferred, QString \*error)
|
||
|
|
|
||
|
|
Выбирает java не ниже `requiredMajor`. Если задан `preferred` — путь, указанный пользователем в
|
||
|
|
настройках, — он проверяется первым и, если подходит, побеждает. Иначе перебираются найденные
|
||
|
|
`findAll()` варианты.
|
||
|
|
|
||
|
|
При неудаче возвращает пустую строку и заполняет `error` — текст объясняет, что именно не нашлось:
|
||
|
|
подходящей версии нет вовсе или указанный пользователем путь не подошёл.
|
||
|
|
|
||
|
|
Функция запускает процессы для определения версий, поэтому может занять заметное время; вызывать
|
||
|
|
её в обработчике нажатия не стоит.
|
||
|
|
|
||
|
|
## Зависимости
|
||
|
|
|
||
|
|
Подключает `QString` и `QStringList`. От классов проекта не зависит.
|
||
|
|
|
||
|
|
## Пример использования
|
||
|
|
|
||
|
|
```cpp
|
||
|
|
QString error;
|
||
|
|
const QString java = JavaLocator::select(gameDir,
|
||
|
|
version.javaMajor,
|
||
|
|
settings.javaPath,
|
||
|
|
&error);
|
||
|
|
if (java.isEmpty()) {
|
||
|
|
emit launchError(error);
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
process.start(JavaLocator::windowlessVariant(java), arguments);
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
При создании этого документа использовался ИИ.
|