Embedded Resources on WebGL

.NET assemblies can contain embedded resources. An embedded resource is a collection of binary data that is part of the .NET assembly. You can access this binary data in code via a file-like API.

By default, WebGL builds don’t include embedded resources. This helps to keep the size of the final binary lower, because embedded resources can be rather large. However, some user code and .NET class library APIs depend on the presence of embedded resources to work properly. For example, string comparisons that use the StringComparison.InvariantCultureIgnoreCase value use embedded resources when comparing non-ASCII characters.

You can use the following Editor script to enable embedded resources for a WebGL build:

using UnityEditor;

public class WebGLEditorScript
{
    [MenuItem("WebGL/Enable Embedded Resources")]
    public static void EnableErrorMessageTesting()
    {
        PlayerSettings.SetPropertyBool("useEmbeddedResources", true, BuildTargetGroup.WebGL);
    }
}

When this Player setting is enabled, the WebGL build includes any embedded resources in any .NET assemblies the Project uses.

• 2019–06–12 Page published with editorial review