Skip to main content

Mac Guide (Desktop App)

Development build

To create a development build,

  1. Follow the quickstart guide to create a new app with the app builder and install all the dependencies
  2. Run npm start in the project root. This will launch the CLI
  3. Select Build in the main menu
    Linux_Build
  4. Select Mac in the platforms menu
    Mac_Platform
  5. Select Development in the build menu
    Linux_Type_Development
  6. This will launch the development edition of the Mac application on your system

Production build

To create a production build,

  1. Follow the quickstart guide to create a new app with the app builder and install all the dependencies

  2. Run npm start in the project root. This will launch the CLI

  3. Select Build in the main menu

    Linux_Build
  4. Select Mac in the platforms menu

    Mac_Platform
  5. Select Production in the build menu

    Linux_Type_Production
  6. This will build the production edition of the Mac application on your system

  7. The binary will be located at agora-app-builder/<PRODUCT_ID>/out

Production build with code signing

To create a production build with code signing,

  1. Register for an Apple developer account if you don't have one yet.

  2. Generate an application specific password from Apple ID account page (Read : https://support.apple.com/en-gb/HT204397)

    SignMac1
    SignMac2
    SignMac3
  3. Open a terminal and execute the following command :

security add-generic-password -a "APPLE ID HERE" -w "APP SPECIFIC PASSWORD HERE" -s "AC_PASSWORD"

(Replace APPLE ID HERE and APP SPECIFIC PASSWORD HERE with your Apple ID and app-specific password generated above.

note

AC_PASSWORD is a static identifier and should NOT be replaced)

  1. Open XCode > preferences

  2. Open accounts tab

  3. Sign in to XCode with the developer account if not done already

  4. Click manage certificates

    SignMac3
  5. Create a new certificate of the type “Developer ID Application”

    SignMac3
  6. Execute the following command in a terminal and copy the correct hash corresponding to “Developer ID Application” into your clipboard

security find-identity -v -p codesigning
  1. Execute the following command in a terminal:
export CSC_NAME="Your copied certificate hash"
  1. Continue building for production by following the above guide