Added DEVELOPING.md with some helpful tips & reminders

This commit is contained in:
Andrew Kitchen 2019-11-01 16:00:26 -07:00
parent 6c32edc6ae
commit 53e7e24c5a

17
DEVELOPING.md Normal file
View file

@ -0,0 +1,17 @@
# Developer's notes
## Running and Debugging
In order to run KeyCastr in the debugger, the built product needs accessibility permissions just as the released app does. Upon first launching a new build in the debugger you may see a fatal error dialog -- if so, open System Preferences -> Privacy -> Accessibility (or Input Monitoring on macOS 10.15 and above), right click on KeyCastr.app under Built Products in the Xcode project navigator and select 'Show in Finder', and drag KeyCastr.app from the Build/Products folder into the Accessibility list. In Xcode, ctrl-cmd-R to run the same build again.
## Creating a Release
- Update app version metadata in `Info.plist` and `MainMenu.nib/keyedobjects.nib`
- Developer ID must be set up for code signing and notarization
- Archive the app and follow Apple's instructions for uploading a release to be notarized
- Upon receiving the success notification from Apple, export the notarized build from the project
- Verify exported artifact is notarized (w/ shell command)
- Update the zip file in the `bin/` folder to contain the new .app build
- Create a tag for this version, i.e. `git tag -am'Version <NEW_VERSION>' v<NEW_VERSION>`
- Push the commits and tags with `git push origin head && git push --tags`
- Update `https://keycastr.github.io/appcast.xml` with tools bundled with Sparkle
- Update brew-cask (a community member sometimes gets to it first :) )