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 - 不正確的要求 |