React Native GitHub 示例項目在 Xcode 運行指南：依賴安裝與 Metro 服務

標準運行流程

1. 克隆項目：git clone <repo-url>
2. 安裝 JS 依賴：
   cd <project-root>
npm install 或 yarn install
3. 安裝 iOS 原生依賴：
   cd ios
pod install （必須！生成 .xcworkspace）
4. 打開工作區**而非項目文件**：
   open <ProjectName>.xcworkspace
5. 啟動 Metro 打包服務（新終端）：
   cd <project-root>
npx react-native start --reset-cache
6. Xcode Build & Run：選擇模擬器/真機，點擊 ▶️。

常見報錯對應

關鍵提示

• 一定要用 .xcworkspace，它包含 Pods 依賴；.xcodeproj 不包含。
• Metro 必須全程運行，它是 JS 打包服務器，App 啟動時會從這裡下載 bundle。
• 查看項目根目錄 README.md，官方示例通常有專門的「Running on iOS」章節。

總結

React Native iOS 示例運行核心三步：**npm/yarn install → cd ios && pod install → 打開 .xcworkspace 並保持 Metro 運行**。照著 README 做，90% 問題迎刃而解。