Qt的资源管理系统

QT的资源管理系统是一套在应用执行时存储二进制文件的,无平台依赖的机制。这在你的应用总是需要一系列文件(图标、翻译文件等),你有不想丢失这些文件时是有用的。

QT的资源管理系统基于qmake、rcc(Qt's resource compiler)和QFile的紧密合作。


Resource Collection Files (.qrc)

与应用程序关联的资源由 .qrc 文件来指定,它是一个基于XML基础的文件格式的文件,记录了硬盘上的文件,并且可以随意分配一个应用程序中去获取资源必须使用的资源名称。

一下是一个.qrc 文件的例子:

 

images/copy.png
images/cut.png
images/new.png
images/open.png
images/paste.png
images/save.png

 .qrc 文件中列出的资源文件是程序的资源树的一部分。指定的路径是 .qrc 文件所在目录的相对路径。注意,列出的资源文件必须位于 .qrc 文件所在目录或者其子目录下。

资源数据既可以被编译成可执行的二进制文件中,在应用程序代码可以立即访问;也可以创建一个二进制资源,稍后在程序中通过资源资源系统注册使用。

默认情况下,程序可以用资源在资源树中的名称加一个 :/ 前缀或者通过URL格式来访问它。例如,在程序的源码树中是 images/cut.png 的文件可以通过 :/images/cut.png 或者URLqrc:///images/cut.png来访问。但也可以用 file 标签中的 alias 属性来指定:

 images/cut.png

这时该文件可以通过 :/cut-img.png 来访问。也可以在 .qrc 文件中用 qresource 标签的 prefix 属性:它可以为 .qrc 文件中所有文件指定一个前缀:

 
	images/cut.png

images这时该文件可以用 :/myresources/cut-img.png 访问。

有些资源,像翻译文件和图标,需要随着用户的本地配置而变化。这可以在 qresource 标签的 lang 属性中指定一个合适的本地化字串来实现。例如:


	cut.jpg


	cut_fr.jpg

如果用户的本地化设置是 French (也就是说QLocale::system().name() returns "fr_FR"),:/cut.jpg 就会引用 cut_fr.jpg 图像。对于其他本地化设置,仍然用 cut.jpg 。

External Binary Resources

为创建一个外部二进制资源,需要通过向 rcc 传递 -binary 开关来生成资源数据(一般是.rcc扩展名)。然后可以用 QResource API 来注册资源。

例如,一个 .qrc 文件指定的资源数据集可以用下面方法编译:

 rcc -binary myresource.qrc -o myresource.rcc

应用程序中,用下面的代码注册资源:

 QResource::registerResource("/path/to/myresource.rcc"); 

Compiled-In Resources

必须在应用程序的 .pro 文件中指定.qrc 文件, qmake 才能知道并将资源编译进二进制文件。例如:

 RESOURCES     = application.qrc

qmake 将产生make规则来生成一个叫做 qrc_application.cpp 的文件并把它链接到应用程序中。该文件中,图像和其他资源的所有数据被以压缩二进制数据存进静态C++数组中。 .qrc 文件被改变或者它引用的文件中的某一个被改变时, qrc_application.cpp 自动重新生成。若你没有使用 .pro 文件,你也可以手动调用 rcc 或者在你的编译系统中添加创建规则。

压缩

资源文件默认采用zip的压缩格式。根据需求,用户也可以将压缩关掉。如下:

rcc -no-compress myresources.qrc
rcc -compress 2 -threshold 3 myresources.qrc
在应用中使用资源

在应用程序中,大多数时候,资源路径可以代替普通文件系统路径。特别是,你可以将传递一个资源路径给QIcon、QImage或者QPixmap的构造函数而不是文件的名称:

cutAct = new QAction(QIcon(":/images/cut.png"), tr("Cu&t"), this);
在内存中,资源由资源对象树来表示。资源树在一开始就自动创建,并且通过QFile来解析资源路径。你可以初始化一个“:/”的路径去从资源树的根节点去检索。

Qt的资源系统支持搜索路径列表的概念。如果你使用“:”代替“:/”作为前缀,系统就会使用资源路径列表查找资源。检索路径列表在开始的时候是空的,用户可以调用QDir::addSearchPath()去添加路径。
在库中使用资源
如果你的资源文件在一个库文件中,你就需要调用Q_INIT_RESOURCE()宏和.qrc文件的名字来初始化资源。如下:

MyClass::MyClass() : BaseClass()
  {
      Q_INIT_RESOURCE(resources);

      QFile file(":/myfile.dat");
      ...
  }






你可能感兴趣的:(Qt,qt,资源管理,qrc,rcc)