Client SDKs and Samples for Windows Azure Mobile Services
C# Objective-C Java JavaScript Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 3 commits ahead, 2096 commits behind Azure:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Windows Azure Mobile Services

With Windows Azure Mobile Services you can add a scalable backend to your connected client applications in minutes. To learn more, visit our Developer Center.

Getting Started

If you are new to Mobile Services, you can get started by following our tutorials for connecting your Mobile Services cloud backend to Windows Store apps, iOS apps, and Android apps.

Download Source Code

To get the source code of our SDKs and samples via git just type:

git clone
cd ./azure-mobile-services/

Windows 8 and Windows Phone 8 Client SDK

Our Windows SDK makes it incredibly easy to use Mobile Services from your Windows Store and Windows Phone 8 applications. You can download the SDK directly or you can download the source code using the instructions above. The Windows Client SDK can be found under /azure-mobile-services/sdk/windows and the Windows Phone 8 Client SDK is under /azure-mobile-services/sdk/windowsphone.

iOS Client SDK

Note: This iOS client is released as a preview. It is currently under development.

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 and then you will find the SDK under azure-mobile-services/sdk/iOS. As always we’re excited to get your feedback on this early version of the library on our issues page, and welcome your contributions


The SDK requires Windows 8 RTM and Visual Studio 2012 RTM.

Running the Tests

The Windows SDK has a suite of unit tests but the process for running these tests might be unfamiliar.

  1. Open the /azure-mobile-services/sdk/windows/win8sdk.sln solution file in Visual Studio 2012.
  2. Right click on the Microsoft.Azure.Zumo.Windows.CSharp.Test project in the solution explorer and select Set as StartUp Project.
  3. Press F5
  4. 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.
  5. The test suite will run and display the results.

Building and Referencing the SDK

When you build the solution the output is written to the /azure-mobile-services/sdk/windows/bin folder. To reference the SDK from a C# Windows Store application, use the dll located at /azure-mobile-services/sdk/windows/bin/{Flavor}/Windows 8/Managed/Microsoft.WindowsAzure.MobileServices.Managed.dll (where {Flavor} is Debug or Release).

Android SDK


The SDK requires Eclipse and the latest Android Development Tools.

Building and Referencing the SDK

  1. 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 script if you are running on Linux to download the required dependencies.
  2. Import the \azure-mobile-services\sdk\android\src\sdk project into your workspace
  3. Once Eclipse is done compiling, the resulting .jar file will be located in \azure-mobile-services\sdk\android\src\sdk\bin.
  4. To optionally build JavaDocs, right-click the javadoc.xml file and select Run As > Ant Build.

Running the Tests

The SDK has a suite of unit tests that you can easily run.

  1. Import the \azure-mobile-services\sdk\android\test\sdk.testapp.tests project in your Eclipse workspace
  2. Right-click the project name and select Run As > Android JUnit Test

It also contains an end-to-end test application.

  1. Use the Azure portal to create a new mobile service. Note down the service name and application key.
  2. If you want to run the authentication tests, configure all four authentication providers on the "Identity" tab
  3. Install node.js and then run the command npm install azure-cli -g. This installs the Azure command-line tool.
  4. Use the azure account command to configure the tool to work with your Azure subscription
  5. Run the 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.
  6. In the folder \azure-mobile-services\test\Android\ZumoE2ETestApp\libs, run either the getLibs.ps1 script if you are running on Windows or the script if you are running on Linux to download the required dependencies.
  7. Import the \azure-mobile-services\test\Android\ZumoE2ETestApp project in your Eclipse workspace
  8. Once the app is running, go to Settings type your mobile service URL and application key
  9. 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
  10. Check the tests you want to run and then select "Run selected tests"

Sample Application: Doto

Doto is a simple, social todo list application that demonstrates the features of Windows Azure Mobile Services. You can find doto under /azure-mobile-services/samples/doto.

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.

Contribute Code or Provide Feedback

If you would like to become an active contributor to this project please follow the instructions provided in Windows Azure Projects Contribution Guidelines.

If you encounter any bugs with the library please file an issue in the Issues section of the project.

Learn More

Windows Azure Mobile Services Developer Center