View source for Resource files in OS X bundle

[[Category:HowTo]]

= How to add resource files to an OS X application bundle =

On OS X, applications are delivered as so called "bundles". That's just a directory with a predefined structure and the suffix .app. You can learn more about the structure in the [http://doc.qt.io/qt-5/osx-deployment.html OS X specific deployment instructions] of the Qt documentation and in [http://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html#//apple_ref/doc/uid/10000123i-CH101-SW13 Apple's own docs about application bundles].

If you have additional files that need to be distributed along your application that cannot be put into the [http://doc.qt.io/qt-5/resources.html qrc resources] (eg. QML files), they have to be installed in the right place. For resource files this is YourFancyApplication.app/Contents/Resources.

You can let qmake do all the copy work for you. Just add a snippet like this to your .pro file:

<code>
APP_QML_FILES.files = path/to/file1.qml path/to/file2.qml
APP_QML_FILES.path = Contents/Resources
QMAKE_BUNDLE_DATA += APP_QML_FILES
</code>