Qt/C++ - Сабақ 049. QTranslator - көптілді қолданбаны Qt тіліне динамикалық аудару

QTranslator, Qt, Linguist

Ерте ме, кеш пе, Qt қосымшасының әзірлеушісі өз қолданбасында көптілділікті қолдау қажеттілігіне тап болады. Дәл осы кезде QTranslator сыныбы мен аударма жасауға арналған мамандандырылған қолданбасы Qt Linguist көмекке келеді.

QTranslator класының нысаны он алтылық аударма файлы болып табылатын .qm кеңейтімі бар арнайы файлдан аудармаларды жүктеу үшін пайдаланылады. Бұл файл XML пішіміндегі аударма файлынан құрастырылған, оның ts кеңейтімі бар және жобаның pro файлында жазылған. Бұл файлда tr() функциясына қосылған қолданбаның барлық жолдары бар. Мен сізге барлық қолданба интерфейсін ағылшын тілінде орнатуды ұсынамын, ол әдепкі тіл болады және аудармаларды қажетті тілмен жүктеңіз. аударма файлдарынан. Қажетті аударма файлы табылмаса, ағылшын тіліндегі аударма автоматты түрде жүктеледі. Әрине, әдепкі тіл ретінде басқа тілді пайдалануға болады.

Аударманы жүктеу мысалы

Аударма файлының атауының құрылымы QTranslator-пен жұмыс істеуде маңызды рөл атқарады. Минималды мысалды қарастырайық.

#include "mainwindow.h"
#include <QApplication>
#include <QTranslator>
#include <QLibraryInfo>

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

    QTranslator qtLanguageTranslator;
    qtLanguageTranslator.load(QString("QtLanguage_") + QString("ru_RU"));
    qApp->installTranslator(&qtLanguageTranslator);

    MainWindow w;
    w.show();

    return a.exec();
}

Бұл мысалда QTranslator класының объектісі жасалды, оған бізді қызықтыратын файл көрсетілген тілмен жүктеледі. Бұл жағдайда аударма файлының толық атауы QtLanguage_en.qm. Яғни, аударма файлының жалпы атауы QtLanguage , ал мақсатты тілдің префиксі _ru болып табылады. . Бірақ сіз QtLanguage_ru_RU жолы жүктеу әдісі үшін аргумент ретінде құрылғанын байқадыңыз. Бұл тілдің қажетті диалектісін анықтау үшін жасалады, мысалы, американдық (en_US) немесе британдық ( kk_GB) Ағылшын. Бірақ егер аударма файлының атауында диалект көрсетілмесе, онда диалект көрсетілмей, файл таңдалады, яғни QtLanguage_ru.qm.

Аударма файлы жүктелгеннен кейін ол қолданбада орнатылуы керек. Бұл жағдайда qApp->installTranslator(&qtLanguageTranslator) қолданбасына жаһандық көрсеткіш.

Аударма файлын жасаңыз

Қолданбаға аударманы орнатудың ең аз әдісін анықтағаннан кейін, жалпы аударманы қалай жасауға болатынын анықтайық. Аударма жасау үшін қолданбадағы tr(), trUtf8(), translate() функцияларын және т.б. Яғни, аударма файлын кейінірек жасау үшін аударманы қажет ететін барлық мәтін осы функцияларда жиектелуі керек. Бұл келесідей болуы мүмкін:

label->setText(QApplication::translate("MainWindow", "Select Language", 0));
label_2->setText(tr("Hello"));
label_3->setText(trUtf8("Hello world"));

Қолданбада аудармаға қажетті барлық жолдар белгіленгеннен кейін аударма файлын жасау, аударманың өзін жасау және соңғы файлды құрастыру қажет болады. Ол үшін келесі бағдарламалар қолданылады:

