109 lines
5.5 KiB
C++
109 lines
5.5 KiB
C++
|
#pragma once
|
|||
|
|
|
|||
|
|
#include <QAtomicInt>
|
|||
|
|
#include <QHash>
|
|||
|
|
#include <QJSValue>
|
|||
|
|
#include <QList>
|
|||
|
|
#include <QObject>
|
|||
|
|
#include <QString>
|
|||
|
|
#include <QStringList>
|
|||
|
|
#include <QVariantList>
|
|||
|
|
#include <QtQml/qqmlregistration.h>
|
|||
|
|
|
|||
|
|
class QQmlEngine;
|
|||
|
|
class QJSEngine;
|
|||
|
|
|
|||
|
|
// Единственный источник всех текстов интерфейса. Каталог — i18n/translations.json,
|
|||
|
|
// он лежит в ресурсах и правится руками; штатных .ts/.qm в проекте нет намеренно.
|
|||
|
|
//
|
|||
|
|
// Из QML читается свойством: text: Loc.t.settings.title
|
|||
|
|
// Из C++ — свободной функцией: Loc::text("settings.title")
|
|||
|
|
//
|
|||
|
|
// Почему свойство, а не Q_INVOKABLE: вызов метода не регистрирует зависимость
|
|||
|
|
// привязки, и text: Loc.t("ключ") никогда бы не обновился при смене языка.
|
|||
|
|
// Чтение же Q_PROPERTY с сигналом NOTIFY зависимость регистрирует, поэтому
|
|||
|
|
// languageChanged перевычисляет все привязки разом. Дальнейшие .settings.title —
|
|||
|
|
// обычные обращения к членам JS-объекта, и отслеживать их не нужно: при смене
|
|||
|
|
// языка дерево заменяется целиком.
|
|||
|
|
//
|
|||
|
|
// Тип свойства — QJSValue, а не QVariantMap: QVariantMap пересобирался бы в новый
|
|||
|
|
// JS-объект при каждом чтении, а привязок в проекте полторы сотни. QJSValue
|
|||
|
|
// строится один раз на смену языка.
|
|||
|
|
class Localization : public QObject
|
|||
|
|
{
|
|||
|
|
Q_OBJECT
|
|||
|
|
QML_NAMED_ELEMENT(Loc)
|
|||
|
|
QML_SINGLETON
|
|||
|
|
|
|||
|
|
Q_PROPERTY(QJSValue t READ t NOTIFY languageChanged)
|
|||
|
|
// Что выбрано пользователем: "system", "ru" или "en".
|
|||
|
|
Q_PROPERTY(QString language READ language NOTIFY languageChanged)
|
|||
|
|
// Во что это разрешилось: всегда "ru" или "en", никогда "system".
|
|||
|
|
Q_PROPERTY(QString resolvedLanguage READ resolvedLanguage NOTIFY languageChanged)
|
|||
|
|
|
|||
|
|
public:
|
|||
|
|
static Localization &instance();
|
|||
|
|
|
|||
|
|
// Фабрика синглтона для движка QML. Объект к этому моменту уже загружен
|
|||
|
|
// из main(), здесь только запоминается движок и строится дерево.
|
|||
|
|
static Localization *create(QQmlEngine *qmlEngine, QJSEngine *jsEngine);
|
|||
|
|
|
|||
|
|
// Читает каталог из ресурсов и язык из settings.json. Вызывается ровно один
|
|||
|
|
// раз из main() до создания QQmlApplicationEngine. false — каталога нет или
|
|||
|
|
// он битый; это ошибка сборки, и запускаться дальше незачем.
|
|||
|
|
bool load();
|
|||
|
|
|
|||
|
|
QJSValue t() const { return m_tree; }
|
|||
|
|
QString language() const { return m_language; }
|
|||
|
|
QString resolvedLanguage() const;
|
|||
|
|
|
|||
|
|
// Только из GUI-потока: меняет дерево и рассылает languageChanged.
|
|||
|
|
void setLanguage(const QString &code);
|
|||
|
|
|
|||
|
|
// Для комбобокса в настройках: [{ "code": "ru", "name": "Русский" }, …],
|
|||
|
|
// первым пунктом — "system".
|
|||
|
|
Q_INVOKABLE QVariantList availableLanguages() const;
|
|||
|
|
|
|||
|
|
// Рабочие лошадки Loc::text/Loc::list. Потокобезопасны: см. комментарий к
|
|||
|
|
// полям ниже.
|
|||
|
|
[[nodiscard]] QString textFor(const char *key) const;
|
|||
|
|
[[nodiscard]] QStringList listFor(const char *key) const;
|
|||
|
|
|
|||
|
|
signals:
|
|||
|
|
void languageChanged();
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
explicit Localization(QObject *parent = nullptr);
|
|||
|
|
|
|||
|
|
void rebuildTree();
|
|||
|
|
|
|||
|
|
// Каталог заполняется один раз в load() и дальше только читается — поэтому
|
|||
|
|
// обращаться к нему можно из любого потока без блокировок. Единственное, что
|
|||
|
|
// меняется на ходу, — m_index, и он атомарный.
|
|||
|
|
QHash<QString, QStringList> m_singles; // ключ -> значения по языкам
|
|||
|
|
QHash<QString, QList<QStringList>> m_lists; // ключ -> списки по языкам
|
|||
|
|
QStringList m_codes; // ["ru", "en"] — порядок из _meta
|
|||
|
|
QHash<QString, QString> m_displayNames;
|
|||
|
|
|
|||
|
|
QAtomicInt m_index{0}; // индекс текущего языка в m_codes
|
|||
|
|
QString m_language{QStringLiteral("system")};
|
|||
|
|
|
|||
|
|
QJSEngine *m_engine = nullptr;
|
|||
|
|
QJSValue m_tree;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// ── Доступ из C++ ───────────────────────────────────────────────────────────
|
|||
|
|
//
|
|||
|
|
// Свободные функции, а не методы: их вызывают и из namespace-обёрток
|
|||
|
|
// (LauncherPaths, JavaLocator, ZlibReference), где никакого QObject нет.
|
|||
|
|
namespace Loc {
|
|||
|
|
|
|||
|
|
// Перевод по ключу. Ключа нет — возвращается сам ключ, в отладочной сборке ещё
|
|||
|
|
// и qWarning: строка вида "launch.error.gameRunning" в интерфейсе сразу видна.
|
|||
|
|
[[nodiscard]] QString text(const char *key);
|
|||
|
|
|
|||
|
|
// Для ключей со значением-списком (модели комбобоксов).
|
|||
|
|
[[nodiscard]] QStringList list(const char *key);
|
|||
|
|
|
|||
|
|
} // namespace Loc
|