症狀：React Native 專案在 Windows 已能編輯，卻找不到 iOS 模擬器，或不確定舊專案能否直接升級。
最快解法：React Native 0.88 iOS 專案仍要在裝有 Xcode 的 macOS 環境建置；新專案先用 0.88 官方模板，舊專案先比對升級差異，再視是否採用 iOS 27 SDK 檢查 SceneDelegate。
適合剛開始學 React Native、想把第一個專案跑進 iOS 模擬器的學生。
已有課程專案、準備升級 0.88 的你，可以先釐清原生工程要不要調整。
主要使用 Windows 或學校電腦的你，可據此判斷課程何時需要 macOS 與 Xcode。
最後更新於 2026 年 10 月 20 日；版本與遷移資訊核對自 React Native 0.88 官方發布說明、官方環境設定文件及 Apple 的場景生命週期文件。
起點判斷：新建專案還是升級舊專案
如果你正要開始課程範例，直接依照 0.88 官方建置方式建立新專案，較容易得到與文件相符的 iOS 原生工程。若你要接手課程中已存在的專案，先查明原本的 React Native 版本及原生檔案差異，不要把新專案步驟直接套上去。
React Native 專案包含兩部分：JavaScript 程式碼描述畫面與應用邏輯；ios 資料夾裡則有 Xcode 使用的原生工程設定。前者可以在 Windows 編輯，但在本機建置並啟動 iOS 模擬器，仍需要 macOS 和 Xcode。兩個工作階段不是同一件事：Metro 顯示已啟動，不代表 iOS App 已成功建置。
| 你的起點 | 建議處理方式 | 先不要做的事 |
|---|---|---|
| 剛建立課程專案 | 依 0.88 官方文件與模板建立，再確認 ios 工程入口 |
不要照搬舊版教學裡的 AppDelegate 修改 |
| 已有 React Native 專案 | 用 Upgrade Helper 比對目前版本與 0.88，逐項處理原生檔案 | 不要只因發布說明提到沒有面向使用者的破壞性變更，就略過檢查 |
| 只有 Windows 或受管理的學校電腦 | 在 Windows 繼續編輯與做非 iOS 專屬測試；把 iOS 建置安排到可用的 macOS、Xcode 環境 | 不要把 Windows 上啟動 Metro 當成 iOS 驗收完成 |
React Native 0.88 能否直接拿來開發 iOS？可以，但「能寫程式」和「能建置並驗收 iOS App」是兩個條件。React Native 官方發布說明指出，0.88 加入 iOS SceneDelegate 生命週期支援，且沒有面向使用者的破壞性變更；這不等於你的第三方套件、舊版原生設定或課程程式碼都不必檢查。查看 0.88 發布說明。
工具環境核對：先確認建置條件
React Native 官方環境設定文件列出 iOS 開發需要的工具及準備方式。Xcode、Node.js、Watchman 與 CocoaPods 等項目的版本和安裝細節可能隨文件更新；開始前依照官方環境設定步驟核對，不要只依賴課程影片中較早期的截圖。
| 你手上的環境 | 可完成的工作 | iOS 模擬器建置 |
|---|---|---|
| Windows 電腦 | 編輯 JavaScript、執行可在該環境執行的檢查、管理專案檔案 | 本機缺少 macOS 與 Xcode，不能據此完成 iOS 模擬器驗收 |
| macOS 加 Xcode | 安裝並核對 React Native 所需工具、開啟 iOS 工程、建置及啟動模擬器 | 可在工具與專案設定符合要求時進行 |
| 遠端 macOS 主機 | 視連線方式執行開發工具，並在遠端 macOS 環境處理 iOS 建置 | 先確認課程所需的模擬器操作、檔案傳輸與連線權限 |
特別留意課程的驗收標準：如果只要求畫面程式碼或 JavaScript 邏輯，可能能先在現有電腦完成部分工作；如果明確要求在 iOS 模擬器啟動、檢查原生行為，單靠 Windows 編輯器或 Metro 不足以交差。
Windows 能否完成整個 React Native iOS 專案驗收？你可以在 Windows 完成不少程式編輯，但不能把 Windows 上的 Metro 伺服器視為 iOS 建置成功。要驗收 iOS 模擬器畫面，仍須安排可使用 macOS 與 Xcode 的建置環境。
新專案入口：依 0.88 模板檢查 SceneDelegate
新建專案時，先以官方入門文件確認目前建議的建立流程，再依官方 iOS 模擬器執行說明準備啟動方式。不要把不同版本影片裡的指令或手動修改直接當成 0.88 的必要步驟；先看生成的工程檔案和官方文件是否相符。
React Native 0.88 的模板已包含 SceneDelegate 路徑。對新手來說，這表示應先檢查模板產生了哪些原生入口檔，再判斷課程或套件是否要求額外設定，而不是預設要手動重寫 AppDelegate。
新建的 0.88 專案還要自行補上 SceneDelegate 嗎？通常先檢查官方模板生成的原生工程即可；若你的專案使用自訂入口、額外原生套件，或採用較新的 iOS SDK，才按相應文件確認是否還需要調整。不要因為舊教學有手動設定，就在新模板上重複套用。
舊專案遷移：比對原生檔案與 SDK 條件
升級的第一步不是改程式，而是保留可回退的副本。接著用 React Native Upgrade Helper 選取原版本與目標版本，查看差異涉及哪些檔案。留意 ios 工程、AppDelegate、Info.plist、套件設定及專案中自訂的原生程式碼。
React Native 0.88 的發布說明提到 SceneDelegate 支援，也說明採用 iOS 27 SDK 時的 UIScene 要求及單場景支援邊界。這是判斷是否要處理生命週期遷移的重要條件；不是每個舊專案只要升到 0.88，就必須不加判斷地重寫入口。
| 檢查項目 | 先問自己 | 適合的處理 |
|---|---|---|
| React Native 版本差異 | 舊版到 0.88 的工程檔案有哪些變更？ | 依 Upgrade Helper 的差異逐項合併 |
| SDK 與生命週期 | 目前是否採用 iOS 27 SDK，是否涉及 UIScene 要求？ | 對照 0.88 發布說明及 Apple 場景文件 |
| 原生入口與回呼 | AppDelegate、Info.plist 或 URL 回呼是否由課程或套件修改？ | 保留既有行為，確認入口遷移和回呼轉發 |
| 套件相容性 | 原生套件是否有自己的升級步驟？ | 查套件文件並逐一測試，不推定全部相容 |
Apple 將 UIScene 說明為管理 App 介面場景生命週期的機制。若你需要確認入口遷移，可參考 Apple 的場景生命週期說明；若要檢查 App 宣告支援哪些場景，則對照 Apple 的場景設定文件。不要只看畫面能否開啟，也要確認原本的 URL 回呼等入口功能是否仍可運作。
舊版升到 0.88，最先檢查什麼？先找出版本差異，再確認是否採用 iOS 27 SDK，以及專案是否自訂生命週期入口。官方所說的「沒有面向使用者的破壞性變更」，不能推論為所有舊工程或第三方套件都不需要調整。
首次啟動驗收：從依賴安裝到錯誤定位
先準備環境，再處理工程，最後才啟動模擬器。下列清單可以依序勾選；指令名稱和介面位置以你目前的專案腳本及官方文件為準，尤其不要把舊版課程的指令當成所有 0.88 專案都一致。
- [ ] 確認專案版本：查看
package.json的 React Native 版本，記下是否為 0.88，以及目前使用的套件管理方式。 - [ ] 準備 macOS 工具：依官方環境設定文件核對 Xcode 和相關工具，確認 Xcode 已完成首次啟動所需設定。
- [ ] 安裝專案依賴：在專案根目錄使用該專案指定的套件管理方式安裝相依套件；不要在 npm、Yarn 等不同鎖定檔間任意切換。
- [ ] 處理 iOS 相依項目：依專案文件和官方環境設定指引準備 CocoaPods 等原生相依項目；若安裝失敗，先保留完整錯誤訊息，不要直接刪除鎖定檔。
- [ ] 開啟 iOS 工程：按官方模擬器文件及課程專案的工程結構開啟 iOS 專案，確認 Xcode 能辨識工程與所需設定。
- [ ] 選擇模擬器並建置：在 Xcode 選擇課程要求的 iOS 模擬器，再依官方執行文件啟動專案。
- [ ] 確認畫面與功能：等待 App 實際啟動，檢查課程要求的頁面、互動及原生功能；只看到 Metro 輸出不算驗收完成。
排錯時，把現象分開處理，避免一遇到問題就反覆重裝：
- 專案沒有建置完成：查看 Xcode 建置錯誤，先分辨是工具版本、原生工程差異、相依套件，還是簽署等設定造成。若是升級專案，回看 Upgrade Helper 中相關檔案。
- 建置完成但 App 沒有啟動：確認所選模擬器、啟動目標及 Xcode 顯示的執行錯誤；不要只檢查 JavaScript 開發伺服器。
- App 啟動但頁面異常：確認 Metro 是否連到正確專案、畫面是否使用預期資料，再檢查原生套件或 URL 回呼等課程功能。若剛升級，與未升級的備份版本作對照。
課程只要求交出畫面截圖，還需要做完整驗收嗎？至少要確認 App 真正在 iOS 模擬器啟動，截圖反映的是課程要求的頁面，而不是 Metro 已執行或工程已開啟。若作業還包含原生功能，就要再測試相應互動，並記錄所用工具版本與問題現象，方便重現。
環境選擇：依課程期限決定下一步
用自己的課程專案完成一次建置，才知道工具是否足夠。若目前沒有 Mac，先向課程確認是否能晚些提交模擬器驗收，或是否可使用學校提供的 macOS 環境；若作業期限要求你立刻測試 iOS，則需要找到能使用 Xcode 的 macOS 建置途徑。
- 選本機 Mac：適合經常需要 iOS 開發、要長期使用同一套環境，或需要本機硬體與外接裝置的情況。缺點是前期購置成本由你承擔，也要自行維護環境。
- 先用 Windows 完成可做的部分：適合課程目前以 JavaScript 邏輯為主、iOS 模擬器尚非必要的階段。缺點是無法用它取代 macOS 上的 Xcode 建置與模擬器驗收。
- 按需使用遠端 Mac：適合短期需要 Xcode 和 iOS 模擬器、但不想為單一課程先購買實機的情況。要先確認課程操作能否透過遠端桌面完成，以及檔案傳輸、連線方式和使用期間是否符合你的安排。
如果你已確認作業必須在 iOS 模擬器中驗收，卻只有 Windows 或學校管理的電腦，長期等待會卡住建置與截圖；反過來說，若你每天都要長時間進行穩定的重負載開發，或需要直接連接特定實體裝置，租用環境未必比自購 Mac 合適。你可以先查看 MACCOME 的遠端 Mac 方案，並按自己所在地與使用方式確認可用選項；若課程時段在香港，也可參考 香港遠端 Mac 方案頁面。只有在確認需要 macOS 與 Xcode 後，才決定是否短期租用，避免把租用當成所有編程學習的必選項。