1. lupdate - pro файлындағы TRANSLATIONS өрісінен аударма файлын құруға, сонымен қатар аударманы қажет ететін қосымшадағы барлық жаңа жолдар туралы ақпаратты жаңартуға арналған бағдарлама.
2. lrelease – қолданбада қолданылатын соңғы аударма файлын құруға арналған бағдарлама.
3. Qt Linguist – аудармаларды жасауға арналған пакеттің өзі.

Қолданбада аударманы қажет ететін жолдар жазылғаннан кейін жасалуы керек бірінші қадам жобаның pro файлына аударуға арналған файлды қосу болып табылады. Сондай-ақ аударма үшін пайдаланылатын кодтау туралы ақпаратты ұсынғыңыз келуі мүмкін.

TRANSLATIONS += QtLanguage_ru.ts

CODECFORSRC     = UTF-8

Содан кейін QtLanguage_ru.ts. файлын жасау үшін lupdate утилитасын пайдалану керек. Qt Creator бағдарламасында мына жерден қараңыз: Құралдар -> Сыртқы -> Лингвист -> lupdate* .

lupdate аударма үшін жолдарды іздеу нәтижесін хабарлайды.

Запускается внешняя утилита «D:\Qt\5.6\mingw49_32\bin\lupdate.exe» D:/AndroidQT/QTProjects/QtLanguage/QtLanguage.pro
Updating 'QtLanguage_ru.ts'...
    Found 4 source text(s) (0 new and 4 already existing)

«D:\Qt\5.6\mingw49_32\bin\lupdate.exe» завершилась

Содан кейін біз Qt Linguist ашамыз және қайсысы аударылғанын белгілей отырып, барлық жолдарды аударамыз (Бұл аудармашының өзі үшін таза қызмет ақпараты, ненің аударылғанын және не аудармағанын есте сақтамау үшін).

Аударманы жасағаннан кейін файлды сақтаңыз және lrelease. утилитасын пайдаланып аударма он алтылық файлын құрастырыңыз.Оны Qt Creator бағдарламасында lupdate сияқты жерден табуға болады немесе Qt Linguist бағдарламасынан іске қосуға болады: Файл -> Шығару.

Файлды пайдалану үшін оны қолданбаның орындалатын файлы бар каталогқа орналастырып, осы файлға жолды кодқа жазу керек.

Динамикалық қолданба аудармасы

Қолданбаның аудармасын жүктеу жақсы, бірақ аударманы динамикалық түрде өзгерту қажет болса ше? Қолданбадағы аударманы өзгертетін екі тілде: ағылшын және орыс тілдерінде QComboBox бар шағын мысалды қарастырайық.

Жоба құрылымы

• QtLanguage.pro - жоба профилі;
• main.cpp - негізгі функциясы бар жоба файлы
• mainwindow.h - қолданбаның негізгі терезесінің тақырып файлы;
• mainwindow.cpp - қолданбаның негізгі терезесі үшін бастапқы код файлы;
• mainwindow.ui – қолданбаның негізгі терезесінің пішін файлы.

mainwindow.ui

Қолданбаның графикалық интерфейсін жасау үшін графикалық дизайнерді пайдаланғанды жөн көремін, себебі ол қолданбаның сыртқы көрінісінде күрделі нәрсе қажет болмаса, әзірлеуді тездетеді, сондықтан келесі көрінісі бар терезені жасайық.

Бұл терезе мыналарды қамтиды:

• заттаңба
• label_2
• ComboBox

Оның аудармасымен біз жұмыс істейтін боламыз. Графикалық дизайнердің ыңғайлылығы сонымен қатар retranslateUi() әдісін автоматты түрде генерациялауында, ол қолданбада қолданылатын барлық қолтаңбалардың аудармасын өзгерту үшін пайдаланылады, бірақ ұқсас әдісті қолмен жазуға болады. Өзіңіз, бірақ жеке мен уақытты жоғалтқым келмейді, өйткені керемет нәрсе автоматты түрде жасалуы мүмкін. Мысалы, бұл сабақта ол келесідей көрінеді:

