Skip to content

qgis/QGIS-Mac-Packager

PR Status

LTR Status

NIGHTLY Status

Latest Passed Builds

PR LTR Nightly
DMG DMG DMG
SHA256 SHA256 SHA256
DEPS DEPS DEPS

QGIS Mac Packager

Set of scripts to create MacOS standalone QGIS package (dmg)

To know when we release, see QGIS release schedule

How to report issues

  • Add link to the installed package
  • Add crash report if QGIS crashed
  • State MacOS version (e.g. 10.15.0), QGIS version
  • Run /Applications/QGIS*.app/Contents/MacOS/QGIS from Terminal and add the output
  • Append any messages from QGIS message log or python warnings log if present

Debugging Tips

  • gatekeeper: codesign --verbose --deep-verify /Applications/QGIS*.app/
  • loaded dylibs: ps -A | grep -i qgis; vmmap <pid>
  • signature: codesign -d -vvvv <file>
  • accept by gatekeeper: spctl -a -t exec -vv <path>.dmg
  • signature: codesign --verify --deep --strict --verbose=2
  • library deps (similar to Windows' Dependency Walker): https://github.com/kwin/macdependency
  • to debug Qt Plugins (e.g. SQL), use : QT_DEBUG_PLUGINS=1 open /Application/QGIS*.app
  • if QGIS crashes on start, try with clean profile mv ~/Library/Application\ Support/QGIS/QGIS3/profiles ~/Library/Application\ Support/QGIS/QGIS3/profiles_bk
  • if QGIS crashes after load, try use clean profile from the QGIS Menu
  • list symbols of dynlib: nm -gU <libname>

Server Setup

  • Get macOS Big Sur server

  • Get Apple Development Program for your Apple ID

  • Login to the server (have static IP)

  • Change default password to some secure one

  • Open Settings > Spotlight and disable all search locations & add /opt and ~/qgis to exclude locations

  • Install XCode from App Store (It is enough to JUST install command line tools!)

  • Go to Apple Developer Download page -> More and command line tools. Install both

  • Sign out from the apple developer page and app store

  • Open XCode and accept license

  • install homebrew and QGIS deps by running install_brew.bash

  • Download MrSID SDK referenced in and place it in the folder $HOME/Library/Caches/Homebrew. Make a symbolic link in ../external/MrSID_DSDK-<ver>-darwin14.universal.clang60

  • Download erdas-ecw-jp2 5.5.0 referenced in. Open dmg, open pkg and install to default location (Desktop Read-Only Free type). Make a symbolic link in ../external/ERDASEcwJpeg2000SDK<ver>

  • Download Oracle (18.1.0.0.0) package from Oracle Download Section. Only "Instant Client Package - Basic" and "Instant Client Package - SDK" are needed. Unpack/install to ../external/oracle

  • install homebrew packages by install_brew_dev_packages.bash

  • Update ~/.bash_profile from scrips/bash_profile

  • now clone this repository

  • for upload, add you ssh keys to qgis/ssh/ and secure them

  • copy run_cronjob one folder above

  • to Code Signing (you need Apple certificate to be "Identified developer")

    • You need application certificate from https://developer.apple.com/account
    • Generate production/development signing identify
    • Get cer file and scp to the server
    • Double click on cer file and install it on the server
    • On Machine where you created request, export private key and copy and install on server too.
    • install p12 cert to login identity
    • security find-identity -v to find existing identities
    • create sign_identity.txt with the ID of your identity
    • allow to use it in cronjob (https://stackoverflow.com/a/20324331/2838364)
    • create symbolic link to keychain with the imported identity
    • if used for signing the qgis-deps, you may need to "unlock" it in KeyChain Access App
  • so your folders structure is

  sign_identity.txt
  qgis.keychain.db --> ~/Library/Keychains/login.keychain-db
  run_cronjob.bash
  QGIS-Mac-Packager/
  external/ECW.. --> link to SDK
  external/MrSid.. --> link to SDK
  external/Oracle/sdk
  external/Oracle/instantclient
  builds/
  logs/
  ssh/
  • Run run_pkg.bash with nightly/ltr/pr to build releases/nightlies (detects the latest version)
  • Nightly releases should be set as launchd once per day (use tabs!)
cp scripts/org.qgis.build.plist ~/Library/LaunchAgents/
plutil ~/Library/LaunchAgents/org.qgis.build.plist 
echo $UID
launchctl bootstrap gui/503 ~/Library/LaunchAgents/org.qgis.build.plist
launchctl enable gui/503/org.qgis.build

If you want to kick the cron manually and see the errors try

launchctl kickstart gui/503/org.qgis.build
tail -n 200 -f /var/log/system.log | grep qgis
cat 

Server Update

  • remove all build folders
  • remove homebrew (/usr/local/*)
  • reinstall homebrew packages
  • clear ccache ccache -C