If your developing a new Windows 8 app and you want to test it on another device (e.g. Surface), you’ll need to use a technique called sideloading. This can easily be done through a few steps that I’ll describe in this post.
Windows 8 Store Apps are deployed through the Windows Store. This may seem like an obvious statement. However, by default, only Windows Store apps are permitted to install and run on Windows 8. When you install an app from the Windows Store, a Windows Store signed app package is downloaded and installed on your machine. Since only Windows Store signed apps are permitted to be executed on Windows 8, it greatly reduces the introduction of malware. For development and enterprise scenarios, you can use a technique called sideloading to install and run apps that are not Windows Store signed. I’ll cover development sideloading in this post. If you are interested in how to use sideloading for line of business apps in an enterprise, please see this post.
Development sideloading is used by Visual Studio to deploy, debug and test your app.
The general requirements for sideloading are:
On a development machine, these requirements are automatically met for you by Visual Studio. Visual Studio provides a self-signing test certificate that is used to sign the package. Also, when Visual Studio is installed, a registry key is set to allow trusted apps to run. Therefore, when you debug a Windows 8 Store app using Visual Studio, the app is test certificate signed, deployed, and allowed to run.
In order to deploy an app, you need an App Package. Visual Studio has functionality to create an App Package you can use to deploy your app to another machine. The following steps are how to create a local App Package.
If we click the link, here is an example of what was created:
Here is a quick summary of the relevant files in the package directory:
Appx package (MyApp_18.104.22.168_AnyCPU_Debug.appx)
The appx package is a zip file of all of the program files for your app. This file gets deployed and installed into Windows. Try renaming the extension to “.zip” and open the zip file to see what is inside. Don’t forget to change it back before you try and deploy it.
Developer test certificate (MyApp_22.214.171.124_AnyCPU_Debug.cer)
This is your development certificate. This is the certificate that was used to sign the appx package.
PowerShell script (Add-AppDevPackage.ps1)
This PowerShell script can be used to install the development certificate and install the App.
Everything you need to deploy the app is included in the package directory created by Visual Studio. I usually copy the directory to a USB memory stick to transfer the app to the target machine. On the target machine, you just need to run the PowerShell script (Add-AppDevPackage.ps1) to deploy the app. You can do this easily by right clicking on the script and selecting “Run with PowerShell”.
The first action performed by the script is to install the certificate. It needs to run elevated in order to perform this step. If PowerShell isn’t running elevated, the script will prompt to start an elevated process to install the certificate.
You will be warned and prompted to allow the certificate to be installed.
Once the certificate is installed, the app package is installed.
Your app should now be installed on the target machine. You should be able to find the tile on the Start screen (usually at the end of the list):
The final requirement is to allow trusted apps to run. If your target machine has Visual Studio installed, this requirement will already be met. However, if you don’t have Visual Studio installed, you can meet the requirement through group policy or setting a registry key. For development purposes, it’s usually easiest to set the registry key.
Your app should now run on the target machine.
One final note… This is the process for development sideloading. There is a more formal process for enterprise sideloading. If you are interested in enterprise sideloading, please start with this post.