Building your WebGL application

To create a build for WebGL, go to File > Build Settings from Unity’s main menu. In the Platform list, select WebGL and then click Switch Platform.

When you have configured the Build Settings, choose from the following two options:

• Build builds your application into a Player.
• Build and Run builds your application in a Player, and opens that Player on your target platform.

The Unity build system for WebGL supports the following settings:

For changing the settings for Asset Import Overrides, see Build Settings.

Build Folder

The Build folder contains the following files ([ExampleBuild] represents the name of the target build folder).

如果对构建启用某种压缩方法，Unity 会识别与压缩方法对应的扩展名，并将此扩展名添加到 Build 子文件夹中的文件的名称中。如果启用 Decompression Fallback，Unity 将扩展名 .unityweb 附加到构建文件名。否则，Unity 为 Gzip 压缩方法附加扩展名 .gz，或者为 Brotli 压缩方法附加扩展名 .br。 有关更多信息，请参阅 WebGL：压缩构建和服务器配置。

If you enable Name Files As Hashes in the Player Settings, Unity uses the hash of the file content instead of the default filename. This applies to each file in the build folder. This option allows you to upload updated versions of the game builds into the same folder on the server, and only upload the files which have changed between build iterations.

Note: Opening a Player directly from the file system might not work in some browsers due to security restrictions applied to local file URLs.

Deep Profiling Support

启用 Deep Profiling Support 设置可使 Unity Profiler 对应用程序中的每次函数调用都进行性能分析。如需了解更多信息，请参阅有关深度性能分析的文档。

播放器设置 (Player settings)

WebGL 在 Player 设置（菜单：Edit > Project Settings，然后选择 Player 类别）中有一些其他选项。

Other Settings

Strip Engine Code

打开 Other Settings 访问 Strip Engine Code 选项。默认情况下会选中此选项以启用 WebGL 的代码剥离。选中此选项后，Unity 不会包含未使用的任何类的代码。例如，如果不使用任何物理组件或函数，则会从构建中删除整个物理引擎。有关更多详细信息，请参阅下面的“剥离”部分。

Publishing Settings

Enable Exceptions

• Open Publishing Settings to access Enable Exceptions. Enable Exceptions allows you to specify how to handle unexpected code behavior (generally considered errors) at run time. It has these options:

  • None：如果不需要任何异常支持，请选择此选项。此选项可提供最佳性能和最小构建。使用此选项，抛出的任何异常都会导致内容因该设置中的错误而停止。
  • Explicitly Thrown Exceptions Only（默认设置）：选择此选项可捕获从脚本中的 throw 语句显式指定的异常，并可确保调用 finally 代码块。请注意，选择此选项会使脚本中生成的 JavaScript 代码变得更长且更慢；仅当脚本是项目的主要瓶颈时，这才会成为问题。
  • Full Without Stacktrace：选择此选项可捕获：
  • 从脚本中的 throw 语句显式指定的异常（与 Explicitly Thrown Exceptions Only 选项一样）
  • Null 引用
  • 越界数组访问
  • Full With Stacktrace：此选项与上面的选项类似，但也捕获堆栈跟踪。Unity 通过在代码中嵌入对异常检查来生成这些异常，因此该选项会降低性能并增加浏览器内存使用量。仅用于调试，并始终在 64 位浏览器中进行测试。

• Select Publishing Settings to access Data Caching.

数据缓存

To access Data Caching, go to Publishing Setings via File > Build Settings > Player Settings > WebGL. This enables the browser to cache the main data files into the IndexedDB database.

Using the default browser HTTP cache doesn’t guarantee that the browser caches a particular response. This is because the browser HTTP cache has limited space, and the browser might not be able to cache large files.

To improve your loading speed, IndexedDB allows you to cache files above the browser limit. When you cache more files, you increase the chance that downloaded content is available on the user’s machine during the next run of the build.

Data Caching caches the .data files in the IndexedDB cache for HTTP responses. To cache AssetBundles, you need to enable Data Caching and override unityInstance.Module.cacheControl(). To do this, make sure Module.cacheControl(url) returns must-revalidate for the requested AssetBundle URL. For example, you can override the unityInstance.Module.cacheControl() function in the fulfillment callback of the Promise that createUnityInstance() returns. For information on createUnityInstance(), see Compressed builds and server configuration.

• 在 Unity 2019.1 中删除了 asm.js 链接器目标
• Unity 2020.1 中添加了构建文件更新和数据缓存