Issue-58 : MacOS VulkanSDK Install Instructions. (#59)

* update macos install language

* update macos image xcode paths and sdk install

* try reverting spaces

* try reverting spaces

* try reverting spaces

* try reverting spaces

* try reverting spaces

* try reverting spaces

Author: SummerGautier

en/02_Development_environment.adoc

@@ -445,15 +445,20 @@ The SDK version for MacOS internally uses link:https://github.com/KhronosGroup/M
 There is no native support for Vulkan on MacOS, so what MoltenVK does is actually act as a layer that translates Vulkan API calls to Apple's Metal graphics framework.
 With this you can take advantage of debugging and performance benefits of Apple's Metal framework.
 
-After downloading it, simply extract the contents to a folder of your choice (keep in mind you will need to reference it when creating your projects on Xcode).
-Inside the extracted folder, in the `Applications` folder you should have some executable files that will run a few demos using the SDK.
+After downloading the installer for MacOS, double-click the installer and follow the prompts. Keep a note of the installation location during the "Installation Folder" step. You will need to reference it when creating your projects in Xcode.
+
+image::/images/sdk_install_mac.png[]
+
+**Note**: In this tutorial, `vulkansdk` will refer to the path where you intalled the VulkanSDK.
+
+Within the `vulkansdk/Applications` folder you should have some executable files that will run a few demos using the SDK.
 Run the `vkcube` executable and you will see the following:
 
 image::/images/cube_demo_mac.png[]
 
 === GLFW
 
-As mentioned before, Vulkan by itself is a platform agnostic API and does not include tools for creation a window to display the rendered results.
+As mentioned before, Vulkan by itself is a platform agnostic API and does not include tools for creating a window to display the rendered results.
 We'll use the https://www.glfw.org/[GLFW library] to create a window, which supports Windows, Linux and MacOS.
 There are other libraries available for this purpose, like https://www.libsdl.org/[SDL], but the advantage of GLFW is that it also abstracts away some of the other platform-specific things in Vulkan besides just window creation.
 
@@ -536,11 +541,23 @@ Keep in mind you are not required to understand all this code is doing yet, we a
 
 Xcode should already be showing some errors such as libraries it cannot find.
 We will now start configuring the project to get rid of those errors.
+
+To do this, you will need the install location of glfw and glm. The default homebrew folder varies if you are on an Intel Mac `/usr/local` or Apple Silicon Mac `/opt/homebrew`. You can determine your homebrew install location using `--prefix`:
+
+[,bash]
+----
+brew --prefix
+----
+
 On the _Project Navigator_ panel select your project.
 Open the _Build Settings_ tab and then:
 
-* Find the *Header Search Paths* field and add a link to `/usr/local/include` (this is where Homebrew installs headers, so the glm and glfw3 header files should be there) and a link to `vulkansdk/macOS/include` for the Vulkan headers.
-* Find the *Library Search Paths* field and add a link to `/usr/local/lib` (again, this is where Homebrew installs libraries, so the glm and glfw3 lib files should be there) and a link to `vulkansdk/macOS/lib`.
+* Find the *Header Search Paths* field.
+- Add a link to `/opt/homebrew/include` (or `/usr/local/include` for Intel Mac). The glm and glfw3 header files should be in this directory.
+- Add a link to `vulkansdk/macOS/include` for the Vulkan headers.
+* Find the *Library Search Paths* field. 
+- Add a link to `/opt/homebrew/lib` (again, `/usr/local/lib` for Intel Mac)
+- Add a link to `vulkansdk/macOS/lib`.
 
 It should look like so (obviously, paths will be different depending on where you placed on your files):
 
@@ -549,10 +566,12 @@ image::/images/xcode_paths.png[]
 Now, in the _Build Phases_ tab, on *Link Binary With Libraries* we will add both the `glfw3` and the `vulkan` frameworks.
 To make things easier we will be adding the dynamic libraries in the project (you can check the documentation of these libraries if you want to use the static frameworks).
 
-* For glfw open the folder `/usr/local/lib` and there you will find a file name like `libglfw.3.x.dylib` ("x" is the library's version number, it might be different depending on when you downloaded the package from Homebrew).
-Simply drag that file to the Linked Frameworks and Libraries tab on Xcode.
+* For glfw open the folder `/opt/homebrew/lib` and there you will find a file name like `libglfw.3.x.dylib` ("x" is the library's version number, it might be different depending on when you downloaded the package from Homebrew).
+Simply drag that file to the Link Binary With Libraries section on Xcode.
 * For vulkan, go to `vulkansdk/macOS/lib`.
-Do the same for the both files `libvulkan.1.dylib` and `libvulkan.1.x.xx.dylib` (where "x" will be the version number of the the SDK you downloaded).
+Once open in Finder, look for `libvulkan.1.dylib` and `libvulkan.1.x.xxx.dylib` (where "x" will be the version number of the the SDK you downloaded). Select both files and drag them together into the Link Binary With Libraries section as well.
+
+*Note:* If you drag the vulkan files in separately, the dynamic libraries may be incorrectly associated at runtime.
 
 After adding those libraries, in the same tab on *Copy Files* change `Destination` to "Frameworks", clear the subpath and deselect "Copy only when installing".
 Click on the "+" sign and add all those three frameworks here aswell.
@@ -567,7 +586,7 @@ On Xcode toolbar go to `Product` > `Scheme` > `+Edit Scheme...+`, and in the `Ar
 * VK_ICD_FILENAMES = `vulkansdk/macOS/share/vulkan/icd.d/MoltenVK_icd.json`
 * VK_LAYER_PATH = `vulkansdk/macOS/share/vulkan/explicit_layer.d`
 
-It should look like so:
+Uncheck 'shared'. It should look like so:
 
 image::/images/xcode_variables.png[]