Announcing Packer 📦 for NodeGUI and React NodeGUI 🎉
Packer is a npm module that allows you to package apps built with NodeGUI or React NodeGUI into a standalone executable. Packer works on Mac, Windows and Linux
https://github.com/nodegui/packer
This is an initial MVP release of the module.
- On MacOS — Packer will output a dmg file
- On Linux — Packer will output an AppImage which is something similar to a .app file in MacOS
- On Windows — Packer outputs a folder containing the executable and all the dlls.
Currently if you need to produce a build you need to run the packer in different OS environments. That is, cross platform builds are not supported in this release.
Usage
- First step is to install the packer as a dev dependency. You can do so by:
npm install --save-dev @nodegui/packer- Next you can run the init command:This will produce the deploy directory containing the template. You can modify this to suite your needs. Like add icons, change the name, description and add other native features or dependencies. Make sure you commit this directory.
npx nodegui-packer --init MyApp- Next you can run the pack command:This command essential takes the dist folder as the input and puts it in the suitable location inside the standalone executable. Also it runs the correct deployment tool (macdeployqt incase of mac, etc) and packs in the dependencies.The output of the command is found under the build directory. You should gitignore the build directory.
npx nodegui-packer --pack <path to dist>How does it work ?
Packer uses Qt’s packaging tools in all three platforms.
- On Mac — it uses macdeployqt : https://doc.qt.io/qt-5.9/osx-deployment.html#macdeploy
- On Windows — it uses windeployqt : https://doc.qt.io/qt-5/windows-deployment.html
- On Linux — There is no official tool, hence it uses linuxdeployqt — https://github.com/probonopd/linuxdeployqt
Requirements
- Needs Qode v1.0.4 and up (NodeGUI v0.1.7 and up)
Future enhancements:
1. Cross platform builds.
2. Better documentation.
3. Reduce / Remove unnecessary dynamic libraries.
4. Reduce qode binary size.
Please feel free to help out with this in anyway you can.