void retranslateUi(QMainWindow *MainWindow)
{
    MainWindow->setWindowTitle(QApplication::translate("MainWindow", "MainWindow", 0));
    label_2->setText(QApplication::translate("MainWindow", "The QTranslator class provides internationalization support for text output.An object of this class contains a set of translations from a source language to a target language. QTranslator provides functions to look up translations in a translation file. Translation files are created using Qt Linguist.", 0));
    label->setText(QApplication::translate("MainWindow", "Select Language", 0));
} // retranslateUi

QtLanguage.pro

Жоғарыда айтылғандай, біз жоба профилінде аударма файлының атын көрсетеміз.

#-------------------------------------------------
#
# Project created by QtCreator 2016-05-22T14:34:42
#
#-------------------------------------------------

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = QtLanguage
TEMPLATE = app


SOURCES += main.cpp\
        mainwindow.cpp

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui

TRANSLATIONS = QtLanguage_ru.ts

CODECFORSRC     = UTF-8

main.cpp

Бірақ бұл файлда біз ештеңені өзгертпейміз.

#include "mainwindow.h"
#include <QApplication>

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

    MainWindow w;
    w.show();

    return a.exec();
}

mainwindow.h

Негізгі қолданба терезесінің тақырып файлында QTranslator сыныбының нысанын жариялау керек және қолданба тілін өзгерту оқиғасын анықтайтын changeEvent(QEvent *event) әдісін қайта анықтау керек.

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QTranslator>
#include <QEvent>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

protected:
    // Метод получения событий в главном окне приложения
    // В нём будет производиться проверка события смены перевода приложения
    void changeEvent(QEvent * event) override;

private:
    Ui::MainWindow *ui;
    QTranslator qtLanguageTranslator;   // Выделяем перевод в отдельном поле, иначе ничего работать не будет
};

#endif // MAINWINDOW_H

mainwindow.cpp

Қолданбаның логикасы келесідей болады: аралас терезедегі элементті өзгерткен кезде қолданбаның аудармасы өзгереді.

Ескерту. qm кеңейтімі бар аударма файлын қолданбаның орындалатын файлының жанына қоюды және қажетті dll файлдарын жинауды ұмытпаңыз, әйтпесе ол жұмыс істемейді.

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QApplication>
#include <QTranslator>
#include <QLibraryInfo>
#include <QDebug>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // Задаём два пункта с текстом локалей в комбобоксе
    ui->comboBox->addItems(QStringList() << "ru_RU" << "en_US");

    // подключаем к сигналу изменения пункта комбобокса лямбда функцию,
    // в которой будет изменяться перевод приложения
    // Здесь имеется интересный момент. Поскольку QComboBox имеет перегрузку сигнатуры сигнала,
    // то нам необходимо скастовать сигнал к нужной сигнатуре.
    // В данном случае будем использовать название пункта при его изменении
    connect(ui->comboBox, static_cast<void (QComboBox::*)(const QString &)>(&QComboBox::currentIndexChanged),
            [=](const QString &str){
        qtLanguageTranslator.load("QtLanguage_" + str, ".");   // Загружаем перевод
        qApp->installTranslator(&qtLanguageTranslator);        // Устанавливаем перевод в приложение
    });

    // Сделаем первоначальную инициализацию перевода для окна прилоежния
    qtLanguageTranslator.load(QString("QtLanguage_") + QString("ru_RU"));
    qApp->installTranslator(&qtLanguageTranslator);
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::changeEvent(QEvent *event)
{
    // В случае получения события изменения языка приложения
    if (event->type() == QEvent::LanguageChange) {
        ui->retranslateUi(this);    // переведём окно заново
    }
}

Барлығы

Нәтижесінде сіз графикалық интерфейсте екі тілді қолданба аласыз.

QTranslator көмегімен үлгі қолданбаны жүктеп алу

Бейне оқулық