共用方式為


Mobile Apps 和 Mobile Services 中的用戶端和伺服器版本控制

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

Mobile Apps 用戶端和伺服器 SDK 最初是以行動服務中的 SDK 為基礎,但它們 彼此不相容。 也就是說,您必須使用 Mobile Apps 用戶端 SDK 搭配 Mobile Apps 伺服器 SDK,同樣適用於 Mobile Services。 此合約是透過客戶端和伺服器 SDK 所使用的特殊標頭值來強制執行,ZUMO-API-VERSION

注意:每當本文件參考 行動服務 後端時,它並不一定必須託管在行動服務上。 現在可以移轉行動服務以在App Service上執行,而不需要變更任何程式代碼,但服務仍會使用 行動服務 SDK 版本。

標頭規格

索引鍵 ZUMO-API-VERSION 可以在 HTTP 標頭或查詢字串中指定。 值是格式為 x.y.z的版本字串。

例如:

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

標頭: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之間有許多行為變更,特別是在離線同步處理、驗證和推播通知的領域。 您應該僅在完成測試之後選擇退出版本檢查,以確保這些行為變更不會中斷應用程式的功能。

Azure Mobile Apps 用戶端和伺服器

行動裝置 應用程式 用戶端 SDK

自下列版本的用戶端 SDK 開始,引入了版本檢查功能,Azure Mobile Apps

用戶端平臺 版本 版本標頭值
受控用戶端(Windows、Xamarin) 2.0.0 2.0.0
iOS 3.0.0 2.0.0
安卓 3.0.0 3.0.0

行動裝置 應用程式 伺服器 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的值 回應
x.y.z 或 Null 200 - 確定
False/未指定 400 - 錯誤請求
1.x.y False/未指定 400 - 錯誤請求
2.0.0-2.x.y False/未指定 200 - 確定
3.0.0-3.x.y False/未指定 400 - 錯誤請求