This guide covers everything you need to set up a development environment on macOS, from installing Xcode to optionally integrating MoltenVK for Vulkan support.

Make sure your Mac meets the following requirements before starting:

The official and easiest way to install Xcode is via the Mac App Store.

1. Open the App Store
2. Search for Xcode
3. Download and Install
4. Launch Xcode
5. Complete the Initial Setup
   • You will be prompted to select platforms (e.g., iOS, macOS, visionOS). Choose the ones you need (you can add more later).
   • If asked to "Relaunch Xcode" for final configuration, click the button and wait for it to restart.
   • Grant any requested permissions (such as local network access for debugging on physical devices).

If you plan to use the Terminal for git, clang, or make, you can install the standalone Command Line Tools package.

Note: If you already installed the full Xcode app, these tools are included. However, you may still use this command to manage or update them separately.

1. Open Terminal (/Applications/Utilities/Terminal.app).
2. Run the following command:
   xcode-select --install
3. In the pop-up window that appears, click "Install" and agree to the license terms.
4. Wait for the download and installation to complete.

If you want to develop Vulkan applications on macOS, you need MoltenVK. There are two primary ways to get it.

⚠️ Prerequisite: Ensure you have the latest public version of Xcode installed to access the newest Metal SDK features required by the latest MoltenVK builds.

The LunarG Vulkan SDK bundles a pre-built, tested version of MoltenVK specifically for macOS.

1. Visit the official Vulkan SDK website.
2. Download the macOS installer (.dmg).
3. Mount the disk image and run the installer package (.pkg).
4. Follow the on-screen instructions. The SDK will install MoltenVK and associated tools to /usr/local/ or a user-specified directory.

If you need a custom build or a specific platform version (iOS/tvOS/visionOS), you can compile it from source.

1. Clone the repository (in Terminal):
2. Build using Xcode:
   • Open the project file: open MoltenVKPackaging.xcodeproj
   • In Xcode, select one of the available schemes:
     • MoltenVK Package (macOS only)
     • MoltenVK Package (iOS only)
     • MoltenVK Package (tvOS only)
     • MoltenVK Package (visionOS only) (requires Xcode 15+)
   • Click Product > Build (Cmd + B).
3. Or build via command line (using xcodebuild):
   
xcodebuild build -quiet -project MoltenVKPackaging.xcodeproj -scheme "MoltenVK Package (macOS only)" -configuration "Release"
4. Or use the Makefile:
   
make macos # For macOS
# or make ios, make tvos, etc.

You are now ready to integrate Kemena3D with native macOS applications.