CodePush

發行項
03/15/2024

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。雖然您可以繼續使用 Visual Studio App Center，直到完全淘汰為止，但有數個建議的替代方案可以考慮移轉至。

CodePush 是 App Center 雲端服務，可讓 React Native 開發人員直接將行動應用程式更新部署至其使用者的裝置。其運作方式是做為中央存放庫，讓開發人員可將特定更新發佈至 (，例如 JS、HTML、CSS 和影像變更) ，而應用程式可以使用提供的用戶端 SDK) 查詢 (更新。這可讓您更具決定性且直接的參與模型與您的使用者一起處理 Bug、新增不需要重建二進位檔的小型功能，或透過任何公用應用程式市集轉散發。根據預設，在 App Center 上建立的所有 React Native 應用程式都會啟用 CodePush;若要開始使用 CodePush，您需要下列步驟：

注意

針對 Android 裝置，CodePush 只能在 TLS 1.2 相容裝置上運作

注意

CodePush API 使用量的速率限制為每 5 分鐘 8 個要求。這些會依下列各項的組合計算：要求的端點、IP 要求來自、部署密鑰和用戶端唯一標識符。如果達到限制，則會傳回狀態代碼為 429 的回應：

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1.安裝 App Center CLI

您可以使用 App Center CLI 來管理大部分 CodePush 的功能。若要安裝 CLI，請開啟終端機視窗或命令提示字元，然後執行下列命令：

npm install -g appcenter-cli

注意

如果您發現執行此命令時發生 EACCES 錯誤，您可能需要修正系統上的 npm 許可權。許多月臺都建議使用 sudo 命令來解決此錯誤，但您不應該使用 sudo安裝 npm 模組。

成功安裝 App Center CLI 之後，請執行 appcenter login 命令來設定 App Center 帳戶詳細數據的 CLI。

2.CodePush-ify 您的應用程式

將 CodePush 用戶端 SDK 新增至您的應用程式，並將其設定為從 App Center 中的其中一個部署提取應用程式更新。下列各節提供如何針對支援的應用程式平台執行這項操作的詳細資料：

Apache Cordova
React Native \(英文\)

3.發行應用程式更新

變更應用程式的程式代碼或資產之後，請使用App Center CLI將更新發佈至App Center，如下列各節所述。

React Native

執行 App Center CLI release-react 命令來組合應用程式的程式代碼和資產檔案，然後將其發佈至 App Center 伺服器作為新版本。例如：

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

執行 App Center CLI release-cordova 命令來組合應用程式的程式代碼和資產檔案，然後將其發佈至 App Center 伺服器作為新版本。例如：

appcenter codepush release-cordova -a <ownerName>/MyApp

提示

App Center CLI 中的一個重要功能是能夠使用 appcenter apps set-current <ownerName>/<appName>將應用程式設定為目前的應用程式。藉由將應用程式設定為目前的應用程式，您就不需要使用 -a 旗標。例如， appcenter codepush deployment list -a <ownerName>/<appName> 命令可以輸入，就像是設定目前的應用程式一樣 appcenter codepush deployment list 。您可以使用來檢查哪些應用程式已設定為帳戶的應用程式 appcenter apps get-current。利用此命令可縮短大部分的 CLI 命令。

4.執行您的應用程式

這些步驟完成後，執行您應用程式的所有用戶都會使用您在步驟 2 中設定的體驗來接收更新。如需詳細資訊，請參閱 CLI 和用戶端 SDK 檔 (Apache Cordova，React Native) 。