Qt/C++ оқу құралы 092. Сыртқы мәтін көздері үшін аудармаларды жасау

Qt 6, Qt, Qt 5, QtLinguist, translation

Бүгін біз Qt / C ++ қосымшасына аударма қосудың өте қызықты нұсқасын талқылаймыз. Атап айтқанда, дерекқорлардан, сыртқы API интерфейсінен немесе кейбір басқа файлдардан мәтіндерді көрсеткенде сыртқы көздерден мәтіндер үшін аудармаларды қосу.

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

Бірақ Qt-де бұл мәселені де шешуге болады. Мұндай жағдайларда сіз бастапқы код файлдарын дәл осылай жасай аласыз, мысалы, қолданбаны әзірлеу кезінде деректерді импорттау кезінде оларды генерациялай аласыз, содан кейін QtLinguist тілінде қолданылатын *.ts кеңейтімі бар аударма файлдарын жасай аласыз. қолданбаны Qt тіліне аудару үшін, содан кейін қолданбаға қосылатын екілік *.qm аударма файлдарын жасау.

Оның қалай жұмыс істейтінін және бұл үшін не істеу керектігін көрейік.

Бастапқы файлдарды қосу

lupdate қолданбасы *.ts файлдарын жасай алуы үшін жобада тақырып және бастапқы файлдар болуы керек. Бірақ оларды құрастырудың қажеті жоқ. Жобада компиляцияланбаған файлдар бар, бірақ оларсыз *.ts файлдарын жасау мүмкін болмайтын қызықты трюк шықты.

pro файлы

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

TRANSLATIONS = myapp_en.ts \
               myapp_cs.ts \
               myapp_de.ts \
               myapp_es.ts

SOURCES += \
    translations_generated.cpp

HEADERS += \
    translations_generated.h

Көріп отырғаныңыздай, *.ts аударма файлдары, сондай-ақ translations_generated.h және translations_generated.cpp екі файлы бар.
Бұл файлдарды сіз қолмен жасайды немесе қосасыз, бұл маңызды емес, бұл файлдарды дәл қалай жасағаныңыз және қосқаныңыз маңызды емес.
Ең бастысы, бұл файлдардың сәйкес мазмұны бар.

аудармалар_генерацияланған.h

Сіз таң қаласыз, бірақ біз бұл файлды бос қалдырамыз.

аудармалар_генерацияланған.cpp

Міне, ең маңызды мазмұн.

#ifdef TRANSLATOR_GUARD

//
// Uncompiled file, only as source for lupdate.exe
//
namespace my
{
namespace translation
{
namespace example
{
Q_OBJECT
tr("Height");
tr("Total length");
tr("Length");
tr("Home");
} // namespace my
} // namespace translation
} // namespace example

#endif // TRANSLATOR_GUARD

Бұл файл туралы бірнеше маңызды нәрселерге назар аударыңыз:

• TRANSLATOR_GUARD – файлды құрастыруға жол бермейді, ол бізге қажет емес
• аттар кеңістігі – аттар кеңістігі аударма жасалатын контекст жасайды. Бұл жағдайда контекст "my::translation::example" болады.
• Q_OBJECT - бұл макрос lupdate компаниясына осы жерде аударманы шақыру функциялары болуы мүмкін екенін айтады, олардың көмегімен аударма файлы жасалады.

Аударма файлдарын lupdate бағдарламасымен жасағаннан кейін, сіз осы жолдарды QtLinguist тілінде аударып, қолданбаңызда дұрыс пайдалану үшін екілік аударма файлдарын құрастыра аласыз.

Аудармаларды пайдалану

Аударманы пайдалану нақты мәтінді жазбайсыз, бірақ QCoreApplication::translate аударма функциясына айнымалы мәнді және мәтінмәнді берумен ерекшеленеді.

Мысал класы арқылы оның қалай болатынын көрейік. Бұл сыныпта аударылатын жолды қамтитын айнымалы, сондай-ақ аударылған мәнді қайтару әдісі бар.

#include <QCoreApplication>
#include <QString>

class ExampleTranslator
{
public:
    QString getTranslatedName() const
    {
        return QCoreApplication::translate("my::translation::example", m_name.toUtf8());
    }

private:
    QString m_name;
}

Дұрыс шақырылған мәтінмәні бар QCoreApplication::translate әдісі өткен мәтіннің аудармасын табуға тырысады және сәтті болса, қолданбадағы белсенді тіл үшін аударылған мәнді қайтарады.

Қорытынды

Осылайша, стандартты Qt құралдарын пайдалана отырып, кез келген сыртқы мәтіндердің аудармасын орындауға болады.