跳至主要内容

[ReactNative] Running on iOS devices

雖然可以透過模擬器進行 App 功能驗證, 但在實體裝置上執行 App 並確認功能仍是必要的, 尤其在第一次發行或版本升級等情況下.

使用 Expo 建立的 App, 可直接透過 Expo App 掃描 QRCode 進行預覽. 這邊紀錄使用 React Native CLI 建立的專案如何在 iOS 裝置上安裝測試.

Running your app on iOS devices

1. Plug in your device via USB

先連接 iOS 裝置到 Mac 電腦上, iOS 裝置連上電腦時會跳出信任此電腦的提式框, 需信任. 打開 Xcode. 如果專案有使用 CocoaPods, 開啟 ios/APP.workspace, 否則就打開 ios/APP.xcodeproj 專案檔.

Xcode: Product > Destination 選擇所連接的 iOS 裝置.

iOS device

第一次在 iOS 裝置上執行 App 時, Xcode 可能會跳出設定提式視窗, 跟著視窗指示註冊裝置即可.

2. Configure code signing

後續步驟需要有 Apple Developer account, 沒有的話需先註冊.

在 Xcode Project 中找到對應的 project 和 target. 在 General 分頁中的 Signing 中確認選擇了開發者或團隊帳號.

3. Build and Run your app

如果設置正確, Xcode 理應該可以看到 build target 為 iOS 裝置. 按下 Build and Run 按鈕 (⌘R) 或 Product 選單中選擇 Run, App 經過編譯後, 就會在裝置上自動執行.

因設置不同, 可能會多次跳出要求存取 Keychain 的提示視窗, 一一輸入障密同意即可. (應該有辦法避免, 確認方式後再更新文章)

If you run into any issues, please take a look at Apple's Launching Your App on a Device docs.

Connecting to the development server

Troubleshooting

See Also