Export (0) Print
Expand All

Deploying Only One Application on Surface

By default, the Microsoft Surface software uses the Launcher menu and access points to enable users to open and navigate between multiple Surface applications. However, sometimes you might want to deploy only one application to a device made for Surface. In this scenario, the device made for Surface behaves like a single-purpose system and the Launcher menu and access points are unnecessary.

To achieve this scenario, you can enable single-application mode so that only one specified application runs on a device made for Surface. In single-application mode, the specified application starts immediately and the Launcher menu and access points are disabled, which enables the specified application to be the complete user experience. You can use any Surface application as the specified application for single-application mode.

noteNote
You cannot use a service application for single-application mode.

The XML registration file for an application in single-application mode is the same as the typical application XML registration file. You register applications that you want to use for single-application mode the same way you register any application with Surface Shell. For more information about registering applications with Surface Shell, see Registering a Surface Application with Surface Shell.

The easiest way to configure a device made for Surface for single-application mode is by using Surface Configuration Editor, a tool with a graphical user interface that automatically sets the appropriate registry entries. Surface Configuration Editor can enable or disable single-application mode on a device made for Surface. You can also use Surface Configuration Editor to configure the time period used to track how many times the application can restart before it enters an out-of-order state. To set other optional configuration properties, you must set the appropriate registry entries, which are listed in the following "Tip."

TipTip
If you prefer to manually set the registry entries to configure single-application mode, see the Surface Registry Keys reference, and search for the SingleAppMode and SingleAppApplication registry entries, which are the only required registry entries to enable single-application mode. InitialOrientation, SingleAppRestartQuota, SingleAppRestartPeriod, and SingleAppLoadingScreenTimeout are optional properties you can set to configure single-application mode. InitialOrientation, SingleAppRestartQuota, and SingleAppLoadingScreenTimeout can only be customized by modifying the registry entries.

Turning Single-Application Mode On or Off by Using Surface Configuration Editor

Before you begin configuring Surface, make sure the application you want to use for single-application mode is registered with Surface Shell. For more information about registering an application, see Registering a Surface Application with Surface Shell.

To turn on single-application mode

  1. In Windows mode, click Start, click All Programs, click Microsoft Surface 2.0, and then click Surface Configuration Editor.

  2. In the left pane, click Single-Application Mode

  3. In the Single-Application Mode pane, under Turn on single-application mode, click Yes.

  4. Under Choose the application, select one of the applications. All applications that are registered with Surface Shell appear in the list.

  5. Under Application restart period, move the slider to the right or left to set.

    The application restart period is the time period used to track an application restart. For example, if the application restart period is 600 seconds (10 minutes), the application will restart a maximum of two times within the 10-minute period. If the application attempts to restart itself more than two times during the application restart period, the device made for Surface will enter the out-of-order state. If you would like to increase the number of times an application can restart within the application restart period, you can modify the SingleAppRestartQuota registry entry. For more information, see the Surface Registry Keys reference, and search for SingleAppRestartQuota.

  6. Click OK to save your settings and close Surface Configuration Editor, or click Apply to save your settings and continue configuring Surface. Restart Surface Shell for your settings to take effect.

To turn off single-application mode

  1. In Windows mode, click Start, click All Programs, click Microsoft Surface 2.0, and then click Surface Configuration Editor.

  2. In the left pane, click Single-Application Mode.

  3. In the Single-Application Mode pane, under Turn on single-application mode, click No.

  4. Click OK to save your setting and close Surface Configuration Editor, or click Apply to save your setting and continue configuring Surface. Restart Surface Shell for your settings to take effect.

Did you find this information useful? Please send us your suggestions and comments.

© 2011 Microsoft Corporation. All rights reserved.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft