Build and Package: Mac

These steps need to be performed on a pre-configured development system every time a new installation package is desired.

Mac Packaging

• Checkout the desired BlocklyProp Launcher version
  • Open a command window
  • Check out the needed branch from the BlocklyPropLauncher repository
    • in Git command line:
      • $ cd /Users/{username}/{folder}/BlocklyProp_Launcher
      • $ git checkout origin {branch}
  • NOTE: The source can be run from here- no build process needed; however, follow extra steps below to package for Mac
• Make Release
  • Run the build script from within the repository directory:
    • $ ./MakeRelease
      • This builds and stores the application files in the ./release subfolder
• Copy release to app bundle
  • Copy the contents of the ./release folder (the contents, not the folder) into the nwjs app bundle's Contents/Resources/app.nw subfolder
    • This can be achieved in Finder by...
      • navigating to the ./dist subfolder,
      • finding the BlocklyPropLauncher app,
      • right-click > Show Package Contents,
      • then navigate to Contents/Resources/app.nw subfolder and paste
• Touch up BlocklyPropLauncher app product version
  • Open nwjs app bundle's Contents/Info.plist file with XCode and set the "Bundle versions string, short" value to the proper Major, Minor, and Release number
    • NOTE: At the time of this writing, the mac_app_sign_and_package script below says it's setting the version, but it fails to actually do so
• Sign and Package BlocklyProp Launcher
  • $ cd ./package
  • $ ./mac_app_sign_and_package.sh -a "BlocklyPropLauncher" -v #.#.# -d ;where #.#.# is the proper application version number
  • (OPTIONAL) $ ./mac_app_verify_signatures.sh -a "BlocklyPropLauncher"
  • Notarize BlocklyProp Launcher package; so Mac Gatekeeper (on macOS Catalina (10.15) and above) allows proper execution
    • $ ./mac_app_notarize.sh -a "BlocklyPropLauncher" -v #.#.# -d {apple_developer_email_address} ;where #.#.# is the proper application version number
      • NOTES:
        1. Use the App Notarization password (from the Apple Developer account in our password database)
        2. After entering password, the CLI will appear frozen for a couple minutes; it's okay, it's uploading the package to Apple's notary service
        3. If no errors are reported, wait for notarization email (which may be a few minutes)
           • It comes to the Apple Developer account email
    • If notarization arrives and was successful...
      • $ ./mac_app_staple.sh -a "BlocklyPropLauncher" -v #.#.# ;where #.#.# is the proper application version number
        • NOTE: It may complain near the end of the response output that "We do not know how to deal with trailer version..." but this issue doesn't seem to be fatal as it later reports "The staple and validate action worked!"
  • Rename installer
    • $ package % mv ../dist/BlocklyPropLauncher-#.#.#-setup-MacOS.pkg ../dist/Setup-BPLauncher-#.#.#-MacOS.pkg