These are the release notes for the RTM release of Windows Phone Developer Tools.
Platforms Not Supported
|Updating applications created with earlier versions of Windows Phone Developer Tools||Changes have been made to the
WMAppManifest.xml and template files. Now that manifest validation has
been turned on, you may need to update these files in your older
projects. A number of the changes are listed here. However, you can also
compare the WmAppManifest.xml, app.xaml and app.xaml.cs files in a new
project to the same files in your old projects to determine what has
changed and then update your old files accordingly.
The following list shows changes you must make to the WmAppManifest.xml file:
The following list shows changes you must make to the App.xaml file:
Note: The recommended option for updating this file is to obtain a copy of the most recent version. Using your old file, copy the information specific to your application (such as, resources) to the new file.
The following list shows changes you must make to the app.xaml.cs file:
|Limit to the number side loading of applications on the phone||Developer phone registration is the process through which a
registered Windows Phone® developer may unlock a retail Windows Phone to
side load applications for development and testing. A limit on the number of side loaded applications that may
concurrently be installed on the phone will be enforced. The default
limit will be 10 applications. Attempts to side load more than 10
applications will result in an error. This limit does not affect
applications installed via Windows Phone® Marketplace.
|XNA Framework assembly references||The public key token
for XNA Framework assemblies has changed. Assembly references in content projects
and game projects created using previous releases of Windows Phone Developer Tools must be updated to work correctly. You can do this by removing and re-adding references that do not resolve
correctly using the References node in the Visual Studio Solution
|Character encoding.||Support for all character encodings will be removed, except for
those in the following list.
Use of an unsupported encoding value in an application will result in
an ArgumentException exception. You must modify
existing applications to remove references to unsupported encoding
values. XML data should specify only supported encodings. For example:
|A GamerPrivilegeException is returned if the user does not have content privileges.||If AllowProfileViewing and
AllowUserCreatedContent flags are not set in a gamer profile,
then the user cannot
view profiles or display the gamer card of another user. The following
methods now check for these privileges and will return
GamerPrivilegeException if the user does not
have these privileges:
|The picture sharing mechanism has changed.||Previously, Windows Phone® 7 would place
the picture into the Isolated Storage of the application. The
picture would then be loaded when the application was launched. Now,
when the application is launched, it is passed a string token. To
retrieve the picture, the application calls the
GetPictureFromToken() method, public static
Picture GetPictureFromToken(string token), which takes the token
as a parameter and returns a Picture object. You will need to update
The following code example illustrates how to use the GetPictureFromToken method to retrieve a photo. For more information see, How to: Create a Photo Extras Application for Windows Phone:
|Deployment and debugging.||While deploying or debugging, if you get the following error:
“Application could not be launched for debugging”. First, verify that
the application is installed on the target device and that there is no splash screen in the project. Then, uninstall the application and in
Visual Studio perform the following steps:
|Installation on Windows Vista.||Windows Phone Developer Tools setup blocks installation on Windows Vista and forces the user to install Windows Vista SP2.
On Windows Vista SP2, the four updates that are a part of
KB 971644 are also required to support deployment to the Windows Phone Emulator.
The following updates referenced in KB 971644 are required for Windows Vista x86-based systems:
The DirectX Caps Viewer Tool can be used to determine if a graphics card supports DirectX 10 or later and if a WDDM 1.1 driver is installed. This tool is available for download via the DirectX SDK.To determine if a graphics card supports DirectX 10 or later, perform the following steps:
If you see this error message and your graphics card is DirectX 10 capable as reported by the DirectX Caps Viewer Tool, you should refer to the web site for the manufacturer of the graphics card to see if a newer driver is available.On Windows Vista SP2, the four updates that are a part of KB 971644 are also required to support deployment to the Windows Phone Emulator.
Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.
Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.
© 2010 Microsoft Corporation. All rights reserved.
Microsoft Direct3D, DirectX, Expression, Expression Blend, Hyper-V, Internet Explorer,MSDN, Silverlight, Visual Studio, Windows, Windows Phone, Windows Server, Windows Vista, Xbox, Xbox 360, Xbox LIVE, XNA, and Zune are trademarks of the Microsoft group of companies.
All other trademarks are property of their respective owners.