QGIS standalone package

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

For package details, see details page To know when we release, see QGIS release schedule or use google calendar with roadmap

How to report issues

Add link to the installed package
Add crash report if QGIS crashed
State MacOS version (e.g. 10.14.1)
Run open /Applications/QGIS.app 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>

Server Setup

Get Mojave server
Get Apple Development Program for your Apple ID
Login to the server (have static IP)
Change default password to some secure one
Install XCode from App Store
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
Update ~/.bash_profile from scrips/bash_profile
now clone this repository
to upload to Dropbox
1. Create App with a folder to upload a files, get a token
2. Create File ~/Projects/dropbox_token.txt and paste the token inside
copy run_cronjob one folder above
to Code Signing
- 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.
- security find-identity -v to find existing identities
- create sing_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
so your folders structure is

  dropbox_token.txt
  sign_identity.txt
  qgis.keychain.db --> ~/Library/Keychains/login.keychain-db
  run_cronjob.bash
  qgis-mac-packager/
  builds/
  logs/

Run run_*.bash to build nightly/ltr/pr releases
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 
launchctl load ~/Library/LaunchAgents/org.qgis.build.plist

NOTE: grep for "lutra", since this username is hardcoded in few places around

Server Update

remove all build folders
remove homebrew (/usr/local/*)
reinstall homebrew packages
update docs/README.md with new set of used libs

How to release new versions

remove all build folders
update TAG in scripts/run_ltr.bash, scripts/run_pr.bash
wait till next nightly build to build the package
check docs/README.md if there are some references to old/new version to update

phborba / qgis-mac-packager