Files
Nick Shin 297f3660a1 HTML5 - fix log spam
replicated to //UE4/Release-4.22

#jira UE-68969  HTML5 logspam when packaging/launching: NOTE[ReadEmscriptenConfigFile]: using EM_CONFIG
#rb none
#rnx

[CL 4890103 by Nick Shin in 4.22 branch]
2019-02-04 15:00:51 -05:00
..
2019-02-04 15:00:51 -05:00

The files in this folder are all the files you need to upload to your web server.


The following will help explain what kinds of files these are.


Development Build
=================

Packaging "Dewelopment" builds:
	* Only uncompressed files are built
	* Jump down to "Local Testing" to test your project


Shipping Build
==============

Packaging "Shipping" builds:
	* Can be built with or without uncompressed files
	* Jump down to "Local Testing" to test your project

To package "Shipping" build with "compression" enabled, set the following option in UE4Editor:
		Project Settings ->
		Platforms ->
		HTML5 ->
		Packaging ->
		Compress files during shipping packaging



Non-Compressed Files
====================
Use this settings (available on Development or Shipping builds) for the best results on being able to server your project from most web host providers.

	Files Required for Non-Compressed Files Deployment
	--------------------------------------------------
	<project>.js         - main project Javascript code
	<project>.wasm       - main game code
	<project>.data       - game content
	<project>.data.js    - game content Javascript driver
	<project>.html       - landing page
	<project>.symbols    - symbols (optional: used with debugging)
	Utility.js           - utility Javascript code
	.htaccess            - "distributed configuration file"


Compressed Files (Advanced option)
================
Use this setting (only available on Shipping builds) if you need to help make your project downloads smaller.

	* NOTE: We recommend you smash your texture sizes for the best results -- this may be enough to NOT require using the compression option.
		+ For more information on how to do this, see:
			> https://docs.unrealengine.com/latest/INT/Platforms/Mobile/Textures/
			> For HTML5, try setting Max LOD Size to 256 and go up from there to ensure quality and download size are acceptable.


If you are an advanced web server administrator:
	* Using compression helps improve download times.
	* Using pre-compressed files may help your web server from compressing the files dynamically everytime the time your project is loaded on to a browser.
	* NOTE: Being able to serve pre-compressed files will require configuring your web server to properly serve the UE4 compressed file extention type.
		+ These settings are placed in the .htaccess file
			> This file will work on most Apache web servers (that have the AllowOveride option set to (e.g.) All).
		+ AGAIN, if you are reading this section, we assume you have a deep understanding of web server technology.
			> This is not for beginners.

	Files Required for Compressed Files Deployment - in addition to the Non-Compressed Files (listed above)
	----------------------------------------------
	<project>.jsgz         - compressed main project Javascript code
	<project>.wasmgz       - compressed main game code
	<project>.datagz       - compressed game content
	<project>.data.jsgz    - compressed game content Javascript driver
	<project>.symbolsgz    - compressed symbols (optional: used with debugging)
	Utility.jsgz           - compressed utility Javascript code


Files not needed for Deployment - these are normally used during developement
===============================
	HTML5LaunchHelper.exe            - see Local Testing below
	RunMacHTML5LaunchHelper.command  - see Local Testing below
	Readme.txt                       - this Readme file




Local Testing
=============

	UE4's test web server
	---------------------
	Run HTML5Launcher.exe (on windows) or RunMacHTML5LaunchHelper.command (on Mac) to start a web sever which is configured to serve compressed files on localhost.
	* This is NOT a production quality server.
	* Add -ServerPort=XXXX to the command line if necessary to change the serving port.
		> Default port is 8000.
	

	Python web server
	-----------------
	You may use python's built in web server, e.g.:
	* (make sure you run the following command from the same path this Readme and <project>.html files are located)
		python -m SimpleHTTPServer 8000


	Apache web server
	-----------------
	OSX and Linux normally have Apache installed.
	* You can use that for testing which has the closest behavior to most web host providers.