In this article, we present instructions for developers wishing to deploy Enyo applications to PCs and tablets running Windows 8, via the Windows Store.
In order to build and test your Enyo application for Windows 8, you will first need the following:
Build your Enyo application using the Bootplate template, as described here.
Open Visual Studio and select File > New Project.
Your project structure will be built with your main page named
Change the name of this file to
index.html to match your Enyo application.
In the Solution Explorer on the right-hand side of the screen,
package.appxmanifest file to open it. You will see a
field labeled Start Page. Update this field value to match your
index.html starting page.
Your project will include
js folders by default. Feel free to
delete these from the project.
Copy your Enyo bootplate app into your Visual Studio project structure. Make sure that your application files are included in the project by right-clicking on your files and folders and selecting the Include in Project contextual menu item.
Replace your project's
index.html file with the
index.html from your
Bootplate app, or else edit it to look like the following:
<!DOCTYPE html> <html> <head> <meta http-equiv="X-UA-Compatible" content="IE=edge"/> <meta charset="utf-8" /> <title>Enyo 2 Sampler</title> <!-- css --> <link href="build/enyo.css" rel="stylesheet"/> <link href="build/app.css" rel="stylesheet"/> <!-- js --> <script src="build/enyo.js"></script> <script src="build/app.js"></script> </head> <body class="enyo-unselectable"> <script> new App().renderInto(document.body); </script> </body> </html>
In Visual Studio, select Debug > Start Debugging to build and debug your project on your local PC.
First, install Remote Tools for Visual Studio 2012 on your Microsoft Surface.
On the Surface, open Internet Explorer and navigate to http://www.microsoft.com/visualstudio/eng/downloads#d-additional-software.
Select the item Remote Tools for Visual Studio 2012.
Download and install the Remote Tools for Visual Studio 2012 (ARM) – English.
Then, launch and configure the debugger that you just installed.
On your Surface, open the Remote Debugger application. (Note that it will open in the PC environment.)
Select Tools > Options.
Select No Authentication and ensure that Allow any user to debug is checked. (You may need to set authentication based on your network situation.)
Make sure that your computer and your Surface are on the same network. In Visual Studio, select Remote Machine as your debug/build target.
Once Remote Machine is selected, you should be able to locate your Surface on the network.
It's also possible to install the Enyo Sampler app on your Windows 8 PC or
tablet. To do so, you'll need to download the built app (in an archive called
ProjectOutputFolder ... .zip), from the Dropbox file sharing service.
To obtain the file from Dropbox, download the latest file from this folder: https://www.dropbox.com/sh/naqmwywkrzyfn9y/AACpddyXRBiI6QfvZgQRdmG3a
Once you have the file, unzip it and open the resulting folder
ProjectOutputFolder) in Explorer. Then do the following:
Navigate to the folder called
Add-AppDevPackage.ps1 file and select Run with PowerShell.
If the PowerShell window flashes and disappears:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted.
(For more information on installing app packages in Windows 8, see http://msdn.microsoft.com/en-us/library/windows/apps/hh975356.aspx.)
If you are prompted to acquire a Developer License, answer Y and use these credentials:
user: firstname.lastname@example.org pass: olympus
If you are prompted to install a local certificate, answer Y.
The installation script should proceed until it says
Press Start, swipe all the way to the right and find the Enyo Sampler app; tap or click it to launch.