Update platforms support docs

Author: mafiesto4

manual/editor/flax-build/index.md

@@ -99,7 +99,7 @@ Additionally, all build scripts are included in **BuildScripts** C# project whic
 
 ## Platforms Support
 
-Flax.Build is a **multiplatform** utility that has been battle-tested on Windows and Linux to build engine and games to the different target platforms including Windows, PS4, PS5, Xbox One, Xbox Scarlett, Android, Switch, Linux, macOS, UWP. Each target platform implementation is stored in a separate directory under `Source\Tools\Flax.Build\Platforms` and contain **Platform** implementation and **Toolchain** implementation. Different platforms can use external SDKs, toolsets, or custom compilers to build code for a runtime.
+Flax.Build is a **multiplatform** utility that has been battle-tested on Windows and Linux to build engine and games to the different target platforms including Windows, PS4, PS5, Xbox One, Xbox Scarlett, Android, Switch, Linux, macOS, iOS. Each target platform implementation is stored in a separate directory under `Source\Tools\Flax.Build\Platforms` and contain **Platform** implementation and **Toolchain** implementation. Different platforms can use external SDKs, toolsets, or custom compilers to build code for a runtime.
 
 Also, engine dependency packages contain automatic build scripts to prepare pre-build deps for development. When adding new platform support many deps packages have to be ported too. The related code can be found in `Source\Tools\Flax.Build\Deps\Dependencies` folder.
 

manual/editor/game-settings/index.md

@@ -43,11 +43,12 @@ You can use the *Content* window to create new settings. Simply right-click in t
 | **Streaming** | Reference to [Streaming Settings](streaming-settings.md) asset. Contains resources streaming configuration such as Texture Groups options. |
 | **Custom Settings** | Collection of custom json assets used by the game and plugins. To learn more see the related documentation [here](custom-settings.md). |
 | **Windows** | Reference to [Windows Settings](../../platforms/windows.md) asset. Contains options used when building game for Windows. |
-| **Universal Windows Platform** | Reference to [Universal Windows Platform Settings](../../platforms/uwp.md) asset. Contains options used when building game for Xbox One and Windows Store. |
 | **PlayStation 4** | Reference to [PlayStation 4 Settings](../../platforms/ps4.md) settings. Contains options used when building game for PlayStation 4. |
 | **PlayStation 5** | Reference to [PlayStation 5 Settings](../../platforms/ps5.md) settings. Contains options used when building game for PlayStation 5. |
 | **Xbox Scarlett** | Reference to [Xbox Scarlett Settings](../../platforms/xbox-scarlett.md) settings. Contains options used when building game for Xbox Scarlett. |
 | **Switch** | Reference to [Switch Settings](../../platforms/switch.md) settings. Contains options used when building game for Switch. |
+| **macOS** | Reference to [macOS](../../platforms/mac.md) asset. Contains options used when building game for macOS. |
+| **iOS** | Reference to [iOS](../../platforms/ios.md) asset. Contains options used when building game for iOS. |
 
 ## Accessing settings at runtime
 

manual/platforms/android.md

@@ -15,7 +15,7 @@ Follow these steps to setup your development PC for building game for Android pl
   * Set `ANDROID_HOME` env var to SDK location (typically `C:\Users\USERNAME\AppData\Local\Android\android-studio\sdk` on Windows)
 * Install **NDK**
   * via Android SDK Manager: *Android SDK -> SDK Tools -> NDK (side by side)*
