Merge pull request #39 from Adrotator/packagingFix

Packaging fix

AdRotatorNuGetPackager/Package.nuspec

@@ -13,17 +13,18 @@
         <description>An AdRotator control for Windows 8 / Windows Phone to support multiple Ad Providers in your apps / games
 
 Supports:
-* Windows Phone 7/8
+* Windows Phone 7 / 8 / 8.1
 * Windows 8 / 8.1
+* Windows Universal Apps
 * Unity V4+ (WP8 + Win8)
 
 Includes the ability to configure supported ad providers from within the solution or remotely to allow re-configuration without re-libing.
 
 Be sure to read the included readme for installation instructions
 
 Full documentation available at http://getadrotaor.com</description>
-        <summary>the ultimate Ad Rotating solution to manage all your Ad Providers</summary>
-        <releaseNotes>Patch release to resolve an unwanted exception from missing or bad provider dll's
+        <summary>The ultimate Ad Rotating solution to manage all your Advertising Providers</summary>
+        <releaseNotes>Updated to fully support Win 8.1 / WP 8.1 and Universal apps
 		See the releaseNotes.txt or GetAdRotator.com for more details of improvements</releaseNotes>
         <copyright>Copyright  2013</copyright>
         <language>en-GB</language>

AdRotatorNuGetPackager/content/ReadMe-AdRotator-XAML.txt

@@ -1,38 +1,39 @@
-Welcome to AdRotator for XAML projects includng Windows 8 and Windows Phone Silverlight
+Welcome to AdRotator for XAML projects including Windows 8/8.1, Windows Phone 8.1, Universal and Windows Phone Silverlight
 
 Included in this package is:
 
 * This Readme :D
 * ReleaseNotes
 * AdRotator DLL's
 * Sample "DefaultAdSetings.XML" configuration file
+* Notice on WinRT projects (Win 8, 8.1, WP 8.1 & Universal apps)
+* Unity installation instructions - Jump to the end of this readme
 
 **Note
-We no longer include Ad Provider specific DLL's, you need to obtain the latest version from each provider, here is a list of Provider Dev pages:
-(Except AdDuplex as they provide a NuGet package it is included by default)
+We no longer include Ad Provider specific DLL's, you need to obtain the latest version from each provider.
+Here is a list of Provider Dev pages:
 
 * PubCenter - (Win8) http://go.microsoft.com/fwlink/p/?LinkID=285861 (WP) Inc with Windows Phone SDK **See notes below
