meshlab/scripts/macOS/README.md
2020-11-18 17:30:15 +01:00

38 lines
2.2 KiB
Markdown

# MacOS Scripts
This folder contains a series of scripts to build and deploy MeshLab under a MacOS environment.
* `0_setup_env.sh`: this script installs all the required dependencies that are necessary to build MeshLab and to create its DMG in a MacOS machine (tested in 10.15 Catalina). It requires [homebrew](https://brew.sh/) installed;
* `1_build.sh`: this script builds MeshLab in a MacOS environment:
* it requires a properly set Qt environment (see `0_setup_env.sh`);
* takes as arguments:
* the build directory (default: `src/build`): `--build_path=path/to/build`
* the install directory (default: `src/install`): `--install_path=path/to/install`
* the number of cores used to build MeshLab (default: `-j4`)`
* the possibility to build MeshLab with double precision scalar: `--double_precision`
* `2_deploy.sh`: this script makes portable a `meshlab.app` appdir. Takes as arguments:
* the path where the output install path of the `1_build.sh` script is placed (default: `src/install`): `--install_path=path/to/install`
* `3_dmg.sh`: this script generates a [DMG](https://en.wikipedia.org/wiki/Apple_Disk_Image) that can be used to install MeshLab. Takes as arguments:
* the path where the install path of the `2_deploy.sh` script is placed (default: `src/install`): `--install_path=path/to/install`
* if MeshLab has been built with double precision scalar, add: `--double_precision`
* `make_it.sh`: this script builds, deploys and generates a [DMG](https://en.wikipedia.org/wiki/Apple_Disk_Image) that can be used to install MeshLab. Arguments are the same of the `1_build.sh` script.
## Examples
Building MeshLab on a clean MacOS environment (build placed in `meshlab/src/build`):
git clone --recursive https://github.com/cnr-isti-vclab/meshlab
sh meshlab/scripts/macOS/0_setup_env.sh
sh meshlab/scripts/macOS/1_build.sh
Building and generating a DMG on a clean MacOS environment:
* build directory: `./meshlab-build`
* install directory: `./meshlab-install`
* DMG path: `./`
```
git clone --recursive https://github.com/cnr-isti-vclab/meshlab
sh meshlab/scripts/macOS/0_setup_env.sh
sh meshlab/scripts/macOS/make_it.sh --build_path="./meshlab-build" --install_path="./meshlab-install"
```