Build and Package: Macintosh

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

Macintosh Building & Packaging

• Open a terminal (command-line)
• Navigate to the project
  • $ cd ~/PythonProjects/BlocklyPropClient
• Check out the needed branch from the BlocklyPropClient repository
  • $ git checkout {branch}
• Activate the Virtual Python environment for BlocklyPropClient
  • $ source VPython/bin/activate
• Build BlocklyPropClient
  • (VPython)$ PyInstaller BlocklyPropClient.macos.spec
    • This builds and stores the application bundle in the ./dist subfolder as BlocklyPropClient.app
      • See Mac App Bundle Structure details
    • See BlocklyPropClient.macos.spec Details for more information
• Sign and Package BlocklyPropClient (requires signing certificate in Mac's KeyChain)
  • Navigate to the package folder
    • cd package
  • Run the mac_sign_and_package script giving the proper version number and deploy option
    • To include the FTDI USB Drivers inside the installer:
      • $ ./mac_app_sign_and_package.sh -a "BlocklyPropClient" -v 0.5.1 -r -f -d
    • To exclude the FTDI USB Drivers from the installer:
      • $ ./mac_app_sign_and_package.sh -a "BlocklyPropClient" -v 0.5.1 -d
  • The installer package will be written to the ../dist subfolder as BlocklyPropClient-setup-MacOS.pkg
• Deactivate the Virtual Environment...
  • (VPython)$ deactivate
    • The "(VPython)" prefix will now disappear from your command-line