Skip to content

[.NET] Document web support and limitations #10929

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
+16 −19
Draft

[.NET] Document web support and limitations #10929

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 4 additions & 7 deletions about/list_of_features.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,8 @@ Godot aims to be as platform-independent as possible and can be

.. note::

Projects written in C# using Godot 4 currently cannot be exported to the
web platform. To use C# on that platform, consider Godot 3 instead.
Android and iOS platform support is available as of Godot 4.2, but is
experimental and :ref:`some limitations apply <doc_c_sharp_platforms>`.
Projects written in C# using Godot 4 have experimental support for Android and iOS since 4.2,
and for the web platform since 4.5. See :ref:`doc_c_sharp_platforms` for more information.

Editor
------
Expand Down Expand Up @@ -467,11 +465,10 @@ Scripting

- Full support for the C# 12.0 syntax and features.

- Supports Windows, Linux, and macOS. Since Godot 4.2, experimental support for Android and iOS is also available.
- Supports Windows, Linux, and macOS. Since Godot 4.2, experimental support for Android and iOS is also available. Since 4.5, experimental support for web is also available.

- On the iOS platform only some architectures are supported: ``arm64``.
- The web platform is currently unsupported. To use C# on that platform,
consider Godot 3 instead.
- The web platform has :ref:`some limitations <doc_c_sharp_platforms>`.

- Using an external editor is recommended to benefit from IDE functionality.

Expand Down
7 changes: 2 additions & 5 deletions tutorials/export/exporting_for_web.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,8 @@ in the user's browser.

.. attention::

Projects written in C# using Godot 4 currently cannot be exported to the
web. See `this blog post <https://godotengine.org/article/platform-state-in-csharp-for-godot-4-2/#web>`__
for more information.

To use C# on web platforms, use Godot 3 instead.
Projects written in C# using Godot 4 have experimental support for Android and iOS since 4.2,
and for the web platform since 4.5. See :ref:`doc_c_sharp_platforms` for more information.

.. tip::

Expand Down
6 changes: 2 additions & 4 deletions tutorials/scripting/c_sharp/c_sharp_basics.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,8 @@ it is implemented with .NET 8.0.

.. attention::

Projects written in C# using Godot 4 currently cannot be exported to the web
platform. To use C# on the web platform, consider Godot 3 instead.
Android and iOS platform support is available as of Godot 4.2, but is
experimental and :ref:`some limitations apply <doc_c_sharp_platforms>`.
Projects written in C# using Godot 4 have experimental support for Android and iOS since 4.2,
and for the web platform since 4.5. See :ref:`doc_c_sharp_platforms` for more information.

.. note::

Expand Down
11 changes: 8 additions & 3 deletions tutorials/scripting/c_sharp/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ C# platform support
See `supported OS <https://github.com/dotnet/core/tree/main/release-notes#supported-os>`_.

Since Godot 4.2, projects written in C# support all desktop platforms (Windows, Linux,
and macOS), as well as Android and iOS.
and macOS), as well as Android and iOS. And since 4.5, web is supported too.

Android support is currently experimental.

Expand All @@ -67,5 +67,10 @@ iOS support is currently experimental and has a few limitations.

- Exporting to iOS can only be done from a MacOS device.

Currently, projects written in C# cannot be exported to the web platform. To use C#
on that platform, consider Godot 3 instead.
Web support is currently experimental and has a few limitations.

- The WASM features enabled in the C# project must match the ones enabled by the template used to export the project.

- Globalization is not supported, `invariant mode <https://learn.microsoft.com/en-us/dotnet/core/runtime-config/globalization#invariant-mode>`_ is always enabled on exported games. This does not affect Godot's localization features, only .NET APIs.

- .NET APIs implemented using browser APIs (such as cryptography) are not available and may fail in unexpected ways.