@@ -318,8 +318,8 @@ By default, applications will run in OpenGLES mode. To run them in Vulkan mode,
318
318
319
319
Prerequisites:
320
320
321
- * Xcode 13 or later
322
- * Vulkan SDK 1.3.216.0 or later to enable Vulkan
321
+ * Xcode 14 or later
322
+ * Vulkan SDK 1.3.231.1 or later to enable Vulkan
323
323
324
324
After you clone the repo, run the following command from the engine's root folder to generate Xcode project:
325
325
@@ -343,10 +343,10 @@ or [gfx-portability](https://github.com/gfx-rs/portability). Install [VulkanSDK]
343
343
and make sure that your system is properly configured as described
344
344
[ here] ( https://vulkan.lunarg.com/doc/view/latest/mac/getting_started.html#user-content-sdk-system-paths ) .
345
345
In particular, you may need to define the following environment variables (assuming that Vulkan SDK is installed at
346
- ` /Users/MyName/VulkanSDK/1.3.216.0 ` and you want to use MoltenVK):
346
+ ` /Users/MyName/VulkanSDK/1.3.231.1 ` and you want to use MoltenVK):
347
347
348
348
```
349
- export VULKAN_SDK=/Users/MyName/VulkanSDK/1.3.216.0 /macOS
349
+ export VULKAN_SDK=/Users/MyName/VulkanSDK/1.3.231.1 /macOS
350
350
export PATH=$VULKAN_SDK/bin:$PATH
351
351
export DYLD_LIBRARY_PATH=$VULKAN_SDK/lib:$DYLD_LIBRARY_PATH
352
352
export VK_ICD_FILENAMES=$VULKAN_SDK/share/vulkan/icd.d/MoltenVK_icd.json
@@ -370,15 +370,15 @@ System Integrity Protection is disabled (which generally is not recommended). In
370
370
Vulkan library, it must be in rpath. If ` VULKAN_SDK ` environment variable is set and points to correct location, Diligent
371
371
Engine will configure the rpath for all applications automatically.
372
372
373
- Last tested Vulkan SDK version: 1.3.216.0 .
373
+ Last tested Vulkan SDK version: 1.3.231.1 .
374
374
375
375
<a name =" build_and_run_ios " ></a >
376
376
## iOS
377
377
378
378
Prerequisites:
379
379
380
- * Xcode 13 or later
381
- * Vulkan SDK 1.3.216.0 or later to enable Vulkan
380
+ * Xcode 14 or later
381
+ * Vulkan SDK 1.3.231.1 or later to enable Vulkan
382
382
383
383
Run the command below from the engine's root folder to generate Xcode project configured for
384
384
[ iOS build] ( https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html#cross-compiling-for-ios-tvos-or-watchos ) :
@@ -393,6 +393,13 @@ If needed, you can provide iOS deployment target (11.0 or later is required) as
393
393
cmake -S . -B ./build/iOS -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 -G "Xcode"
394
394
```
395
395
396
+ :warning : To build for iPhone simulator, set the ` PLATFORM_IOS_SIMULATOR ` CMake flag. You may also use the
397
+ ` CMAKE_OSX_ARCHITECTURES ` variable to specify target architecture, for example:
398
+
399
+ ``` cmake
400
+ cmake -S . -B ./build/iOSSim -DCMAKE_SYSTEM_NAME=iOS -DPLATFORM_IOS_SIMULATOR=ON -DCMAKE_OSX_ARCHITECTURES=arm64 -G "Xcode"
401
+ ```
402
+
396
403
Open Xcode project file in ` build/IOS ` folder and build the engine. To run the applications on an iOS device,
397
404
you will need to set appropriate development team in the project settings.
398
405
@@ -402,10 +409,10 @@ To enable Vulkan on iOS, download and install the [VulkanSDK](https://vulkan.lun
402
409
on iOS, and Diligent Engine links directly with MoltenVK XCFramework (see
403
410
[ MoltenVk install guide] ( https://github.com/KhronosGroup/MoltenVK/blob/master/Docs/MoltenVK_Runtime_UserGuide.md#install-moltenvk-as-a-universal-xcframework ) )
404
411
that implements Vulkan on Metal. To enable Vulkan in Diligent Engine on iOS, specify the path to Vulkan SDK
405
- when running CMake, for example (assuming that Vulkan SDK is installed at ` /Users/MyName/VulkanSDK/1.3.216.0 ` ):
412
+ when running CMake, for example (assuming that Vulkan SDK is installed at ` /Users/MyName/VulkanSDK/1.3.231.1 ` ):
406
413
407
414
``` cmake
408
- cmake -DCMAKE_SYSTEM_NAME=iOS -DVULKAN_SDK=/Users/MyName/VulkanSDK/1.3.216.0 -S . -B ./build/iOS -G "Xcode"
415
+ cmake -DCMAKE_SYSTEM_NAME=iOS -DVULKAN_SDK=/Users/MyName/VulkanSDK/1.3.231.1 -S . -B ./build/iOS -G "Xcode"
409
416
```
410
417
411
418
By default, the engine links with MoltenVK XCFramework located in Vulkan SDK. If this is not desired or an application wants
@@ -414,7 +421,7 @@ to use a specific library, it can provide the full path to the library via `MOLT
414
421
Refer to [ MoltenVK user guide] ( https://github.com/KhronosGroup/MoltenVK/blob/master/Docs/MoltenVK_Runtime_UserGuide.md#install )
415
422
for more information about MoltenVK installation and usage.
416
423
417
- Last tested Vulkan SDK version: 1.3.216.0 .
424
+ Last tested Vulkan SDK version: 1.3.231.1 .
418
425
419
426
<a name =" build_and_run_emscripten " ></a >
420
427
## Emscripten
0 commit comments