跳到主要內容

升級到新版本

升級到新版本的 React Native 將使您能夠使用更多 API、視圖、開發人員工具和其他好處。升級需要少量的工作，但我們盡力讓您輕鬆完成。

Expo 專案​

將您的 Expo 專案升級到新版本的 React Native 需要更新 package.json 檔案中的 react-native、react 和 expo 套件版本。Expo 建議以遞增方式一次升級一個 SDK 版本。這樣做將幫助您查明升級過程中出現的錯誤和問題。請參閱升級 Expo SDK 逐步指南，以取得有關升級專案的最新資訊。

React Native 專案​

因為典型的 React Native 專案基本上由 Android 專案、iOS 專案和 JavaScript 專案組成，所以升級可能相當棘手。「升級助手」是一個 Web 工具，旨在通過提供任意兩個版本之間發生的完整變更集來幫助您升級應用程式。它還會在特定檔案上顯示註解，以幫助理解為什麼需要進行該變更。

1. 選擇版本​

您首先需要選擇要從哪個版本升級到哪個版本，預設情況下會選擇最新的主要版本。選擇後，您可以點擊「顯示如何升級」按鈕。

💡 主要更新將在頂部顯示「實用內容」部分，其中包含連結，可在您升級時為您提供幫助。

2. 升級依賴項​

顯示的第一個檔案是 package.json，最好更新其中顯示的依賴項。例如，如果 react-native 和 react 顯示為變更，那麼您可以通過運行以下命令將其安裝在您的專案中

shell
# {{VERSION}} and {{REACT_VERSION}} are the release versions showing in the diff
npm install react-native@{{VERSION}}
npm install react@{{REACT_VERSION}}

3. 升級您的專案檔案​

新版本可能包含在您運行 npx react-native init 時生成的其他檔案的更新，這些檔案在「升級助手」頁面的 package.json 之後列出。如果沒有其他變更，那麼您只需要重建專案即可繼續開發。如果存在變更，您需要手動將其應用到您的專案中。

疑難排解​

我已完成所有變更，但我的應用程式仍然使用舊版本​

這類錯誤通常與快取有關，建議安裝 react-native-clean-project 以清除您專案的所有快取，然後您可以再次運行它。