21.1. Setup¶
21.1.1. Masonry Scripts¶
The masonry scripts are bundled with VisIt’s source code. You will need to download
the source code and extract masonry from visit/src/tools/dev
. There are a few options
for downloading the source code. If you want a released version of VisIt then go to the
source code downloads page and look for the VisIt sources
link. The other option is to download from the git repository.
Once you have the source code, copy visit/src/tools/dev/masonry
to a location of your choosing.
21.1.2. Configuration¶
- In the
opts
directory copy one of the*.json
files and rename it as desired. For example:cp mb-3.1.1-darwin-10.14-x86_64-release.json mb-3.1.2-darwin-10.14-x86_64-release.json
- Open the JSON configuration file (see Figure 21.1) created in step 1 and modify or add the following options as needed:
version
: required- The version of VisIt you are building.
build_types
: required- A list of builds for masonry to create.
build_dir
: optional- The directory to place all of the files generated from the build process. If this option isn’t specified the build directory will default to
build-<json_base>
(e.g., build-mb-3.1.2-darwin-10.14-x86_64-release) in your current working directory. branch
: required- The git branch to checkout and build.
arch
: required- The build architecture (e.g., darwin-x86_64).
cert
: optional- The Developer ID signing certificate Common Name.
make_nthreads
: optional- The number of parallel threads to use when building the source code.
skip_checkout
: optional- if you have to restart masonry and already have the source code checked out you can skip that step by setting this option to yes.
boost_dir
: optional- The path to boost if installed on your system. This also triggers the setting of two CMake options (VISIT_USE_BOOST:BOOL and BOOST_ROOT:PATH).
git
: requiredmode
: required - set this option to ssh or httpsgit_uname
: optional - github usernamedepth
: optional - specify an integer value for a shallow clone with a history truncated to the specified number of commits.build_visit
: requiredAllows you to set the
build_visit
options.cmake_ver
: required - the CMake version to useargs
: optional - arguments forbuild_visits
libs
: optional - third-party libraries to buildmake_flags
: optional - Make flagsforce_clean
: optional- Removes all files and directories from your build folder.
c_compiler
: optional- Specify the C compiler
cxx_compiler
: optional- Specify the C++ compiler
tarball
: optional- Specify the path to the source tar file. This option is currently not being used.
build_xdb
: optional- Set the VISIT_ENABLE_XDB:BOOL option to ON if true.
cmake_extra_args
: optional- Specify extra arguments for CMake.
config_site
: optional- Specify a path for the config site file.
platform
: optional- Specify the platform (osx or linux)
21.1.3. Signing macOS Builds¶
To code sign your VisIt build, you must be enrolled in the Apple Developer Program and have a valid Developer ID certificate. Below are simple steps to get started, reference the links for more detailed information.
- Enroll in the Apple Developer Program, if needed, and create your Developer ID certificates.
- Install Apple certificates into your keychain
- From Xcode go to the account preferences (
Xcode->Preferences->Account
) and select the Manage Certificates… button. - Click the + to add your certificates (see Figure 21.2).
- From Xcode go to the account preferences (
- Add the Developer ID signing certificate Common Name to the cert option in the masonry JSON configuration file.