QT資原始檔

轉自：http://blog.sina.com.cn/s/blog_458983150100ndbr.html

Qt資源體系採用平臺獨立機制來儲存應用程式執行時的二進位制檔案。這種機制在應用程式需要一些確定的檔案(圖示、翻譯檔案等等)而且又不想冒丟失檔案的風險時是有用的。

資源體系依賴於 qmake, rcc (Qt's resource compiler), 和 QFile 的緊密協作。Qt 3 的 qembed 工具和 image collection 機制被廢除。

Resource Collection Files (.qrc)
與應用程式關聯的應用程式由 .qrc 檔案來指定，它用XML記錄硬碟上的檔案和對應的隨意指定的資源名稱，應用程式通過資源名稱來訪問資源。

一個.qrc 檔案的例子：

<!DOCTYPE RCC><RCC version="1.0">
<qresource>
     <file>images/copy.png</file>
     <file>images/cut.png</file>
     <file>images/new.png</file>
     <file>images/open.png</file>
     <file>images/paste.png</file>
     <file>images/save.png</file>
</qresource>
</RCC>
.qrc 檔案中列出的資原始檔是程式的原始碼樹的一部分。指定的路徑是 .qrc 檔案所在目錄的相對路徑。注意，列出的資原始檔必須位於 .qrc 檔案所在目錄或者其子目錄下。

資源資料也能被編譯進二進位制檔案中，因此應用程式程式碼可以立即訪問；也可以建立一個二進位制資源，稍後在程式中登記了資源體系的程式碼中指定。

預設時，程式可以用資源在原始碼樹中的名稱加一個 :/ 字首來訪問它。例如，在程式的原始碼樹中是 images/cut.png 的檔案可以通過 :/images/cut.png 來訪問。但也可以用 file 標籤中的 alias 屬性來指定：

<file alias="cut-img.png">images/cut.png</file>
這時該檔案可以通過 :/cut-img.png 來訪問。也可以在 .qrc 檔案中用 qresource 標籤的 prefix 屬性：它可以為 .qrc 檔案中所有檔案指定一個字首：

<qresource prefix="/myresources">
     <file alias="cut-img.png">images/cut.png</file>
</qresource>
這時該檔案可以用 :/myresources/cut-img.png 訪問。

有些資源，像翻譯檔案和圖示，需要隨著使用者的本地配置而變化。這可以在 qresource 標籤的 lang 屬性中指定一個合適的本地化字串來實現。例如：

<qresource>
     <file>cut.jpg</file>
</qresource>
<qresource lang="fr">
     <file alias="cut.jpg">cut_fr.jpg</file>
</qresource>
如果使用者的本地化設定是 French (也就是說，QLocale::system().name() returns "fr_FR")，:/cut.jpg 就會引用 cut_fr.jpg 影象。對於其他本地化設定，仍然用 cut.jpg 。

本地化字串的使用格式參見 QLocale 文件。

使用外部二進位制資源
為建立一個外部二進位制資源，需要通過向 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 或者在你的編譯系統中新增建立規則。

通常，Qt直接將資料儲存在可執行檔案中，甚至在Windows和Mac OS X這些提供資源本地支援的作業系統中也是這樣。這可能會在未來的Qt版本中改變。

Using Resources in the Application

應用程式中，絕大多數地方都可以用資源路徑代替原始檔案系統路徑。尤其是在 QIcon, QImage, or QPixmap 構造器中可以傳遞資源路徑來代替檔名稱：

     cutAct = new QAction(QIcon(":/images/cut.png"), tr("Cu&t"), this);

在記憶體中，資源被用資源物件樹來描述。該樹在啟動時自動構建並用QFile來解析資源路徑。可以用":/" 初始化的 QDir 來從資源樹的根部開始瀏覽。

Qt資源支援搜尋路徑列表概念。若用 ":"代替":/"做字首來引用一個資源，資源將被用搜尋路徑列表查詢。啟動時搜尋路徑列表是空的，呼叫 QDir::addResourceSearchPath() 可以新增路徑。

If you have resources in a static library，必須用.qrc 檔案的base name作引數呼叫 Q_INIT_RESOURCE() 來強制初始化資源。例如：

     int main(int argc, char *argv[])
     {
         QApplication app(argc, argv);
         Q_INIT_RESOURCE(graphlib);
         ...
         return app.exec();
     }
同樣地，若你需要顯式解除安裝一個資源集(因外掛被解除安裝或資源失效)，需要用與前面相同的base name為引數呼叫Q_CLEANUP_RESOURCE() 來強制移除資源。