Mobile Apps 和行動服務中的用戶端和伺服器版本控制

Azure 行動服務的最新版本是 Azure App Service 的 Mobile Apps 功能。

Mobile Apps 用戶端和伺服器 SDK 最初是以行動服務中的 SDK 為基礎,但是它們彼此「不」相容。 也就是說,您必須使用 Mobile Apps 用戶端 SDK 搭配 Mobile Apps 伺服器 SDK,「行動服務」也是類似作法。 您可以透過用戶端和伺服器 SDK 所使用的特殊標頭值 ZUMO-API-VERSION 來強制執行。

注意:每當這份文件提及 行動服務 後端時,它不一定需要裝載於行動服務。 現在可以將行動服務移轉到 App Service 上執行而不用變更任何程式碼,但是服務還是會使用 行動服務 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 Apps 之間有許多行為改變了,尤其是在離線同步處理、驗證和推播通知的區域。 您應該在完成測試之後才選擇不要進行版本檢查,確保這些行為的變更不會影響您的 app 功能。

Azure Mobile Apps 用戶端和伺服器

Mobile Apps 用戶端 sdk

版本檢查是從 Azure Mobile Apps下列版本的用戶端 SDK 開始引進:

用戶端平台 版本 版本標頭值
受控用戶端 (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-行動應用程式) 2.0.0

Mobile Apps 後端的行為

ZUMO-API-VERSION MS_SkipVersionCheck 的值 回應
x.y.z 或 Null True 200 - 確定
Null False/未指定 400 - 不正確的要求
1.x.y False/未指定 400 - 不正確的要求
2.0.0-2.x.y False/未指定 200 - 確定
3.0.0-3.x.y False/未指定 400 - 不正確的要求