Skip to content

Latest commit

 

History

History
97 lines (76 loc) · 2.36 KB

BUILDING.md

File metadata and controls

97 lines (76 loc) · 2.36 KB
Raw

This is still being worked on (as of January 29, 2024).

Windows

Standalone build

This expects Python 3.8 32-bit to be installed.

Install the dependencies:

py -3.8-32 -m pip install --user --upgrade "cx-Freeze>=6.15,<6.16" -r requirements.txt

Build the exe:

scripts\make-exe-win.bat

Build the standalone zip:

scripts\make-zip-win.bat

Build the NSIS installer (by default this depends on it being installed to C:\Program Files (x86)\NSIS):

scripts\make-inst-win.bat

Wheel and source dist build

  • py -3 setup.py bdist_wheel - build multi-platform py3 wheel
  • py -3 setup.py sdist - build source distribution

macOS

This needs Python built with universal2 to produce a build with a working GUI. A universal2 build will be made.

Set up a venv, activate it, and install the requirements:

python3.11 -m venv venv311
source venv311/bin/activate
pip install --upgrade pyinstaller certifi -r requirements.txt

Build the icns:

./scripts/make-icons.sh

Build the app:

pyinstaller standalone.spec

Distributing for release

Mostly for my reference, but in case you want to try and reproduce a build. If you are not signing and notarizing the app (which requires giving Apple $99 for a yearly developer program membership), you can just build the dmg and ignore the rest.

DMG only

./scripts/make-dmg-mac.sh

Sign and notarize

Most of this was taken from this gist: https://gist.github.com/txoof/0636835d3cc65245c6288b2374799c43

Sign the app:

codesign \
    --force \
    --deep \
    --options runtime \
    --entitlements ./resources/mac-entitlements.plist \
    --sign "<signature-id>" \
    --timestamp \
    ./dist/ninfs.app

--timestamp is not necessarily required (and could probably be removed for test builds), but it is if you are notarizing the app.

Build the dmg:

./scripts/make-dmg-mac.sh

Upload for notarization:

xcrun notarytool submit ./dist/ninfs-<version>-macos.dmg --keychain-profile "AC_PASSWORD" --wait

Staple the ticket to the dmg:

xcrun stapler staple ./dist/ninfs-<version>-macos.dmg

todo:

  • Use pyinstaller for Windows in the same spec file (trying to do this with nsis might suck)

Wheel and source dist build

  • python3 setup.py bdist_wheel - build multi-platform py3 wheel
  • python3 setup.py sdist - build source distribution