Microsoft Azure 移动服务

使用 Microsoft Azure 移动服务，您可以在几分钟内为您的连接客户端应用程序添加可扩展的后端。了解详细信息，请访问我们的 开发者中心。

入门

如果您是移动服务的新手，您可以按照我们的教程开始，将移动服务云后端连接到 Windows Store 应用程序、Windows Phone 8 应用程序、iOS 应用程序 和 Android 应用程序。

下载源代码

通过 git 获取 SDK 和示例的源代码，只需键入以下内容：

git clone https://github.com/Azure/azure-mobile-services.git
cd ./azure-mobile-services/

变更日志

见 变更日志

管理 Windows 8 和 Windows Phone 8 客户端 SDK

我们的 Windows 8 和 Windows Phone 8 客户端 SDK 的托管可移植库使得从您的 Windows Store 和 Windows Phone 8 应用程序中使用移动服务变得极为简单。Microsoft Azure 移动服务 SDK 以 NuGet 包的形式提供，或您可以使用上述说明下载源代码。额外可管理可移植库也支持完整 .NET 4.5 平台。

先决条件

SDK 需要 Visual Studio 2012 RTM。

构建和引用 SDK

托管便携式库解决方案包括一个核心便携式程序集以及为每个受支持平台（Windows 8、Windows Phone 8和.NET 4.5）定制的程序集。核心便携式平台项目是Microsoft.WindowsAzure.Mobile。根据Microsoft.WindowsAzure.Mobile.Ext.<Platform>约定命名的平台特定程序集项目。Windows Phone 8平台还包括一个包含UI组件的Microsoft.WindowsAzure.Mobile.UI.<Platform>项目。要构建托管便携式库

1. 在Visual Studio 2012中打开sdk\Managed\Microsoft.WindowsAzure.Mobile.Managed.sln解决方案文件。
2. 按F6构建解决方案。

运行测试

托管的便携式库Microsoft.WindowsAzure.Mobile.Managed.sln为每个受支持的平台（Windows 8、Windows Phone 8和.NET 4.5）都有一个测试应用程序。

1. 在Visual Studio 2012中打开sdk\Managed\Microsoft.WindowsAzure.Mobile.Managed.sln解决方案文件。
2. 在“解决方案资源管理器”中右击指定平台的测试项目，然后选择设置为启动项目。
3. 按F5以调试模式运行应用程序。
4. 将出现一个应用程序，其中包含请求运行时Uri和标记的提示。您可以安全地忽略此提示，只需单击“开始”按钮。
5. 测试套件将运行并显示结果。

iOS客户端SDK

使用我们的iOS客户端SDK，只需几分钟即可将其 云后端添加到iOS应用程序中。您可以直接下载iOS SDK或根据上述说明下载源代码。

先决条件

SDK需要XCode 4.6.3或更高版本。

构建和引用SDK

1. 在XCode中打开sdk\iOS\WindowsAzureMobileServices.xcodeproj文件。
2. 将活动方案选项设置为Framework\iOS Device。
3. 使用Command-B构建项目。应在Products\<build configuration>-iphoneos构建输出文件夹下找到WindowsAzureMobileServices.framework文件夹。
4. 将Finder窗口中的WindowsAzureMobileServices.framework拖放到iOS应用程序XCode项目的项目导航器面板的Frameworks文件夹中。

运行测试

1. 在XCode中打开sdk\iOS\WindowsAzureMobileServices.xcodeproj文件。
2. 将活动方案选项设置为WindowsAzureMobileServices\* Simulator。
3. 在XCode项目导航器面板中打开Test\WindowsAzureMobileServicesFunctionalTests.m文件。
4. 在setUp代码中，将<Microsoft Azure Mobile Service App URL>和<Application Key>替换为有效的URL和应用密钥。
5. 使用Command-U运行测试。

Android SDK

您可以使用我们的Android SDK伴随基于Android的设备使用我们的Microsoft Azure Mobile Services。您可以直接下载Android SDK或根据上述说明下载源代码。

先决条件

SDK需要Eclipse和最新的Android开发工具。

构建和引用SDK

