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

最新バージョンの Azure Mobile Services は、Azure App Service の Mobile Apps 機能です。

Mobile Apps クライアント SDK とサーバー SDK は、もともと Mobile Services の SDK に基づいていますが、互いに互換性 がありません 。 つまり、 Mobile Apps サーバー SDK と Mobile Apps クライアント SDK を Mobile Services の場合と同様に使用する必要があります。 このコントラクトは、クライアント SDK とサーバー 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 portal の [アプリケーション設定] セクションで指定します。

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

モバイルアプリクライアントSDK

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

Mobile Apps サーバー SDK

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

Mobile Apps バックエンドの動作