Download Source Code

Change log

Managed Windows 8 and Windows Phone 8 Client SDK

Our managed portable library for Windows 8 and Windows Phone 8 Client SDK makes it incredibly easy to use Mobile Services from your Windows Store
and Windows Phone 8 applications. The Microsoft Azure Mobile Services SDK is available
as a Nuget package or you can download the source using the instructions above. The managed portable library also supports the full .NET 4.5 platform.

Prerequisites

The SDK requires Visual Studio 2012 RTM.

Building and Referencing the SDK

The managed portable library solution includes a core portable assembly and platform-specific assemblies for each of the supported platforms: Windows 8,
Windows Phone 8 and .NET 4.5. The core portable platform project is Microsoft.WindowsAzure.Mobile. The platform-specific assembly projects are
named using a Microsoft.WindowsAzure.Mobile.Ext.<Platform> convention. The Windows Phone 8 platform also
include a Microsoft.WindowsAzure.Mobile.UI.<Platform> project that contain UI components. To build the Managed Portable Libray:

Open the sdk\Managed\Microsoft.WindowsAzure.Mobile.Managed.sln solution file in Visual Studio 2012.

Press F6 to build the solution.

Running the Tests

The managed portable library Microsoft.WindowsAzure.Mobile.Managed.sln has a test application for each of the supported platforms: Windows 8,
Windows Phone 8 and .NET 4.5.

Open the sdk\Managed\Microsoft.WindowsAzure.Mobile.Managed.sln solution file in Visual Studio 2012.

Right-click on the test project for a given platform in the Solution Explorer and select Set as StartUp Project.

Press F5 to run the application in debug mode.

An application will appear with a prompt for a runtime Uri and Tags. You can safely ignore this prompt and just click the Start button.

The test suite will run and display the results.

iOS Client SDK

Add a cloud backend to your iOS application in minutes with our iOS client SDK. You can download the iOS SDK directly or you can download the source code using the instructions above.

Prerequisites

The SDK requires XCode 4.6.3 or greater.

Building and Referencing the SDK

Open the sdk\iOS\WindowsAzureMobileServices.xcodeproj file in XCode.

Set the active scheme option to Framework\iOS Device.

Build the project using Command-B. The WindowsAzureMobileServices.framework folder should be found in the build output folder under Products\<build configuration>-iphoneos.

Drag and drop the WindowsAzureMobileServices.framework from a Finder window into the Frameworks folder of the Project Navigator panel of your iOS application XCode project.

Running the Tests

Open the sdk\iOS\WindowsAzureMobileServices.xcodeproj file in XCode.

Set the active scheme option to WindowsAzureMobileServices\* Simulator.

Open the Test\WindowsAzureMobileServicesFunctionalTests.m file in the Project Navigator panel of XCode.

In the settings.plist file, set TestAppUrl and TestAppApplicationKey to a valid URL and Application Key for a working Mobile Service.

Run the tests using Command-U.

Android SDK

Microsoft Azure Mobile Services can be used with an Android-based device using our Android SDK. You can download the Android SDK directly or you can download the source code using the instructions above.

Prerequisites

Building and Referencing the SDK

In the folder \azure-mobile-services\sdk\android\src\sdk\libs, run either the getLibs.ps1 script if you are running on Windows or the getLibs.sh script if you are running on Linux to download the required dependencies.

Use the Azure portal to create a new mobile service. Note down the service name and application key.

If you want to run the authentication tests, configure all four authentication providers on the "Identity" tab

Install node.js and then run the command npm install azure-cli -g. This installs the Azure command-line tool.

Use the azure account command to configure the tool to work with your Azure subscription

Run the SetupTables.sh script in the \azure-mobile-services\test\Android\SetupScripts folder, which uses the tool to automatically create the tables needed for the test application to work.

In the folder \azure-mobile-services\test\Android\ZumoE2ETestApp\libs, run either the getLibs.ps1 script if you are running on Windows or the getLibs.sh script if you are running on Linux to download the required dependencies.

Once the app is running, go to Settings type your mobile service URL and application key

If you also want to test push support, get a Google Cloud Messaging API key from the Google APIs Console and paste the key in the text box labeled GCM Sender Id

Check the tests you want to run and then select "Run selected tests"

JavaScript SDK

Our JavaScript SDK makes it easy to use our Microsoft Azure Mobile Services in a Windows 8 application or an HTML client. The Microsoft Azure Mobile Services for WinJS SDK is available as a Nuget package or you can download the source for both WinJS and HTML using the instructions above.

Open the sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln file in Visual Studio.

Right click on the gruntfile.js in the solution, and select Task Runner Explorer

Run the default build option

Alternatively, you can use Grunt from the command line to build the project as well.

For WinJS Windows Store apps, copy the Generated/MobileServices[.min].js, Generated/MobileServices.DevIntellisense.js and Generated/MobileService.pri files into your WinJS project. For HTML applications, copy the Generated/MobileServices.Web[.min].js and the Generated/MobileServices.DevIntellisense.js files into your HTML\JavaScript project.

Running the Tests

To run the WinJS Windows Store test app:

Open the sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln file in Visual Studio.

In the Solution Explorer, right-click on the Microsoft.WindowsAzure.Mobile.WinJS.Test project in the Solution Explorer and select Set as StartUp Project.

Press F5 to run the application in debug mode.

A Windows Store application will appear with a prompt for a Runtime Uri and Tags. You can safely ignore this prompt and just click the Start button.

The test suite will run and display the results.

To run the HTML tests:

Open the sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln file in Visual Studio.

In the Solution Explorer, select the Microsoft.WindowsAzure.Mobile.WinJS.Test project and right-click to select 'View in Browser'.

The default browser will launch and run the test HTML application. Some tests may fail because due to an 'Unexpected connection failure'. This is because the test is configured to connect to a Mobile Service that does not exist. These failures can be ignored.

Need Help?

Be sure to check out the Mobile Services Developer Forum if you are having trouble. The Mobile Services product team actively monitors the forum and will be more than happy to assist you.