Pou's IT Life

開發Windows Phone的應用也有些時間，對於WMAppManifest.xml的了解就像Android中的Manifest.xml一樣，

博大精深，需要花一些時間來加以了解。增加對App的掌握度與在送審時可以多注意的部分，因此，以下就介

紹相關WMAppManifest.xml重要的標籤。

〉WMAppManifest.xml 內容結構：

‧範例WMAppManifest.xml：

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

<Deployment xmlns="http://schemas.microsoft.com/windowsphone/2009/deployment" 
     AppPlatformVersion="7.1">

  <App xmlns="" ProductID="{GUID}" Title="[Project Name]" 
       RuntimeType="Silverlight" Version="1.0.0.0" Genre="apps.normal"  
       Author="[Project Name] author" Description="Sample description" 
      Publisher="[Project Name]">
  
    <IconPath IsRelative="true" IsResource="false">ApplicationIcon.jpg</IconPath>

    <Capabilities>
      <Capability Name="ID_CAP_APPOINTMENTS"/>
      <Capability Name="ID_CAP_CAMERA"/>
      <Capability Name="ID_CAP_CONTACTS"/>
      <Capability Name="ID_CAP_GAMERSERVICES"/>
      <Capability Name="ID_CAP_IDENTITY_DEVICE"/>
      <Capability Name="ID_CAP_IDENTITY_USER"/>
      <Capability Name="ID_CAP_ISV_CAMERA"/>
      <Capability Name="ID_CAP_LOCATION"/>
      <Capability Name="ID_CAP_MEDIALIB"/>
      <Capability Name="ID_CAP_MICROPHONE"/>
      <Capability Name="ID_CAP_NETWORKING"/>
      <Capability Name="ID_CAP_PHONEDIALER"/>
      <Capability Name="ID_CAP_PUSH_NOTIFICATION"/>
      <Capability Name="ID_CAP_SENSORS"/>
      <Capability Name="ID_CAP_WEBBROWSERCOMPONENT"/>
      <Capability Name="ID_HW_FRONTCAMERA"/>
    </Capabilities>
   <Requirements>
      <Requirement Name="ID_REQ_MEMORY_90"/>
   </Requirements>

    <Tasks>
      <DefaultTask  Name ="_default" NavigationPage="MainPage.xaml"/>

      <ExtendedTask Name="" NavigationPage="" >
        <BackgroundServiceAgent  Name="" Source="" Specifier="" Type=""/>
      </ExtendedTask>
    </Tasks>

    <Tokens>
      <PrimaryToken TokenID="[Project Name]Token" TaskName="_default">
        <TemplateType5>
          <BackgroundImageURI IsRelative="true" IsResource="false">Background.jpg</BackgroundImageURI>
          <Count>0</Count>
          <Title>[Project Name]</Title>
        </TemplateType5>
      </PrimaryToken>
    </Tokens>

    <Extensions>
      <Extension ConsumerID="" ExtensionName="" ExtraFile="" TaskID="" />
    </Extensions>

  </App>
</Deployment>

上述是大略的繪製出各個標籤之間的結構與順序，以下便說明各標籤中可設定的屬性與意義。

(1) Deployment：

     為整份WMAppManifest.xml的Root標籤，並且指定了發佈的App平台版本，例如：7.0、7.1。

(2) App：

     為Deployment的子元素，定義應用程式的基本資訊，如下：

(3) IconPath：

       屬於App標籤的子元素，定義應用程式出現在Application List清單中的icon識別圖。

       Silverlight應用程式預設值為：ApplicationIcon.png；XNA Framework Games預設值為：PhoneGameThumb.png。

(4) Capabilities：

       屬於App標籤的子元素，Windows Phone提供capabilities-driven security model的模式，讓開發人員在撰寫應用程時，

       需要選擇應用程式主要使用那些特性，這些特性的定義也會影響至用戶設備是否支援，而能否下載。如果沒有設定

       任何Capabilites的話，可能會收到UnauthorizedAccessException error 的訊息。另外，該模式的主要目的為：

       *Ensure proper disclosure：

              如果應用程式的功能有安全性的疑慮，必須告知用戶。讓用戶選擇是否要啟動該功能。例如：推播服務、GPS服務。

       *Decrease the attack surface：

              選擇的特性均被建立於一個安全的Chamber，保持應用程式執行的安全性與支援度。

       往下便來了解在該標籤下的子元素定義了那些特性：

      (4-1) Capability：

                 為Capabilities下的子元素，透過屬性name設定以下的值。

