Engine/Documentation/Source/Platforms/HTML5/GettingStarted/HTML5GettingStarted.INT.udn

Availability:Public
Title: Getting Started: Developing HTML5 Projects
Crumbs:%ROOT%, Platforms, Platforms/HTML5
Description:Setting up for development for the HTML5 platform.
Version: 4.11
SkillLevel: Intermediate
type:quick start
parent:Platforms/HTML5
tags:HTML5


[REGION:todo]
The HTML5 pipeline is currently experimental. Some projects may not run properly when built for the HTML5 platform. Expect some rough edges.
[/REGION:todo]

HTML5 uses the [emscripten](http://kripken.github.io/emscripten-site/) tool chain from [Mozilla](https://www.mozilla.org/en-US/) to cross-compile C++ into Javascript. In versions 4.9 and later, emscripten and python are included in the engine distribution.
You can find them in `Engine/Source/ThirdParty/HTML5/emsdk/`, but no configuration or additional installation is required to deploy to HTML5. 

A 64-bit browser is currently required to run HTML5 builds.

* [Download Firefox nightlies](ftp://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-mozilla-central/)
* [Download Chromium builds](http://chromium.woolyss.com/#windows-64-bit)


Once they are installed, you can select the browser to [launch your map](Engine/Deployment/Launching) in from the **Launch** dropdown menu. 
![](LaunchNightly.png)

**To test a [packaged HTML5 project](Engine/Basics/Projects/Packaging):**
1. Select **HTML5**  from the **Package Project** fly-out menu. 
1. Once the project has packaged, open the destination location and run  **HTML5LaunchHelper**.
1. Note the localhost address from this window.
	![](localhostinfo.png)
1. Open `[Localhost Address]/[ProjectName].html` in your 64-bit browser. For example, `http://localhost:8000/MyProject.html` using the above localhost address with a project named `MyProject`.
TypoCorrection [CL 2641563 by Sungjin Hong in Main branch] 2015-08-02 23:50:14 -04:00			`Availability:Public`
Include documentation source in repository. [CL 2489162 by Ben Marsh in Main branch] 2015-03-24 08:35:52 -04:00			`Title: Getting Started: Developing HTML5 Projects`
			`Crumbs:%ROOT%, Platforms, Platforms/HTML5`
			`Description:Setting up for development for the HTML5 platform.`
Initial merge of //depot/UE4/Engine/Documentation/... to //UE4/Main/Engine/Documentation/... #rb none [CL 3011129 by Jeff Wilson in Main branch] 2016-06-13 13:06:55 -04:00			`Version: 4.11`
Merge doc changes from //depot/UE4 to try to fix CIS [CL 2749579 by Nick Penwarden in Main branch] 2015-11-01 06:09:18 -05:00			`SkillLevel: Intermediate`
Copying //UE4/Dev-Documentation to Samples-Main (//UE4/Samples-Main) #rb none #lockdown Nick.Penwarden [CL 3239839 by Ben Marsh in Main branch] 2016-12-19 13:09:22 -05:00			`type:quick start`
Initial merge of //depot/UE4/Engine/Documentation/... to //UE4/Main/Engine/Documentation/... #rb none [CL 3011129 by Jeff Wilson in Main branch] 2016-06-13 13:06:55 -04:00			`parent:Platforms/HTML5`
			`tags:HTML5`
Include documentation source in repository. [CL 2489162 by Ben Marsh in Main branch] 2015-03-24 08:35:52 -04:00

			`[REGION:todo]`
			`The HTML5 pipeline is currently experimental. Some projects may not run properly when built for the HTML5 platform. Expect some rough edges.`
			`[/REGION:todo]`

Initial merge of //depot/UE4/Engine/Documentation/... to //UE4/Main/Engine/Documentation/... #rb none [CL 3011129 by Jeff Wilson in Main branch] 2016-06-13 13:06:55 -04:00			`HTML5 uses the [emscripten](http://kripken.github.io/emscripten-site/) tool chain from [Mozilla](https://www.mozilla.org/en-US/) to cross-compile C++ into Javascript. In versions 4.9 and later, emscripten and python are included in the engine distribution.`
			You can find them in `Engine/Source/ThirdParty/HTML5/emsdk/`, but no configuration or additional installation is required to deploy to HTML5.
Include documentation source in repository. [CL 2489162 by Ben Marsh in Main branch] 2015-03-24 08:35:52 -04:00
			`A 64-bit browser is currently required to run HTML5 builds.`

			`* [Download Firefox nightlies](ftp://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-mozilla-central/)`
			`* [Download Chromium builds](http://chromium.woolyss.com/#windows-64-bit)`

#UE4 DOCS: changed encoding on the files from UTF8 to UTF8 with out BOM [CL 2590930 by Ian Shadden in Main branch] 2015-06-17 17:00:51 -04:00
Initial merge of //depot/UE4/Engine/Documentation/... to //UE4/Main/Engine/Documentation/... #rb none [CL 3011129 by Jeff Wilson in Main branch] 2016-06-13 13:06:55 -04:00			`Once they are installed, you can select the browser to [launch your map](Engine/Deployment/Launching) in from the Launch dropdown menu.`
			`![](LaunchNightly.png)`
#UE4 DOCS: changed encoding on the files from UTF8 to UTF8 with out BOM [CL 2590930 by Ian Shadden in Main branch] 2015-06-17 17:00:51 -04:00
Initial merge of //depot/UE4/Engine/Documentation/... to //UE4/Main/Engine/Documentation/... #rb none [CL 3011129 by Jeff Wilson in Main branch] 2016-06-13 13:06:55 -04:00			`To test a [packaged HTML5 project](Engine/Basics/Projects/Packaging):`
			`1. Select HTML5 from the Package Project fly-out menu.`
			`1. Once the project has packaged, open the destination location and run HTML5LaunchHelper.`
			`1. Note the localhost address from this window.`
			`![](localhostinfo.png)`
			1. Open `[Localhost Address]/[ProjectName].html` in your 64-bit browser. For example, `http://localhost:8000/MyProject.html` using the above localhost address with a project named `MyProject`.