+(Direct links to MS Ad SDK's - WP http://bit.ly/MSAdSDKWP8 & Windows 8/8.1 http://bit.ly/MSAdSDK81)
 * Smaato - http://www.smaato.com/sdks/
 * MobFox - (Contact Mobfox)
 * AdMob - https://developers.google.com/mobile-ads-sdk/download
 * Innerative - https://console.inner-active.com/iamp/wiki (need to be logged in)
 * Inmobi - http://www.inmobi.com/developers/download-center/
 * DefaulthouseAds - Build your own :D
+* None, disable AdRotator remotely through the configuration file
 
 ---
-**At this time we have not tested AdRotator with Universal projects, please feed back any issues to the GitHub page - https://github.com/Adrotator/AdrotatorV2
-
-
 To implement this control add the following XAML to your project:
-Add a custom namespace to the AdRotator Control, e.g.:
+Add a custom namespace to the XAML page you want to display AdRotator on, e.g.:
 	<!--Windows Phone -->
 	xmlns:adRotator="clr-namespace:AdRotator;assembly=AdRotator"
 
-	<!--Windows 8 -->
+	<!--Windows 8, 8.1, WP8.1 and Universal projects -->
 	xmlns:adRotator="using:AdRotator"
 
 Then add the control to your page:
-(We recommend using a UserControl in your project for implementation especially if you intend to use it on several pages)
+(We recommend embedding AdRotator in a UserControl for your project for implementation, especially if you intend to use it on several pages)
 
 	<adRotator:AdRotatorControl 
 		x:Name="MyAdRotatorControl"
@@ -42,40 +43,45 @@ Then add the control to your page:
 		RemoteSettingsLocation="http://<your site here>/defaultAdSettings.xml"
 		AutoStartAds="True" />
 
-A default config XML file is added for you with this project with the correct Build action and copy options, just update the configuration appropriate to your installation.
+A default configuration XML file is added for you with this project, with the correct Build action and copy options, just update the configuration appropriate to your installation.
 
-If you add it manually on Windows Phone, set the build action of the config file to "Content" and use the configuration above 
+If you add your configuration file manually on Windows Phone, set the build action of the config file to "Content" and use the configuration above 
 AdRotator at this time does NOT support relative paths so the local configuration must be deployed in he project, for example
 
 	DefaultSettingsFileUri="/<project assembly name>;component/defaultAdSettings.xml" <-- Not supported
 
-If you need to share a configuration file between projects then "Link" the configuration file from a central folder or just use remote configuration.
+If you need to share a configuration file between projects then "Link" the configuration file in the solution explorer, from a central folder or just use remote configuration.
 
-Lastly configure the XML configuration file (optionally host it on the web to allow remote configuration) for your Ad Provider settings or alternatively set the providers in the XAML
+Lastly, configure the XML configuration file (optionally host it on the web to allow remote configuration) for your Ad Provider settings or alternatively set the providers in the XAML
 
 For more instructions on how to implement this control and all the other configuration options checkout the AdRotator host site
 http://getadrotator.com
 
-** PubCenter and AdDuplex support for Windows 8
-In order to support WinRT controls on Windows 8, like those now used by PubCenter and AdDuplex, you need to pass a reference to the assembly in your project.
+** PubCenter and AdDuplex support for Windows 8 / Windows 8.1 / WP 8.1
+In order to support WinRT controls on WinRT platforms, like those now used by PubCenter and AdDuplex, you need to pass a reference to the assembly in your project.
 
-For Pubcenter, install the Windows 8/8.1 SDK as normal and reference the "Microsoft Advertising SDK", then include the following in the page code behind constructor.
-Note - name of your control, this uses your XAML or programmatic instance
+For Pubcenter, install the MS Ad SDK as normal (Win 8 http://bit.ly/MSAdSDK81 and WP8.1 http://bit.ly/MSAdSDKWP8) and reference the "Microsoft Advertising SDK", then include the following in the page code behind constructor.
+Note - Check the name of your control, this uses your XAML (above) or programmatic instance
 
-	MyAdRotatorControl.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.PubCenter, typeof(Microsoft.Advertising.WinRT.UI.AdControl));
+	MyAdRotatorControl.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.PubCenter, typeof(AdControl)); //<- Resolve to Microsoft AdControl
 
-For AdDuplex, add the control via NuGet using the AdDuplex SDK for Windows8 (Xaml edition) NuGet package, then include the following in the page code behind constructor.
-Note - name of your control, this uses your XAML or programmatic instance
+For AdDuplex, add the control via the new AdDuplex AD SDK (http://bit.ly/AdDuplexVSIX), then include the following in the page code behind constructor.
+Note - Check the name of your control, this uses your XAML (above) or programmatic instance
 
-	MyAdRotatorControl.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.AdDuplex, typeof(AdDuplex.Controls.AdControl));
+	MyAdRotatorControl.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.AdDuplex, typeof(AdControl)); //<- Resolve to AdDuplex AdControl
 
 This enables AdRotator to access the local WinMD components for each control.
 
-***For Unity, these references need to go in your App.XAML.cs constructor and look as follows:
+***For Unity, add the following in your App.XAML.cs constructor, as follows:
 	//PubCenter
-	AdRotatorUnitySDK.Integration.AdRotatorBridge.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.PubCenter, typeof(Microsoft.Advertising.WinRT.UI.AdControl));
+	AdRotatorUnitySDK.Integration.AdRotatorBridge.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.PubCenter, typeof(AdControl)); //<- Resolve to Microsoft AdControl
 	//AdDuplex
-	AdRotatorUnitySDK.Integration.AdRotatorBridge.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.AdDuplex, typeof(AdDuplex.Controls.AdControl));
+	AdRotatorUnitySDK.Integration.AdRotatorBridge.PlatformAdProviderComponents.Add(AdRotator.Model.AdType.AdDuplex, typeof(AdControl)); //<- Resolve to AdDuplex AdControl
+
+***Unity Universal games
+Unity by default puts both your App.XAML and MainPage.XAML pages in the shared project. 
+TO configure AdRotator with Unity, you will need to copy these to each of the Windows Phone and Windows 8 projects because they need to be configured separately.
+
 
 
 For further examples check the example projects in the GitHub source @ https://github.com/Adrotator/AdrotatorV2
@@ -85,7 +91,7 @@ This version of V2 also now supports our Unity plug-in for Windows 8 & Windows P
 
 Final Note
 ----------
-If you are using AdRotator and it is helping you to be more profitable, please consider donating to help support further development and support.
+If you are using AdRotator and it is helping you to be more profitable, please consider donating to help support further development and maintenance.
 http://getadrotator.com/
 
 The AdRotator Team