(5) Requirements：

       屬於App的子元素與Capabilities屬於同層次。該標籤是在Windows Phone 7.1 Update之後才有的，用於限定該應用程是需要的硬體資源。

       例如：Application不能Run在256-MB Device上，此時就要設定該標籤。目的在於讓用戶直接在Marketplace就不會看到這個Application，

       避免下載後沒有辦法使用。

       [註] 不過這個標籤並不是必要的，所以沒有加到WMAppManifest.xml也不會影響。

       =>個人猜測Nokia的App有限定Nokia設備，應該也是按照這個規則吧！只是不知道格式是怎麼樣就是了。

       格式：

<Requirements>      
  <Requirement Name="ID_REQ_MEMORY_90"/>   
</Requirements>

(6) Tasks：

      定義應用程式使用的Task項目，包括：Default Task(啟動的Page)、Extension Task(可用的多個Tasks)與搭配Background Agent的定義。

      往下便分別說明這二個項目：

      (6-1). Default Task：

                  定義應用程式預設進入的Page，這可以搭配這兩篇來進行動態更換：<Windows Phone 7 - 動態轉換初始的Default Page>與

                  <WP7 修練 DAY 02：如何在頁面顯示前自動轉向到其他頁面>。

                  主要二個屬性：

      (6-2). ExtendedTask：

                  Tasks中的子元素，也包括了BackgroundServiceAgent元素。該元素定義應用程式可用的多個Tasks。

                  Extended Tasks的命名由開發者自行定義，但現在只能用於定義應用程式中有使用Background tasks。

                 主要二個屬性：

              (6-2-1). BackgroundServiceAgent：

                              定義了相關Background service agent的詳細資訊。

                              主要屬性：

(7) Tokens：

       屬於App下的子元素。每一個應用程式均有一個Tile，用戶可以將它pin在Start Screen上。因此，Tokes即是用於

       定義應用程式Tile的相關資訊，詳細參考<Tiles Overview for Windows Phone>。

       => 記得在董大偉老師有一篇<如何建立長方形的Application Tile動態磚>提到如何定義一個比較寬的Tile也是透過

           定義Tokens裡的標籤，相信在Windows Phone 8裡也是這樣的做法。

       目前只能定義PrimaryToken元素與它內部的TemplateType5元素，往下便加以說明：

       (7-1). PrimaryToken：

                   用於描述應用程式關聯的Tile資訊。主要屬性如下：

       (7-1-1). TemplateType5：

                        屬於PrimaryToken的子元素，它是應用程式預設的Template，控制應用程式的Tile。以下便是它可設定的屬性：

(8) Extensions：

       屬於App下的子元素，用於定義應用程式有支援特定的Extensions。詳細資訊可以參考<Search Extensibility Overview for Windows Phone>，

       詳細的範例，可以參考<Windows Phone 7 – Search Extensibility>與<Windows Phone 7 – Photo Extensibility>的內容。

       主要可設定的屬性如下：

以上是分享相關Windows Phone 7.1 SDK在WMAppManifest.xml定義的參數，這些東西其實在Windows Phone 8 SDK出來後，

將會增加更多新的與詳細的功能，讓應用程式可以做到的任務更多元就讓我們期待往下看看吧。

======

這一篇的內容不會談論太多的程式，因為這一篇是撰寫WP7有一段時間的我不小心忽略它，導致在送審過程中遇到

不少問題時，才又回頭來看這一篇的內容，感覺有很多東西需要寫下來，以免再犯相同的錯誤。希望對大家也有所幫助。

References：

‧Application Manifest File for Windows Phone

‧Getting data out of WP7 WMAppManifest is easy with Coding4Fun PhoneHelper

‧WMAppManifest.xml文件结构说明 & WP7-配置文件WMAppmanifest.xml的介绍

‧WP7 WMAppManifest.xml各个属性作用 & Farseer Physics Engine 3.2 WP7 - WMAppManifest.xml

‧视频:WindowsPhone(WP7)教程：6-WMAppManifest配置

‧Resco MobileLight Toolkit — Sample application & Windows Phone 7 Silverlight Programming - Handling XML Data

‧How to: Determine Application Capabilities (重要)

‧windows phone 开篇(1) & 最后一里路：Windows Phone应用提交完全攻略(转)

‧Introduction to Windows Phone 7 Development