-  * or manually via [https://developer.android.com/ndk/downloads/index.html](https://developer.android.com/ndk/downloads/index.html) and set `ANDROID_NDK` env var to install location) 
+  * or manually via [https://developer.android.com/ndk/downloads/index.html](https://developer.android.com/ndk/downloads/index.html) and set `ANDROID_NDK` env var to install location
 * Install **Java**
   * use in-built from Android Studio: set `JAVA_HOME` env var to `<android-studio>\jbr`
   * or download manually from [https://jdk.java.net/19](https://jdk.java.net/19) and set env var `JAVA_HOME` to jdk root folder

manual/platforms/index.md

@@ -8,8 +8,7 @@ This section covers the specific information for different aspects of each platf
 
 ## Supported platforms
 
-* [Windows Desktop 7, 8, 10](windows.md)
-* [Universal Windows (UWP)](uwp.md)
+* [Windows Desktop 7, 8, 10, 11](windows.md)
 * [Xbox One](xbox-one.md)
 * [Xbox Scarlett](xbox-scarlett.md)
 * [PlayStation 4](ps4.md)
@@ -18,6 +17,7 @@ This section covers the specific information for different aspects of each platf
 * [Android](android.md)
 * [Switch](switch.md)
 * [macOS](mac.md)
+* [iOS](ios.md)
 
 > [!TIP]
 > To check on which platform game is running use [Platform.Platform](https://docs.flaxengine.com/api/FlaxEngine.Platform.html#FlaxEngine_Application_Platform). You can also use [preprocessor variables](../scripting/preprocessor.md) in your code.

manual/platforms/ios.md

@@ -0,0 +1,33 @@
+# iOS
+
+## Technical information
+
+Flax supports **iOS 14 or newer**. For graphics rendering Vulkan is used via MoltenVK to run on Metal.
+
+## iOS Setup
+
+Follow these steps to setup your development PC for building game for iOS platform. In case of problems, please follow official documentation of iOS platform.
+
+* Install **XCode** 
+* Install **.Net iOS Workload**
+  * Run `dotnet workload install ios` via command line
+  * More info: [https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install)
+
+### Troubleshooting
+
+* If you're getting the error `Missing NET SDK runtime for iOS ARM64.` then install iOS workload for dotnet (as mentioned above). It contains .Net libs, tools and runtime for iOS required to run C#.
+
+## Build options
+
+| Property | Description |
+|--------|--------|
+| **Output** | The built game output folder (relative to the project). |
+| **Show Output** | If checked, after building the output folder will be shown in an Explorer. |
+| **Configuration Mode** | Game building mode. Possible options: <table><tbody><tr><th>Option</th><th>Description</th></tr><tr><td>**Release**</td><td>The release build ready for shipment.</td></tr><tr><td>**Debug**</td><td>The debug build for testing and profiling. Most of the code optimizations are disabled for the best debugging experience.</td></tr><tr><td>**Development**</td><td>The development build for testing and profiling but is more optimized for runtime than Debug build.</td></tr></tbody></table>|
+
+## Platform settings
+
+| Property | Description |
+|--------|--------|
+| **App Identifier** | The app identifier (reversed DNS, eg. com.company.product). Custom tokens: `${PROJECT_NAME}`, `${COMPANY_NAME}`. |
+| **Override Icon** | Custom icon texture to use for the application (overrides the default one). |

manual/platforms/mac.md

@@ -11,6 +11,7 @@ Flax supports **macOS 10.14 or newer**. For graphics rendering Vulkan is used vi
 | **Output** | The built game output folder (relative to the project). |
 | **Show Output** | If checked, after building the output folder will be shown in an Explorer. |
 | **Configuration Mode** | Game building mode. Possible options: <table><tbody><tr><th>Option</th><th>Description</th></tr><tr><td>**Release**</td><td>The release build ready for shipment.</td></tr><tr><td>**Debug**</td><td>The debug build for testing and profiling. Most of the code optimizations are disabled for the best debugging experience.</td></tr><tr><td>**Development**</td><td>The development build for testing and profiling but is more optimized for runtime than Debug build.</td></tr></tbody></table>|
+| **CPU** | Target processor architecture (Intel or Apple Silicon). |
 
 ## Platform settings
 

manual/platforms/uwp.md

@@ -2,47 +2,5 @@
 
 ![Title](media/Post_XboxOneSupport1.jpg)
 
-## Technical information
-
-Flax is compiled for Xbox One (via UWP) using Microsoft Visual C++ compiler. It uses **v141** (VC\+\+ 2017) toolset and **Windows 10 SDK** with Multi-threaded DLL runtime. All dependent libraries are used via static linking by the Flax Engine binary.
-
-## Build options
-
-![Build Options](media/build-xbox-one.jpg)
-
-| Property | Description |
-|--------|--------|
-| **Output** | The built game output folder (relative to the project). |
-| **Show Output** | If checked, after building the output folder will be shown in an Explorer. |
-| **Configuration Mode** | Game building mode. Possible options: <table><tbody><tr><th>Option</th><th>Description</th></tr><tr><td>**Release**</td><td>The release build ready for shipment.</td></tr><tr><td>**Debug**</td><td>The debug build for testing and profiling. Most of the code optimizations are disabled for the best debugging experience.</td></tr><tr><td>**Development**</td><td>The development build for testing and profiling but is more optimized for runtime than Debug build.</td></tr></tbody></table>|
-
-## Platform settings
-
-![Settings](media/settings-uwp.jpg)
-
-| Property | Description |
-|--------|--------|
-| **Preferred Launch Windowing Mode** | *Not used on Xbox One. Always fullscreen mode.* |
-| **Auto Rotation Preferences** | *Not used on Xbox One. No screen rotation.* |
-| **Certificate Location** | The location of the package certificate (relative to the project). |
-
-## Deployment
-
-Building you game to support Xbox One platform is rather straighforward process hovewer you will need to have an acess to Xbox One or Xbox One S device that has Developer Mode activated. Follow these steps to build your game for Xbox One:
-
-- Prepare you game to support Xbox One (remove or fix platform dependant code and verify gamepad support)
-- Prepare you Xbox Developer account and Xbox Dev Kit
-- Learn about Xbox One development by following the official Microsoft guidelines and documentation [here](https://docs.microsoft.com/en-us/windows/uwp/xbox-apps/getting-started)
-- Ensure to have the newest **Windows 10 SDK** installed
-- Open *Game Cooker*, and start **Build**
-- Application certificate generator window will popup, Flax uses Windows SDK toolset to generate a temporary certificates that you can use for your app. Every store app needs to have a valid own certificate for code signing required by Microsoft policy
-- Enter your game certificate password (note: you can use a custom certificate if you need, just specify its location in build settings)
-- Wait for game cooking end (please note that Xbox One does not support runtime code generation so Flax needs to perform AOT on all C# assemblies including your game code)
-- Open generated UWP project solution located in the build output directory
-- Ensure to use `Debug` configuration mode (`Release` mode is not supported now due to dynamic libraries merging by the toolchain not maintained by Flax)
-- Build solution (optionally perform Rebuild)
-- Pick Xbox One device for remote deploy (connect your PC to the same network as Xbox One, eg. via WiFi). Follow Microsoft guidelines and documentation in this area.
-- Press **Remote Machine** to start the app on device
-
-After editing project content or source code, the amount of data to rebuild is relatively slow so your iteration times should be fairly good if you are porting your game to support Xbox One. Remember to follow Microsoft guidelines and documentation.
-
+Xbox One platform support documentation is located in NDA-restricted folder in Flax source repository.
+If you want to develop your game on Xbox One please [contact](https://flaxengine.com/contact/) (avaliable only for developers approved by Microsoft with access to GDK).

manual/platforms/xbox-one.md

@@ -26,6 +26,7 @@ C# scripting runtime and tools have been updated to use the latest .NET 7 SDK on
 * Mobile and Consoles use new [mono](https://github.com/dotnet/runtime/tree/main/src/mono) with Mono AOT but with the latest class library (feature compatible with CoreCLR)
 * Visual Studio 2019 (and older) are unsupported by .NET 7 SDK (still can be used for programming but with less tooling)
 * [Flax.VS](https://marketplace.visualstudio.com/items?itemName=Flax.FlaxVS) extension is not required anymore for C# debugging in Visual Studio - VS 2022 has inbuilt .NET 7 debugger
+* Android platform requires Android .NET Workload installation via `dotnet workload install android`
 * Old Mono runtime hosting code is still available in Flax codebase but is disabled and will be removed in future
 
 We've updated docs, code examples, and all official plugins to reflect those changes.

manual/release-notes/1_6/index.md

@@ -20,11 +20,10 @@ public override void OnStart()
 | **FLAX** | Always defined. Can be used to detect code compiled for Flax environment. |
 | **FLAX_EDITOR** | Compile for editor (play in-edior). |
 | **PLATFORM_WINDOWS** | Compile for Windows. |
-| **PLATFORM_UWP** | Compile for Universal Windows Platform (UWP). |
 | **PLATFORM_XBOX_ONE** | Compile for Xbox One. |
 | **PLATFORM_XBOX_SCARLETT** | Compile for Xbox Scarlett. |
 | **PLATFORM_PS4** | Compile for PlayStation 4. |
-| **PLATFORM_PS5** | Compile for PlayStation 4. |
+| **PLATFORM_PS5** | Compile for PlayStation 5. |
 | **PLATFORM_LINUX** | Compile for Linux. |
 | **PLATFORM_ANDROID** | Compile for Android. |
 | **PLATFORM_SWITCH** | Compile for Switch. |
@@ -40,4 +39,3 @@ public override void OnStart()
 | **USE_AOT** | Defined when compiling C# with [AOT mode](restrictions.md) enabled. |
 
 To specify custom compilation macros see [Game Cooker](../editor/flax-build/index.md) documentation.
-

manual/scripting/preprocessor.md

@@ -407,7 +407,6 @@
 
 # [Platforms](platforms/index.md)
 ## [Windows](platforms/windows.md)
-## [UWP](platforms/uwp.md)
 ## [Xbox One](platforms/xbox-one.md)
 ## [Xbox Scarlett](platforms/xbox-scarlett.md)
 ## [PlayStation 4](platforms/ps4.md)
@@ -416,6 +415,7 @@
 ## [Android](platforms/android.md)
 ## [Switch](platforms/switch.md)
 ## [macOS](platforms/mac.md)
+## [iOS](platforms/ios.md)
 
 # [Contributing](contributing/index.md)
 ## [Feature Requests](contributing/feature-requests.md)