Updated Set up Build Environment on macOS (markdown)

Set-up-Build-Environment-on-macOS.md

@@ -7,28 +7,59 @@ Install Homebrew (it is the easiest way to install the required packages on macO
 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 ```
 
-### Install the C++ toolchain
+Next, install the needed build tools:
-
-This command will install Cmake
-
-Open a Terminal
 
 ```
-brew install cmake
+brew install cmake asciidoctor
 ```
 
-### Install the required dependencies
+### Install build dependencies
 
-Open a Terminal:
+To install the actual build dependencies, there are two options:
+
+1. Via Homebrew (faster, but suitable only for local builds).
+2. Via vcpkg (much slower, but suitable for distribution builds).
+
+#### Option 1: Install build dependencies via Homebrew
+
+Open a terminal and run:
 
 ```
-brew install qt@5 argon2 botan qrencode asciidoctor readline minizip
+brew installqt@5 argon2 botan qrencode asciidoctor readline minizip
+```
+
+#### Option 2: Install build dependencies via vcpkg
+
+Install vcpkg and pkg-config via Homebrew:
+
+```
+brew install vcpkg pkg-config
+```
+
+Next, update the vcpkg port files:
+
+```
+cd /opt/vcpkg && git pull
+```
+
+Finally, compile and install the actual build dependencies:
+
+```
+vcpkg install argon2 botan minizip qt5 qt5-svg qt5-tools qt5-imageformats \
+    qt5-translations readline zlib libqrencode
 ```
 
 ### Update your environment regularly
 
-Open a Terminal:
+Homebrew:
 
 ```
 brew update && brew upgrade
 ```
+
+vcpkg:
+
+```
+cd /opt/vcpkg && git pull
+vcpkg update
+```