在Surface Shell中注册Surface应用程序

    开发人员创建一个新的Microsoft Visual C＃2010（或Microsoft Visual Studio2010）微软Surface应用程序项目时，应用程序会自动创建一个名为ApplicationName.XML（其中ApplicationName是该项目的名称）的XML文件。在部署应用程序时，要先修改XML文件，创建一个XML文件的快捷方式，将快捷方式拷贝到Surface设备的%ProgramData%\Microsoft\Surface\v2.0\Programs目录。

       XML文件保存着Surface程序运行所必须的所有默认信息。

 

默认的XML文件

默认XML文件事例代码如下：

<?xml version="1.0" encoding="utf-8" ?>

<!--

This file contains the information needed to install your application

with Surface Shell. Please refer to the documentation for deployment

instructions.

-->

<ss:ApplicationInfo

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xmlns:ss="http://schemas.microsoft.com/Surface/2007/ApplicationMetadata">

  <Application>

    <Title>SurfaceApplication</Title>

    <Description>SurfaceApplication</Description>

    <ExecutableFile>SurfaceApplication.exe</ExecutableFile>

    <Arguments></Arguments>

    <IconImageFile>Resources\icon.png</IconImageFile> 

 </Application>

</ss:ApplicationInfo>

Surface支持两种类型的应用程序：标准应用程序和服务应用程序。XML文件中使用下列元素来区分这两种类型的应用：

   <Application> 标准应用程序标识.

   <ServiceApplication> 服务应用程序标识.

 

注册标准应用程序

要注册一个标准应用程序，并让它显示在Surface启动界面中，需修改应用程序的XML文件中的以下信息：

XML 词条	XML 语法	说明
Title	<Title>      ApplicationName </Title>	ApplicationName 表示应用程序的标题，在Surface启动界面中显示的应用程序标识。默认为应用程序在Visual C＃2010（或Visual Studio 2010）中的项目名称，编辑这个词条为应用程序取名称。
Description	<Description>    Short description of application </Description>	Description是应用程序的描述，当用户在Surface中选择应用程序时显示。默认为应用程序的项目名称。编辑这个词条为应用程序做描述。 Description最多显示两行文字，多余部分去除。Description文字是左对齐的，如果描述只有2~4个词则看起来会偏离中心。
ExecutableFile	<ExecutableFile>    ApplicationName.exe </ExecutableFile>	ExecutableFile是应用程序的可执行文件名称
Arguments	Empty	参数，空
IconImageFile	<IconImageFile>    Resources\icon.png </IconImageFile>	IconImageFile是应用程序图标，是应用程序在Surface启动界面的图标标识。 注意 图标文件必须是PNG格式，308×190像素大小。

下面的代码是SurfaceSDK中的示例应用程序the Grand Piano sample application的XML文件。

<?xml version="1.0" encoding="utf-8" ?>

<ss:ApplicationInfo

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xmlns:ss="http://schemas.microsoft.com/Surface/2007/ApplicationMetadata">

  <Application>

   <Title>Grand Piano</Title>

   <Description>Tickle the Surface ivories</Description>

   <ExecutableFile>GrandPiano.exe</ExecutableFile>

   <Arguments></Arguments>

   <IconImageFile>Resources\StaticPiano.png</IconImageFile>

  </Application>

</ss:ApplicationInfo>

 

主要事项：

1. 手动复制应用程序XML文件的快捷方式到%ProgramData%\Microsoft\Surface\v2.0\Programs目录，（注意：%ProgramData%是一个隐藏的系统文件夹）

2. 修改XML文件，配置应用程序的路径、图标及在Surface启动界面中显示的名称和描述

3. 如果已复制XML文件而应用程序没有出现在Surface的启动界面，最可能的原因是在XML文件中的错误，请检查事件日志，任何XML文件相关的错误事件日志都记录在Applications and Services Logs/Microsoft/Surface/Shell/Operational目录下。