wprestaurantapp/release_notes.txt

Diner Silverlight v1.4
======================

This example application demonstrates how to build a simple application based 
on panorama control for Windows Phone using Microsoft Silverlight.

The example has been developed with Silverlight for Windows Phone devices
and tested to work on Windows Phone 7 and Windows Phone 8.

Support for Windows Phone 8 was made according to guidelines given in article
http://www.developer.nokia.com/Resources/Library/Lumia/#!co-development-and-porting-guide.html.
The solution consists of two top-level projects sharing the same source 
code, one targeting WP 7 and the other targeting WP 8. Bing Maps control is 
used in WP 7 project and the new Map control introduced in Windows Phone is
used in WP 8 project.

This example application is hosted in Nokia Developer Projects:
- http://projects.developer.nokia.com/wprestaurantapp

For more information on implementation and porting, visit the wiki pages:
- http://projects.developer.nokia.com/wprestaurantapp/wiki
- http://projects.developer.nokia.com/wprestaurantapp/wiki/porting


What's new
----------

Version 1.4.0: Using Pushpin from WPToolkit for WP 8.


1. Usage
-------------------------------------------------------------------------------

This is a simple build-and-run solution.


2. Prerequisites
-------------------------------------------------------------------------------

- C# basics
- Windows 8
- Microsoft Visual Studio Express for Windows Phone 2012
- NuGet 2.1 (https://nuget.org/), Visual Studio extension to install and update
  third-party libraries and tools in Visual Studio


3. Project structure and implementation
-------------------------------------------------------------------------------

3.1 Folders
-----------

 |                  The root folder contains the project file, the license 
 |                  information, and this file (release_notes.txt).
 |
 |- wprestaurantapp_wp7      Root folder for Windows Phone 7 specific project.
 |  |
 |  |- content               Graphic files.
 |  |
 |  |- Properties            Application property files.
 |  |
 |  |- SampleData            Sample data file.
 |  |
 |  |- ViewModels            ViewModel implementation files.
 |
 |- wprestaurantapp_wp8      Root folder for Windows Phone 8 specific project.
 |  |
 |  |- Properties            Application property files.


3.2 Important files and classes
-------------------------------

| File                           | Description                                |
|--------------------------------|--------------------------------------------|
| MainPage.xaml.cs               | Class responsible for displaying the       |
|                                | panorama view of the application.          |
|--------------------------------|--------------------------------------------|
| MainViewModel.cs               | Class responsible for loading restaurant   |
|                                | data from disc.                            |
|--------------------------------|--------------------------------------------|
| RestaurantData.cs              | Class describing the restaurant properties |
|                                | shown.                                     |
|--------------------------------|--------------------------------------------|

3.3 Used APIs/Windows Phone Components
--------------------------------------

Microsoft.Phone.Controls.Panorama
Microsoft.Phone.Controls.Pivot
Microsoft.Phone.Controls.Maps.Map (WP7)
Microsoft.Phone.Maps.Controls.Map (WP8)


4. Compatibility
-------------------------------------------------------------------------------

- Windows Phone 7 & Windows Phone 8

Tested on:
- Samsung Omnia 7
- Nokia Lumia 820
- Nokia Lumia 920

Developed with:
- Microsoft Visual Studio Express 2012 for Windows Phone

4.1 Required Capabilities
-------------------------

ID_CAP_MAP (WP8)
ID_CAP_NETWORKING


4.2 Known Issues
----------------

None.


5. Building, installing, and running the application
-------------------------------------------------------------------------------

5.1 Preparations
----------------

Make sure you have the following installed:
 * Windows 8
 * Windows Phone SDK 8.0
 * Silverlight Toolkit for Windows Phone 8 SDK Development
 * NuGet 2.1 (https://nuget.org/), Visual Studio extension to install and 
   update third-party libraries and tools in Visual Studio

5.2 Using the WINDOWS PHONE 8 SDK
---------------------------------

1. Open the SLN file:
   File > Open Project, select the file wprestaurantapp.sln
2. Install Silverlight Toolkit for the project. 
   - Open the Package Manager in Visual Studio: 
      Tools -> Library Package Manager -> Package Manager Console
   - Select wprestaurantapp_WP75 as Default project in Package Manager Console
   - Enter installation command to console: PM> Install-Package WPToolkit
   - Select wprestaurantapp_WP8 as Default project in Package Manager Console
   - Enter installation command to console: PM> Install-Package WPToolkit
   - Confirm that WP8 project uses correct Windows Phone Toolkit version:
     - Open wprestaurantapp_WP8.csproj file in your favorite editor
     - If the file contains a line like this (referring to WP 7 Toolkit)
       <HintPath>..\packages\WPtoolkit.4.2012.10.30\lib\sl4-windowsphone71\Microsoft.Phone.Controls.Toolkit.dll</HintPath>
       edit the line to refer to the WP 8 Toolkit
       <HintPath>..\packages\WPtoolkit.4.2012.10.30\lib\wp8\Microsoft.Phone...
3. Depending on whether you want to run the WP7 or WP8 version of the 
   application, select either wprestaurantapp_WP7 or wprestaurantapp_WP8 as 
   a StartUp Project.
4. Press F5 to build the project and run it on the Windows Phone Emulator.

5.3 Deploying to Windows Phone 8
--------------------------------

Please see the official documentation for deploying and testing applications on
Windows Phone devices:
http://msdn.microsoft.com/en-us/library/gg588378(v=vs.92).aspx


6. License
-------------------------------------------------------------------------------

See the license text file delivered with this project. The license file is also
available online at
http://projects.developer.nokia.com/mapexplorer/browser/trunk/Licence.txt


7. Related documentation
-------------------------------------------------------------------------------

Learn About Windows Phone Development:
http://msdn.microsoft.com/en-us/ff380145

Windows Phone Dev Center:
http://dev.windowsphone.com/en-us


8. Version history
-------------------------------------------------------------------------------

1.4.0  Using Pushpin from WPToolkit for WP 8.
1.3.0  Support for Windows Phone 8.
1.2.0  Bug fixes and changes based on reviews; published on the Nokia Developer 
       website.
1.1.1  Support for Windows Phone OS version 7.1.
1.1.0  New feature: modifying existing reservations.
1.0.0  First version.