Mobile Apps と Mobile Services のクライアントとサーバーのバージョン管理

Azure Mobile Services の最新版は Azure App Service の Mobile Apps 機能です。

Mobile Apps のクライアント/サーバー SDK は Mobile Services のクライアント/サーバー SDK にもともと基づいていますが、互いに互換性が ありません 。 つまり、Mobile Apps クライアント SDK と共に Mobile Apps サーバー SDK を使用する必要があり、Mobile Services の場合も同様です。 この契約は、クライアント/サーバー SDK により使用される特殊なヘッダー値 ZUMO-API-VERSIONにより適用されます。

注: 本書で Mobile Services に言及するとき、それは必ずしも Mobile Services にホストすることを意味しません。 App Service で実行するモバイル サービスをコード変更なしで移行することが可能になりましたが、サービスでは引き続き Mobile Services SDK バージョンが利用されます。

ヘッダーの仕様

キー ZUMO-API-VERSION を HTTP ヘッダーかクエリ文字列に指定できます。 値は「 x.y.z」形式のバージョン文字列です。

例:

GET https://service.azurewebsites.net/tables/TodoItem

HEADERS: ZUMO-API-VERSION: 2.0.0

POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0

バージョン チェックの除外

バージョン チェックを除外できます。その場合、アプリ設定 MS_SkipVersionCheck に true 値を設定します。 これは web.config か Azure ポータルの [アプリケーション設定] セクションで指定します。

注意

Mobile Services と Mobile Apps の間には、特にオフライン同期、認証、プッシュ通知の領域で、さまざまな動作変更があります。 テストを完了し、動作変更によるアプリの機能停止がないことを確認してからバージョン チェックを除外してください。

Azure Mobile Apps クライアントとサーバー

Mobile Apps クライアント sdk

バージョン チェックは Azure Mobile Appsの次のバージョンのクライアント SDK から導入されました。

クライアント プラットフォーム	Version	バージョンのヘッダー値
管理されたクライアント (Windows、Xamarin)	2.0.0	2.0.0
iOS	3.0.0	2.0.0
Android	3.0.0	3.0.0

Mobile Apps サーバー SDK

バージョン チェックは次のサーバー SDK バージョンに含まれています。

サーバー プラットフォーム	SDK	同意済みのバージョン ヘッダー
.NET	Microsoft.Azure.Mobile.Server	2.0.0
Node.js	azure-mobile-apps)	2.0.0

Mobile Apps バックエンドの動作

ZUMO-API-VERSION	MS_SkipVersionCheck の値	Response
x.y.z または Null	True	200 - OK
[Null]	偽/指定なし	400 - 正しくない要求
1.x.y	偽/指定なし	400 - 正しくない要求
2.0.0-2.x.y	偽/指定なし	200 - OK
3.0.0-3.x.y	偽/指定なし	400 - 正しくない要求