aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/markdown/Creating-OSX-packages.md28
1 files changed, 25 insertions, 3 deletions
diff --git a/docs/markdown/Creating-OSX-packages.md b/docs/markdown/Creating-OSX-packages.md
index 849d5fd..dcae762 100644
--- a/docs/markdown/Creating-OSX-packages.md
+++ b/docs/markdown/Creating-OSX-packages.md
@@ -79,9 +79,13 @@ your `Info.plist`.
If you are not using any external libraries, this is all you need to
do. You now have a full app bundle in `/tmp/myapp.app` that you can
-use. Most applications use third party frameworks and libraries,
-though, so you need to add them to the bundle so it will work on other
-peoples' machines.
+use.
+
+### External libraries
+
+Most applications use third party frameworks and libraries.
+If it is the case for your project, you need to add them to
+the bundle so it will work on other peoples' machines.
As an example we are going to use the [SDL2](https://libsdl.org/)
framework. In order to bundle it in our app, we first specify an
@@ -125,6 +129,24 @@ though.
After this you have a fully working, self-contained OSX app bundle
ready for distribution.
+#### Qt
+
+Qt offers a [deployment tool](https://doc.qt.io/qt-5/macos-deployment.html#macdeploy),
+called `macdeployqt`, that automatizes bundling Qt's libraries in your application folder and
+optionally create the final `.dmg` installer
+
+```console
+# cd into the folder that contains the `myapp.app` folder
+macdeployqt myapp.app -executable=myapp.app/Contents/MacOS/myapp
+```
+
+This copies the needed Qt libaries to the correct subfolders within `myapp.app`.
+The `-executable=myapp.app/Contents/MacOS/myapp` argument is
+to automatically alter the search path of the executable
+`myapp.app/Contents/MacOS/myapp` for the Qt libraries. One can also pass the `-dmg`
+argument to create a `.dmg` installer from the updated `myapp.app` folder.
+More information is available on the tool's documentation page.
+
## Creating a .dmg installer
A .dmg installer is similarly quite simple, at its core it is