QtResources/bg: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
m (Wieland moved page QtResources Bulgarian to QtResources/bg: Bulgarian)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Български''' [[QtResources|English]] [[QtResources SimplifiedChinese|简体中文]]<br />[[Category:QtInternals]]
{{Cleanup | reason=Auto-imported from ExpressionEngine.}}
 
'''Български''' [[QtResources|English]] [[QtResources SimplifiedChinese|简体中文]]
[[Category:QtInternals]]


[toc align_right="yes" depth="1"]


Написано от : Girish Ramakrishnan, ForwardBias Technologies
Написано от : Girish Ramakrishnan, ForwardBias Technologies
Line 7: Line 9:
= Общ преглед =
= Общ преглед =


''Qt Resources'' предоставя платформено независим механизъм за вкарване на произволни бинарни данни, включително изображения и звуци, като част от изпълнимият файл на приложението. Вижте "документацията на ресурсите":http://doc.qt.nokia.com/snapshot/resources.html за по-подробна информация.
''Qt Resources'' предоставя платформено независим механизъм за вкарване на произволни бинарни данни, включително изображения и звуци, като част от изпълнимият файл на приложението. Вижте [http://doc.qt.nokia.com/snapshot/resources.html документацията на ресурсите] за по-подробна информация.


По отношение на имплементацията, ресурсите в Qt нямат нищо общо с "RES файловете":http://msdn.microsoft.com/en-us/library/ms648007.aspx на Windows или "resource forks":http://en.wikipedia.org/wiki/Resource_fork on Mac OS X.
По отношение на имплементацията, ресурсите в Qt нямат нищо общо с [http://msdn.microsoft.com/en-us/library/ms648007.aspx RES файловете] на Windows или [http://en.wikipedia.org/wiki/Resource_fork resource forks] on Mac OS X.


= Как работи =
= Как работи =


Ресурсните файлове (i.e .qrc files) са XML-и, които описват кои файлове трябва да се пакетират в крайният бинарен файл. Ресурсният компилатор ''rcc'' обхожда XML-а и генерира C/C++ код. Този генериран код съдържа C структура, която съдържа суровите данни на файловете, който се намират в .qrc. След това тези C-структури се събират в друга C-структура, за да формират дървовидна структура, така че файловете да могат да се наредят в йерархии. Детайлите за тази структура сами по себе си не са много интересни, за това и не са описани тук. С опцията -''compressed'' на rcc, данните в структурите се компресират със zlib (по подразбиране, компресирането е изключено).
Ресурсните файлове (i.e .qrc files) са XML-и, които описват кои файлове трябва да се пакетират в крайният бинарен файл. Ресурсният компилатор ''rcc'' обхожда XML-а и генерира C/C++ код. Този генериран код съдържа C структура, която съдържа суровите данни на файловете, който се намират в .qrc. След това тези C-структури се събират в друга C-структура, за да формират дървовидна структура, така че файловете да могат да се наредят в йерархии. Детайлите за тази структура сами по себе си не са много интересни, за това и не са описани тук. С опцията -''compressed'' на rcc, данните в структурите се компресират със zlib (по подразбиране, компресирането е изключено).
<br />C-структурите трябва да се регистрират в Qt, за да може то да знае за тях. Номера е, че в края на всеки генериран от rcc C++ файл, rcc слага извикване на qRegisterResourceData(), което регистрира C структурата в системата за ресурси на Qt. Чрез използването на ''подхода за конструктурна функция'', qRegisterResourceData() се извиква преди main(). ''Подхода за конструктурната функция'' е използването на глобална статична променлива, която се инициализира като се извиква функция.<br /><code><br />#ifndef Q_CONSTRUCTOR_FUNCTION<br /># define Q_CONSTRUCTOR_FUNCTION0(AFUNC)  static const int AFUNC ## ''init_variable'' = AFUNC ();
 
# define Q_CONSTRUCTOR_FUNCTION(AFUNC) Q_CONSTRUCTOR_FUNCTION0(AFUNC)<br />#endif<br /></code>
C-структурите трябва да се регистрират в Qt, за да може то да знае за тях. Номера е, че в края на всеки генериран от rcc C++ файл, rcc слага извикване на qRegisterResourceData(), което регистрира C структурата в системата за ресурси на Qt. Чрез използването на ''подхода за конструктурна функция'', qRegisterResourceData() се извиква преди main(). ''Подхода за конструктурната функция'' е използването на глобална статична променлива, която се инициализира като се извиква функция.
<br />В края на генерирания от rcc C++ файл, съдържа нещо подобно на:<br /><code><br />int qInitResources_images()<br />{<br /> qRegisterResourceData(0x01, qt_resource_struct, qt_resource_name, qt_resource_data);<br /> return 1;<br />}
<code>
<br />Q_CONSTRUCTOR_FUNCTION(qInitResources_images)<br /></code>
#ifndef Q_CONSTRUCTOR_FUNCTION
<br />Тъй като статичните променливи се инициализират преди извикаването на main(), всички ресурси автоматично се регистрират преди същинската програма да стартира.
# define Q_CONSTRUCTOR_FUNCTION0(AFUNC)  static const int AFUNC ## ''init_variable'' = AFUNC ();
<br />h1. Q_INIT_RESOURCE
# define Q_CONSTRUCTOR_FUNCTION(AFUNC) Q_CONSTRUCTOR_FUNCTION0(AFUNC)
<br />Трикът с конструкторната функция работи само ако генерирания C++ файл е компилиран и вързан за приложението директно. Ако ресурсите се използват в статична библиотека и тя е свързана с приложението, конструкторната функция никога няма да се извика. Това е в природата на C/C++ свръзването- функциите и променливите в библиотеките, които не се използват/извикват от крайната програма се премахват от крайният бинарен код ( оптимизират се). Ако ресурсите са в споделена библиотека, тогава конструкторната функция се извиква. Обаче, повечето платформи зареждат споделените библиотеки при нужда и конструктурната функция се извиква само когато библиотеката се зарежда. Последствието от това е, че всички ресурси в плъгини, които се използват в главната програма, няма да бъдат намерени от Qt, докато плъгина не бъде зареден - това не е проблем, ако ресурсиоте от споделената библиотека се изпозлват само в нея. Обърнете внимание на това, че достъпването на ресурси от споделената библиотека в главното приложение не предизвиква зареждането и, тъй като никакви символи не се експортират от QRC системата.
#endif
</code>
 
В края на генерирания от rcc C++ файл, съдържа нещо подобно на:
<code>
int qInitResources_images()
{
qRegisterResourceData(0x01, qt_resource_struct, qt_resource_name, qt_resource_data);
return 1;
}
 
Q_CONSTRUCTOR_FUNCTION(qInitResources_images)
</code>
 
Тъй като статичните променливи се инициализират преди извикаването на main(), всички ресурси автоматично се регистрират преди същинската програма да стартира.
 
= Q_INIT_RESOURCE =
Трикът с конструкторната функция работи само ако генерирания C++ файл е компилиран и вързан за приложението директно. Ако ресурсите се използват в статична библиотека и тя е свързана с приложението, конструкторната функция никога няма да се извика. Това е в природата на C/C++ свръзването- функциите и променливите в библиотеките, които не се използват/извикват от крайната програма се премахват от крайният бинарен код ( оптимизират се). Ако ресурсите са в споделена библиотека, тогава конструкторната функция се извиква. Обаче, повечето платформи зареждат споделените библиотеки при нужда и конструктурната функция се извиква само когато библиотеката се зарежда. Последствието от това е, че всички ресурси в плъгини, които се използват в главната програма, няма да бъдат намерени от Qt, докато плъгина не бъде зареден - това не е проблем, ако ресурсиоте от споделената библиотека се изпозлват само в нея. Обърнете внимание на това, че достъпването на ресурси от споделената библиотека в главното приложение не предизвиква зареждането и, тъй като никакви символи не се експортират от QRC системата.


Решението на този проблем е да се използва генерирана променлива( от AFUNC ## ''init_variable'' по-горе) или да се извика генерираната функция qInitResource_images(). Макросът Q_INIT_RESOURCE съществува с тази цел и се ''изисква, когато имате ресурси в статична или споделена библиотека''.
Решението на този проблем е да се използва генерирана променлива( от AFUNC ## ''init_variable'' по-горе) или да се извика генерираната функция qInitResource_images(). Макросът Q_INIT_RESOURCE съществува с тази цел и се ''изисква, когато имате ресурси в статична или споделена библиотека''.


<code><br />#define Q_INIT_RESOURCE_EXTERN(name)  extern int qInitResources_ ## name();<br /></code>
<code>
#define Q_INIT_RESOURCE_EXTERN(name)  extern int qInitResources_ ## name();
</code>


Макроса по-горе обикновено се слага в началото на main() за всеки qrc файл.
Макроса по-горе обикновено се слага в началото на main() за всеки qrc файл.
Line 30: Line 51:
= Достъпване на ресурси =
= Достъпване на ресурси =


QFile, QDir, QPixmap и т.н. могат да достъпват qrc файлове. Целият достъп до файлове в Qt минава през "QAbstractFileEngine":http://doc.trolltech.com/4.6/qabstractfileengine.html. QResource регистрира подклас на QAbstractFileSystemEngine при стартиране, който предоставя валидна система за достъп до файлове (през QAbstractFileEngine::create), когато името на файла започва с ":".
QFile, QDir, QPixmap и т.н. могат да достъпват qrc файлове. Целият достъп до файлове в Qt минава през [http://doc.trolltech.com/4.6/qabstractfileengine.html QAbstractFileEngine]. QResource регистрира подклас на QAbstractFileSystemEngine при стартиране, който предоставя валидна система за достъп до файлове (през QAbstractFileEngine::create), когато името на файла започва с ":".


= Именни пространства за ресурси =
= Именни пространства за ресурси =


Когато използвате ресурси в плъгини, ресурсните пътища трябва да бъдат именовани. Използването на името на плъгина за именоване на ресурсното пространство е добра техника. За пример, '':/plugin_name/resourcename''. Ако съществуващ път до ресурси е регистриран втори път с различни данни, той се игнорира и се запазва първия.
Когато използвате ресурси в плъгини, ресурсните пътища трябва да бъдат именовани. Използването на името на плъгина за именоване на ресурсното пространство е добра техника. За пример, '':/plugin_name/resourcename''. Ако съществуващ път до ресурси е регистриран втори път с различни данни, той се игнорира и се запазва първия.

Latest revision as of 18:10, 24 March 2016

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Български English 简体中文


Написано от : Girish Ramakrishnan, ForwardBias Technologies

Общ преглед

Qt Resources предоставя платформено независим механизъм за вкарване на произволни бинарни данни, включително изображения и звуци, като част от изпълнимият файл на приложението. Вижте документацията на ресурсите за по-подробна информация.

По отношение на имплементацията, ресурсите в Qt нямат нищо общо с RES файловете на Windows или resource forks on Mac OS X.

Как работи

Ресурсните файлове (i.e .qrc files) са XML-и, които описват кои файлове трябва да се пакетират в крайният бинарен файл. Ресурсният компилатор rcc обхожда XML-а и генерира C/C++ код. Този генериран код съдържа C структура, която съдържа суровите данни на файловете, който се намират в .qrc. След това тези C-структури се събират в друга C-структура, за да формират дървовидна структура, така че файловете да могат да се наредят в йерархии. Детайлите за тази структура сами по себе си не са много интересни, за това и не са описани тук. С опцията -compressed на rcc, данните в структурите се компресират със zlib (по подразбиране, компресирането е изключено).

C-структурите трябва да се регистрират в Qt, за да може то да знае за тях. Номера е, че в края на всеки генериран от rcc C++ файл, rcc слага извикване на qRegisterResourceData(), което регистрира C структурата в системата за ресурси на Qt. Чрез използването на подхода за конструктурна функция, qRegisterResourceData() се извиква преди main(). Подхода за конструктурната функция е използването на глобална статична променлива, която се инициализира като се извиква функция.

#ifndef Q_CONSTRUCTOR_FUNCTION
# define Q_CONSTRUCTOR_FUNCTION0(AFUNC)  static const int AFUNC ## ''init_variable'' = AFUNC ();
# define Q_CONSTRUCTOR_FUNCTION(AFUNC) Q_CONSTRUCTOR_FUNCTION0(AFUNC)
#endif

В края на генерирания от rcc C++ файл, съдържа нещо подобно на:

int qInitResources_images()
{
 qRegisterResourceData(0x01, qt_resource_struct, qt_resource_name, qt_resource_data);
 return 1;
}

Q_CONSTRUCTOR_FUNCTION(qInitResources_images)

Тъй като статичните променливи се инициализират преди извикаването на main(), всички ресурси автоматично се регистрират преди същинската програма да стартира.

Q_INIT_RESOURCE

Трикът с конструкторната функция работи само ако генерирания C++ файл е компилиран и вързан за приложението директно. Ако ресурсите се използват в статична библиотека и тя е свързана с приложението, конструкторната функция никога няма да се извика. Това е в природата на C/C++ свръзването- функциите и променливите в библиотеките, които не се използват/извикват от крайната програма се премахват от крайният бинарен код ( оптимизират се). Ако ресурсите са в споделена библиотека, тогава конструкторната функция се извиква. Обаче, повечето платформи зареждат споделените библиотеки при нужда и конструктурната функция се извиква само когато библиотеката се зарежда. Последствието от това е, че всички ресурси в плъгини, които се използват в главната програма, няма да бъдат намерени от Qt, докато плъгина не бъде зареден - това не е проблем, ако ресурсиоте от споделената библиотека се изпозлват само в нея. Обърнете внимание на това, че достъпването на ресурси от споделената библиотека в главното приложение не предизвиква зареждането и, тъй като никакви символи не се експортират от QRC системата.

Решението на този проблем е да се използва генерирана променлива( от AFUNC ## init_variable по-горе) или да се извика генерираната функция qInitResource_images(). Макросът Q_INIT_RESOURCE съществува с тази цел и се изисква, когато имате ресурси в статична или споделена библиотека.

#define Q_INIT_RESOURCE_EXTERN(name)  extern int qInitResources_ ## name();

Макроса по-горе обикновено се слага в началото на main() за всеки qrc файл.

Достъпване на ресурси

QFile, QDir, QPixmap и т.н. могат да достъпват qrc файлове. Целият достъп до файлове в Qt минава през QAbstractFileEngine. QResource регистрира подклас на QAbstractFileSystemEngine при стартиране, който предоставя валидна система за достъп до файлове (през QAbstractFileEngine::create), когато името на файла започва с ":".

Именни пространства за ресурси

Когато използвате ресурси в плъгини, ресурсните пътища трябва да бъдат именовани. Използването на името на плъгина за именоване на ресурсното пространство е добра техника. За пример, :/plugin_name/resourcename. Ако съществуващ път до ресурси е регистриран втори път с различни данни, той се игнорира и се запазва първия.