跳轉到主要內容
本指南涵蓋使用 WebDriverAgent (WDA) 連接和配置 iOS 裝置以使用 Qaptly 進行測試。

​
先決條件

​
在您的 Mac 上

  • macOS 10.15 (Catalina) 或更新版本
  • 已安裝 Xcode (建議使用最新版本)
  • Apple ID (免費版本可用,但有限制)
  • 用於裝置連接的 USB 線

​
在您的 iOS 裝置上

  • iOS 14.0 或更高版本
  • 已連接 USB 線
  • 裝置已解鎖並信任

​
初始裝置連接

​
步驟 1: 連接裝置

  1. 透過 USB 線連接您的 iOS 裝置
  2. 解鎖裝置

​
步驟 2: 信任電腦

當裝置上出現提示時:
  1. 在「信任此電腦?」對話框上點擊 信任
  2. 如果提示,輸入您的裝置密碼

​
步驟 3: 在 Xcode 中驗證

  1. 開啟 Xcode
  2. 前往 視窗 > 裝置和模擬器
  3. 您的裝置應出現在清單中
  4. 確保狀態顯示為已連接

​
WebDriverAgent 設定

iOS 自動化需要 WebDriverAgent (WDA)。Qaptly 包含設定精靈來引導您完成流程。

​
開啟 WDA 設定精靈

  1. 開啟 Pilot 控制台
  2. 在清單中找到您的 iOS 裝置
  3. 點擊 設定 WDA
  4. WDA 設定精靈開啟

​
WDA 設定流程

精靈會引導您完成 4 個步驟:

​
步驟 1: 下載 WDA 專案

  1. 點擊 下載 WDA
  2. WebDriverAgent 專案會下載到:
  3. 或選擇現有的 WDA 專案位置

​
步驟 2: 在 Xcode 中配置簽署

  1. 點擊 在 Xcode 中開啟 以開啟 WDA 專案
  2. 在 Xcode 中,選擇 WebDriverAgentRunner 目標
  3. 前往 簽署與功能
  4. 選擇您的 團隊 (您的 Apple ID)
  5. 修正任何簽署錯誤:
    • 如需要,更改 Bundle Identifier (例如加上 .yourname)
    • 讓 Xcode 自動管理簽署

​
步驟 3: 在 Xcode 中啟動 WDA

  1. 選擇您的 iOS 裝置作為目標
  2. 按 ⌘+U (產品 > 測試) 以建置並執行 WDA
  3. 等待 WDA 在裝置上安裝並啟動
  4. 您可能需要在裝置上信任開發者描述檔:
    • 前往 設定 > 一般 > 裝置管理
    • 信任您的開發者描述檔

​
步驟 4: 驗證狀態

  1. 返回 Qaptly
  2. 點擊 驗證狀態
  3. 狀態應顯示「WDA 執行中」
  4. 設定完成

​
使用 WDA

​
啟動 WDA

如果 WDA 未執行:
  1. 在 Xcode 中開啟 WDA 專案
  2. 選擇您的裝置
  3. 按 ⌘+U 以啟動 WDA

​
停止 WDA

  1. 在 Xcode 中,按 停止 按鈕
  2. 或按 ⌘+.

​
WDA 埠

WDA 預設在埠 8100 上執行。Qaptly 會自動檢測並連接到 WDA。

​
簽署注意事項

​
免費 Apple ID

使用免費 Apple ID:
  • 應用程式 7 天後過期
  • 您需要每週重新安裝 WDA
  • 每週限制 3 個應用程式 ID

​
付費開發者帳戶

使用付費 Apple Developer 帳戶 ($99/年):
  • 應用程式可使用 1 年
  • 不需要每週重新安裝
  • 更多應用程式 ID 位置

​
企業帳戶

企業憑證提供:
  • 更長的有效期
  • 更簡單的分發
  • 開發無裝置限制

​
螢幕串流

​
開始串流

  1. 確保 WDA 正在執行
  2. 在 Pilot 控制台中,選擇您的 iOS 裝置
  3. 點擊 開始串流
  4. 裝置螢幕出現在串流面板中

​
串流品質

與 Android 相比,iOS 串流可能有輕微延遲。這是 WDA 架構的正常現象。

​
多個 iOS 裝置

​
連接多個裝置

  1. 透過 USB 連接每個裝置
  2. 信任每個裝置
  3. 為每個裝置配置 WDA

​
裝置選擇

在以下位置選擇目標裝置:
  • Xcode 的架構選擇器
  • Pilot 控制台的裝置清單

​
疑難排解

​
「裝置未信任」

  1. 斷開並重新連接裝置
  2. 提示時點擊 信任
  3. 如需要,輸入密碼

​
WDA 建置失敗

  1. 檢查程式碼簽署設定
  2. 確保裝置已連接
  3. 清除建置資料夾: 產品 > 清除建置資料夾
  4. 再試一次

​
「無法啟動 WDA」

  1. 檢查裝置是否已解鎖
  2. 驗證開發者描述檔在裝置上已信任
  3. 重新啟動裝置
  4. 嘗試重新建置 WDA

​
WDA 啟動時當機

  1. 從裝置解除安裝 WDA
  2. 在 Xcode 中清除建置資料夾
  3. 重新建置並重新安裝

​
裝置未出現在 Pilot 控制台中

  1. 驗證裝置已信任
  2. 檢查 Xcode 識別裝置
  3. 確保 USB 連接穩定
  4. 在 Pilot 控制台中重新整理裝置清單

​
「描述檔未信任」

在 iOS 裝置上:
  1. 前往 設定 > 一般 > VPN 與裝置管理
  2. 找到您的開發者描述檔
  3. 點擊 信任
  4. 確認信任操作

​
最佳實踐

  1. 保持裝置解鎖: 自動鎖定會中斷 WDA
  2. 暫時停用密碼: 對於長時間測試會話
  3. 使用優質 USB 線: 劣質線材會導致連接問題
  4. 保持 Xcode 更新: 最新的 Xcode 具有最佳裝置支援
  5. 記錄 bundle ID 變更: 追蹤任何簽署修改

​
過期後重新設定

如果使用免費 Apple ID (7 天過期):
  1. 從裝置刪除 WDA
  2. 在 Xcode 中,清除建置資料夾
  3. 使用 ⌘+U 重新建置 WDA
  4. 在裝置上信任新的描述檔
相關: