Appearance

Install on macOS ​

Two approaches for installing and using ADOxx are available for macOS:

  • Normal mode: uses an ADOxx application package that can be moved into the Applications folder.

The installation has been tested on macOS 14.0 Sonoma.

Guided Installation ​

Normal Mode ​

To install ADOxx on macOS (normal mode):

  1. Download the .zip package with the files for macOS from the ADOxx homepage.
  2. Extract the downloaded .zip file to a location of your choice.
  3. Open the .dmg file from the extracted location to mount the file and open the package.
  4. Drag and drop the ADOxx application into the "Applications" folder.
    macOS .dmg screen
  5. Unmount the .dmg file.
  6. Start the ADOxx application from the "Applications" folder.

    In case of "cannot verify developer"

    In case a warning like "macOS cannot verify the developer of “ADOxx 1.8.0”. Are you sure you want to open it?" is shown, right-click on the ADOxx app, select open and confirm that you want to open.

  7. Select "ADOxx 1.8.0 Development Toolkit" in the pop-up. When started the first time a pop-up will inform of additional dependencies.
    macOS install further prerequisites
  8. Confirm the message and step through the process in the terminal window.
    macOS further installation in terminal window
    • Dependencies are installed as necessary during this step.
    • Your administration password is required during these installation steps.

Expert Mode ​

To install the Scene2Model modelling tool on macOS :

  1. Download the .zip package with the expert installation files for macOS from the Scene2Model homepage.
  2. Extract the downloaded .zip file to a location of your choice.
  3. Open a terminal window and navigate to the extracted location.
  4. Execute the script ./install_on_macos.sh.
    • If the script can not be executed, then give it execution permissions with the command chmod +x ./install_on_macos.sh and try again.
  5. Follow the instructions of the installation script.
    macOS further installation in terminal window
    • Dependencies are installed as necessary during this step.
    • Your administration password is required for the installation.

Guided Uninstallation ​

To uninstall Scene2Model modelling tool on macOS:

  1. Open a terminal window and navigate to the of the installer files (extracted location for installation).
  2. Execute the script ./uninstall_on_macos.sh.
    • If the script can not be executed, then give it execution permissions with the command chmod +x ./uninstall_on_macos.sh and try again.
  3. Follow the instructions of the uninstallation script.

Wine and Homebrew

ADOxx and ADOxx based tools require Wine to run on macOS. Wine is installed using Homebrew. These are installed as part of the installation process. Only remove them if you no longer need them for any other applications, e.g. other ADOxx based tools etc.

Dependencies ​

ADOxx and ADOxx based tools require the following to run on macOS:

  • Wine - Necessary to run the Windows applications.
  • Homebrew - Necessary to install and manage Wine.

Additionally the tool requires a database to store the data:

  • Currently the default database system used is SQLite.

Troubleshooting ​

The Scene2Model modelling tool was created based on the ADOxx meta-modelling platform, therefore you can also search for solution on installation problem on the the ADOxx troubleshooting page.