Installing Syncfusion® ASP.NET Core EJ2 Mac Installer

17 Jul 20265 minutes to read

The Essential Studio® ASP.NET Core EJ2 Mac installer allows you to create the ASP.NET Core EJ2 application in Visual Studio for Mac with the Syncfusion® ASP.NET Core EJ2 components.

Prerequisites

  • A macOS machine running macOS Catalina (10.15) or later. Earlier versions are not officially supported by the current Mac installer.
  • The downloaded Syncfusion® ASP.NET Core - EJ2 Mac installer (.dmg). See Downloading Syncfusion Mac installer.
  • Administrator access on your Mac so that you can copy the installer into the Applications folder.

Steps to Resolve the Warning Message in macOS Catalina or Later

While running Essential Studio® ASP.NET Core - EJ2 Mac Installer on macOS Catalina or later, the alert below may be displayed.

macOS Catalina Gatekeeper alert

If you receive this alert, follow the below steps for the easiest solution.

  1. Locate the downloaded .dmg file in Finder (typically in the Downloads folder).
  2. Right-click the .dmg file (do not double-click it).

  3. Select the Open With option and choose DiskImageMounter (Default). The following pop-up appears.

    Open with DiskImageMounter pop-up

  4. Click Open in the pop-up. The installer window opens.

If you continue to see a “cannot be opened because the developer cannot be verified” message, open System Settings → Privacy & Security, scroll to the bottom, and click Open Anyway next to the blocked installer entry. Then re-run the steps above.

Step-by-Step Installation

The steps below show how to install the Essential Studio® ASP.NET Core - EJ2 Mac installer.

  1. Locate the downloaded .dmg file in Finder and double-click it to mount the disk image.

    macOS installer welcome wizard

  2. macOS automatically mounts the disk image and creates a virtual drive on your desktop and in the Finder sidebar. If a license agreement appears, review it and click Agree to continue.

    License Agreement

  3. In the mounted disk window, select the Syncfusion® installer application and copy it (right-click → Copy, or press ⌘ + C).

    Copy the installer app from the mounted disk

  4. Open the Applications folder (from the Finder sidebar or by pressing ⌘ + Shift + A) and paste the installer there (right-click → Paste, or press ⌘ + V). Running the installer from Applications is required so that macOS Gatekeeper can verify it.

    Paste the installer into Applications

    NOTE

    The Unlock key is not required to install the Mac installer. The Syncfusion® Essential Studio® ASP.NET Core - EJ2 Mac installer can be used for development purposes without registering the Unlock key. A license key is only required later to run the bundled samples and demo source without a license-warning message.

  5. Open the Applications folder, then open the Syncfusion® Essential Studio® Mac installer to explore the included packages and samples.

    Syncfusion installer in Applications

  6. To clean up, right-click the virtual drive on your desktop or in the Finder sidebar and select Eject to unmount the disk image. You can also delete the installer from the Applications folder once you no longer need it.

    Eject the mounted disk image

License Key Registration in Samples

After installation, a license key is required to run the demo source included in the Mac installer without the Syncfusion® license-warning overlay. To learn about the steps for license registration for the ASP.NET Core - EJ2 Mac installer, refer to the following:

  • Register the license key in the Program.cs file if you created the ASP.NET Core web application with Visual Studio 2022 and .NET 6.0.
  • Register the license key in the Configure method of Startup.cs for .NET 5.0 or .NET 3.1 applications.

If the sample still shows a license warning after registration, verify that the license key is registered against the same Syncfusion® account that owns the active subscription, and restart the sample app so the new key is picked up.

Troubleshooting

Issue Possible Cause Suggested Fix
“App is damaged and can’t be opened” on macOS Catalina or later. Gatekeeper is blocking the unsigned installer. Use the right-click → Open With → DiskImageMounter (Default) flow described above, or allow the app in System Settings → Privacy & Security.
Installer does not launch after being copied to Applications. The installer was run from the mounted disk image only. Copy the installer into the Applications folder and run it from there.
Sample apps display a license-warning overlay. License key has not been registered for this project/account. Register the license key using one of the methods in License Key Registration in Samples.
“Image not found” or missing platform files when running a sample. The installer was not fully extracted, or required runtimes are missing. Re-run the installer from Applications, and confirm that your .NET SDK version is compatible with the sample.

For additional help, see Common Installation Errors.