Feature: Document the current MacOS build/release process (formally)

[mpogue2]

Mac OS X Build/Release process is changing for now to make it work better on Catalina, and it uses a commercial tool, until I can better automate it with open source tools. Right now, doing a release will depend on DMGCanvas3 ($20).

Release Steps:

• change build number (now x.y.z only) in .h file, and in .plist file (x.y.z.n must increment n), and in PackageIt.command file
• run qmake
• Clean all
• Build all
• Test (be sure to test SD by going into the SD tab and speaking. Should work now on Catalina.) Note that to test mic access permissions, you'll need a new version number in the plist file, and then you must start SquareDesk, go to SD tab, and disable/enable mic. It should ask for permission (you should grant it).
• Run PackageIt.command. Ignore the .DMG file that PackageIt.command makes (for now -- we might bring this back later)
• run ./codesign.sh (from here: https://github.com/brossi/qt-codesigner And, be sure to setup env_vars.sh first, using your Developer ID from Apple, $99/year, you'll want to use an ID that can be used to sign apps distributed OUTSIDE the App Store. That ID needs to be download as a .cer file, and double-clicked to add to the Keychain.). My version is in: /Users/mpogue/clean3/qt-codesigner-master (This script signs everything in the .app file found in Install, and sticks it into Install/Signed)
• Run DMGCanvas3 (I'll check this in shortly, if it doesn't contain my actual code signing DevID) which takes the Install/Signed .app version, makes a nice DMG file, signs the DMG file (the .app is already signed inside the DMG file because of ./codesign.sh step above), and uploads for notarization to Apple. You'll need a 3P password, so that DMGCanvas3 can upload stuff to Apple (that pass word is made inside the Apple developer website, and cut/pasted into DMGCanvas3). The file to use is test_0.9.4.dmgCanvas (or similar), on my system in ~/clean3. Be sure to change the version number in the Background before clicking Build.
• Apple sends email when it's done (usually about 5 minutes).
• DMG is now signed and notarized, and APP is signed. (I'm not sure whether I have to notarize the app, or how to do it. Right now, the app is also not using the hardened runtime -- maybe later.). Incidentally, AppWrapper will also make a DMG or PKG, but will also process to turn on the hardened runtime and App Sandbox, and to prepare for the App Store.
• Re-test. When SD tab is opened, it should ask for microphone access (click OK). Say some things to SD (should work now on Catalina).
• Output DMG is in /clean3 on my machine.

[mpogue2]

I think there's a bug, where if a change is made to the checked-in .plist file, it doesn't overwrite the copy in the Install directory. Deleting that .plist file before building will properly copy it over. This can be fixed with some hand-coded delete and copy operations in the .pro file (when I get around to it).

POSTSCRIPT NOTE: I changed PackageIt.command to do this copy.

[mpogue2]

Useful tools for checking code signing and notarization, etc: https://eclecticlight.co/downloads/