1. 在\azure-mobile-services\sdk\android\src\sdk\libs文件夹中，运行Windows上的getLibs.ps1脚本或GNU/Linux上的getLibs.sh脚本以下载所需的依赖项。
2. 将\azure-mobile-services\sdk\android\src\sdk项目导入到您的开发空间
3. 一旦Eclipse编译完成，生成的.jar文件将位于\azure-mobile-services\sdk\android\src\sdk\bin目录中。
4. 如需可选地构建JavaDocs，请右键单击javadoc.xml文件，然后选择“运行As”>“Ant构建”。

运行测试

SDK包含一组单元测试，您可以轻松运行。

1. 将\azure-mobile-services\sdk\android\test\sdk.testapp.tests项目导入到您的Eclipse开发空间
2. 右键单击项目名称，然后选择“运行As”>“Android JUnit测试”

它还包含一个端到端的测试应用程序。

1. 使用Azure门户创建一个新的移动服务。记下服务名称和应用程序密钥。
2. 如果您想运行身份验证测试，请在“身份”选项卡上配置所有四个身份验证提供程序
3. 安装node.js然后运行命令npm install azure-cli -g。这将安装Azure命令行工具。
4. 使用azure account命令配置工具以与您的Azure订阅一起使用
5. 在\azure-mobile-services\test\Android\SetupScripts文件夹中运行SetupTables.sh脚本，该脚本使用工具自动创建测试应用程序运行所需的表。
6. 在文件夹\azure-mobile-services\test\Android\ZumoE2ETestApp\libs中，如果您在Windows上运行，则运行getLibs.ps1脚本；如果您在Linux上运行，则运行getLibs.sh脚本以下载所需的依赖项。
7. 将\azure-mobile-services\test\Android\ZumoE2ETestApp项目导入到您的Eclipse开发空间
8. 应用程序开始运行后，转到“设置”输入您的移动服务URL和应用程序密钥
9. 如果您还想测试推送支持，从Google API控制台获取一个Google Cloud Messaging API密钥，并将其粘贴到标签为GCM Sender Id的文本框中
10. 选择您要运行的测试，然后选择“运行所选测试”

JavaScript SDK

我们的JavaScript SDK使我们能够在Windows 8应用程序或HTML客户端中使用Microsoft Azure Mobile Services变得非常容易。Microsoft Azure Mobile Services for WinJS SDK作为Nuget包 提供，或者您可以使用上述说明下载WinJS和HTML的源代码。

先决条件

Microsoft Azure Mobile Services for WinJS SDK需要Windows 8 RTM和Visual Studio 2012 RTM。

构建和引用SDK

1. 在Visual Studio中打开sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln文件。
2. 按F6构建解决方案。这将生成一个合并的单个JavaScript文件，它将被您的应用程序使用。

对于WinJS Windows Store应用程序，将Generated/MobileServices[.min].js、Generated/MobileServices.DevIntellisense.js和Generated/MobileService.pri文件复制到您的WinJS项目中。对于HTML应用程序，将Generated/MobileServices.Web[.min].js和Generated/MobileServices.DevIntellisense.js文件复制到您的HTML\JavaScript项目中。

运行测试

要运行WinJS Windows Store测试应用程序

1. 在Visual Studio中打开sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln文件。
2. 在解决方案资源管理器中，在解决方案资源管理器中右键单击Microsoft.WindowsAzure.Mobile.WinJS.Test项目，并选择“设置为启动项目”。
3. 按F5以调试模式运行应用程序。
4. 将出现一个Windows Store应用程序，提示输入运行时Uri和标签。您可以安全忽略此提示，只需单击“启动”按钮即可。
5. 测试套件将运行并显示结果。

运行HTML测试

1. 在Visual Studio中打开sdk\JavaScript\Microsoft.WindowsAzure.Mobile.JS.sln文件。
2. 在解决方案资源管理器中，选择Microsoft.WindowsAzure.Mobile.WinJS.Test项目，右键单击选择'在浏览器中查看'。
3. 默认浏览器将启动并运行测试HTML应用程序。由于“意外的连接失败”，一些测试可能会失败。这是因为测试配置为连接到一个不存在的移动服务。可以忽略这些失败。

需要帮助？

如果在遇到麻烦时，请务必查看移动服务的开发者论坛。移动服务产品团队积极监控论坛，并非常乐意协助您。

贡献代码或提供反馈

如果您想成为这个项目的积极贡献者，请按照Microsoft Azure项目贡献指南中提供的说明操作。

如果您在库中遇到任何错误，请在项目的问题部分提交一个问题。

了解更多

Microsoft Azure Mobile Services开发者中心