PACKAGE_MACOS.md

How to package ASGARDEX on macOS

Following ENV's have to be defined:

SIGNING_APPLE_ID # username of your Apple Developer account

SIGNING_APP_PASSWORD # password of your Apple Developer account

MAC_CERTIFICATE # The HTTPS link (or base64-encoded data, or file:// link, or local path) to certificate (*.p12 or *.pfx file). Shorthand ~/ is supported (home directory).

MAC_CERTIFICATE_PASSWORD # The password to decrypt the certificate given in CSC_LINK.

To package on GitHub, all ENV's ^ have to be set as "Secrets" to GitHub: Repository -> Settings -> Secrets

To package ASGARDEX on your machine locally, you have to provide these ENV locally only.

Some extra information

• SIGNING_APPLE_ID and SIGNING_APP_PASSWORD are needed for notarizing macOS builds using electron-notarize.

• MAC_CERTIFICATE and MAC_CERTIFICATE_PASSWORD are needed for code signing https://www.electron.build/code-signing

  • MAC_CERTIFICATE becomes CSC_LINK (The HTTPS link (or base64-encoded data, or file:// link, or local path) to certificate (_.p12 or _.pfx file). Shorthand ~/ is supported (home directory).)
  • MAC_CERTIFICATE_PASSWORD becomes `CSC_KEY_PASSWORD (The password to decrypt the certificate given in CSC_LINK.)

Links

• electron-notarize API: Method notarize(opts): Promise<void>
• electron-builder documentation: "Code Signing"