如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

在 iOS 模擬器中偵錯

使用 Codex 和 XcodeBuildMCP 在 iOS 模擬器中操作應用程式,蒐集偵錯證據,逐步修正問題。

難度 Advanced
任務時間跨度 1h

讓 Codex 找出適用的 Xcode scheme 和模擬器,啟動應用程式並檢查 UI 階層。Codex 可以在模擬器中點按、輸入文字及滑動,擷取螢幕截圖與記錄,並視需要附加 LLDB 偵錯器。即使錯誤回報描述得不夠清楚,Codex 也能據此找出問題,以小幅修改加以修正,並驗證修正結果。

最適合的對象

  • 只有在模擬器中依特定步驟點按、捲動或填寫表單才會出現的 UI 錯誤
  • 遇到當機、停止回應或導覽失效時,Codex 需要先查看記錄、螢幕截圖、檢視階層的狀態和偵錯器的堆疊回溯資訊,再修改程式碼
  • 希望由 Codex 負責重現錯誤、修正程式碼及驗證結果,省去人工逐一操作各個畫面狀態的團隊

目錄

    ← 所有應用案例

    在 iOS 模擬器中偵錯

    使用 Codex 和 XcodeBuildMCP 在 iOS 模擬器中操作應用程式,蒐集偵錯證據,逐步修正問題。

    讓 Codex 找出適用的 Xcode scheme 和模擬器,啟動應用程式並檢查 UI 階層。Codex 可以在模擬器中點按、輸入文字及滑動,擷取螢幕截圖與記錄,並視需要附加 LLDB 偵錯器。即使錯誤回報描述得不夠清楚,Codex 也能據此找出問題,以小幅修改加以修正,並驗證修正結果。

    Advanced
    1h

    讓 Codex 找出適用的 Xcode scheme 和模擬器,啟動應用程式並檢查 UI 階層。Codex 可以在模擬器中點按、輸入文字及滑動,擷取螢幕截圖與記錄,並視需要附加 LLDB 偵錯器。即使錯誤回報描述得不夠清楚,Codex 也能據此找出問題,以小幅修改加以修正,並驗證修正結果。

    Advanced
    1h

    最適合的對象

    • 只有在模擬器中依特定步驟點按、捲動或填寫表單才會出現的 UI 錯誤
    • 遇到當機、停止回應或導覽失效時,Codex 需要先查看記錄、螢幕截圖、檢視階層的狀態和偵錯器的堆疊回溯資訊,再修改程式碼
    • 希望由 Codex 負責重現錯誤、修正程式碼及驗證結果,省去人工逐一操作各個畫面狀態的團隊

    技能與外掛程式

    • 使用 iOS 偵錯智慧體搭配 XcodeBuildMCP,在模擬器中建置、啟動、檢查及操作應用程式,再擷取記錄、螢幕截圖和堆疊追蹤資訊,讓 Codex 逐步縮小問題範圍。
    技能 使用理由
    Build iOS Apps 使用 iOS 偵錯智慧體搭配 XcodeBuildMCP,在模擬器中建置、啟動、檢查及操作應用程式,再擷取記錄、螢幕截圖和堆疊追蹤資訊,讓 Codex 逐步縮小問題範圍。

    入門提示詞

    請使用 Build iOS Apps 外掛程式和 XcodeBuildMCP,直接在模擬器中重現這個錯誤,找出根本原因,並以小幅修改加以修正。 錯誤回報: [請描述預期行為、實際發生的錯誤,以及任何已知的畫面或帳號設定。] 限制條件: - 先確認是否已選定專案、scheme 和模擬器。若尚未選定,請找出適用的 Xcode 專案或工作區,選取應用程式的 scheme,再選擇模擬器,並在本次工作階段的後續操作中沿用這組設定。 - 在模擬器中建置並啟動應用程式。開始操作前,先透過 UI 快照或螢幕截圖確認目前顯示的是正確畫面。 - 親自在模擬器中依照確切的重現步驟點按、輸入文字、捲動及滑動。定位元素時,請優先使用輔助使用標籤或 ID,盡量避免直接指定座標。版面變更後,請在下一次操作前重新讀取 UI 階層。 - 偵錯時請同步蒐集證據。擷取螢幕截圖以記錄畫面狀態,並蒐集問題發生前後的模擬器記錄。如果疑似當機或停止回應,也請用 LLDB 擷取堆疊框架或變數值。 - 如果尚未啟動模擬器,請啟動一個,並告訴我你選了哪款裝置和哪個作業系統。如果需要登入憑證或特定的測試資料或設定,請暫停,只向我索取缺少的項目。 - 只修改修正錯誤所必需的程式碼,接著在模擬器中重新執行相同流程,並具體說明你如何驗證修正結果。 請提供: - Codex 實際執行的錯誤重現步驟 - 能說明錯誤原因的關鍵螢幕截圖、記錄或堆疊資訊 - 修正錯誤的程式碼變更,以及這項變更能解決問題的原因 - 最終驗證使用的模擬器和 Xcode scheme
    請使用 Build iOS Apps 外掛程式和 XcodeBuildMCP,直接在模擬器中重現這個錯誤,找出根本原因,並以小幅修改加以修正。 錯誤回報: [請描述預期行為、實際發生的錯誤,以及任何已知的畫面或帳號設定。] 限制條件: - 先確認是否已選定專案、scheme 和模擬器。若尚未選定,請找出適用的 Xcode 專案或工作區,選取應用程式的 scheme,再選擇模擬器,並在本次工作階段的後續操作中沿用這組設定。 - 在模擬器中建置並啟動應用程式。開始操作前,先透過 UI 快照或螢幕截圖確認目前顯示的是正確畫面。 - 親自在模擬器中依照確切的重現步驟點按、輸入文字、捲動及滑動。定位元素時,請優先使用輔助使用標籤或 ID,盡量避免直接指定座標。版面變更後,請在下一次操作前重新讀取 UI 階層。 - 偵錯時請同步蒐集證據。擷取螢幕截圖以記錄畫面狀態,並蒐集問題發生前後的模擬器記錄。如果疑似當機或停止回應,也請用 LLDB 擷取堆疊框架或變數值。 - 如果尚未啟動模擬器,請啟動一個,並告訴我你選了哪款裝置和哪個作業系統。如果需要登入憑證或特定的測試資料或設定,請暫停,只向我索取缺少的項目。 - 只修改修正錯誤所必需的程式碼,接著在模擬器中重新執行相同流程,並具體說明你如何驗證修正結果。 請提供: - Codex 實際執行的錯誤重現步驟 - 能說明錯誤原因的關鍵螢幕截圖、記錄或堆疊資訊 - 修正錯誤的程式碼變更,以及這項變更能解決問題的原因 - 最終驗證使用的模擬器和 Xcode scheme

    讓 Codex 在模擬器中完成整個除錯流程

    在這個使用案例中,讓 Codex 負責整個流程,效果最好。先由 Codex 選擇正確的應用程式建置目標,在 Simulator 中啟動應用程式並檢查目前的畫面。接著,它會依照步驟重現問題,收集記錄和螢幕截圖,必要時檢查堆疊追蹤資訊。最後,它會修正程式碼,再執行一次相同的操作步驟,確認問題不再出現。

    如果希望 Codex 自主完成這個流程,可以使用 Build iOS Apps 外掛程式。這個外掛程式的 iOS 除錯流程以 XcodeBuildMCP 為核心,讓 Codex 能操作已啟動的模擬器,取得平常需要開發者手動收集的除錯資料。

    在 XcodeBuildMCP 中設定好模擬器自動化、UI 自動化、除錯和記錄擷取工作流程後,Codex 就能完成重現問題、除錯與驗證的整個流程。如果 Codex 尚未選定專案、Xcode 方案(scheme)和模擬器,請它先找出可用選項並完成選擇,在本次工作階段的後續步驟中沿用這組設定。

    善用 XcodeBuildMCP 的功能

    你可以請 Codex 使用以下幾類功能:

    • 尋找專案與模擬器:確認 Codex 是否已知道該使用哪個應用程式建置目標和模擬器,找出 Xcode 專案或工作區,列出可用的方案,尋找或啟動模擬器,並在後續建置與執行時沿用同一組設定。
    • 建置與啟動:建置目前選定的應用程式目標,在模擬器上安裝並啟動建置好的應用程式,必要時重新啟動應用程式並擷取記錄。如果 Codex 需要查看該應用程式專屬的執行階段記錄,請它查出應用程式的套件識別碼。
    • 檢查與操作 UI:讀取畫面上輔助使用元素的階層結構、擷取螢幕畫面、點按控制項、在欄位中輸入文字、捲動清單,以及從螢幕邊緣滑動或執行其他模擬器手勢。
    • 記錄與除錯器狀態:即時讀取模擬器記錄、將 LLDB 附加到執行中的應用程式、設定中斷點,以及檢查堆疊框架和區域變數。如果應用程式當機或停止回應,需要深入調查,還可以執行除錯器指令。

    請養成習慣,讓 Codex 在點按之前先檢查檢視樹。XcodeBuildMCP 會提供輔助使用元素的階層結構和座標,讓 Codex 能優先依據穩定的標籤或元素 ID 找到點按目標,不必猜測螢幕座標。

    把模糊的問題描述整理成可重現問題的腳本

    要讓 iOS 除錯技能發揮最佳效果,請在提示詞中說明一個具體問題和一個預期結果,接著讓 Codex 自行操作應用程式並收集證據。如果重現問題需要登入、使用深層連結或準備測試用的固定資料,請在一開始說明一次,並要求 Codex 只在缺少上述必要條件而無法繼續時才暫停。

    實用技巧

    請 Codex 提供修正和佐證資料

    請 Codex 列出實際使用的模擬器和 Xcode 方案,並附上它用來說明問題的螢幕截圖、記錄片段和堆疊詳細資訊。比起只說「我想這樣應該能修好」,這些資料能讓你更容易審查最後的程式碼修正。

    優先用輔助使用標籤定位控制項

    如果控制項缺少穩定的標籤或輔助使用識別碼,導致 Codex 只能依座標點按,請它明確指出是哪個控制項。這通常表示修正問題時也應該稍微調整 UI,讓控制項更容易測試。

    每次只處理一個問題

    透過模擬器除錯能做很多事,但每個提示詞只針對一種出錯情況,結果更容易讓人信服。請 Codex 先重現並修正一個問題,再驗證修正是否有效,之後再處理其他相關問題。

    技術堆疊

    需求

    模擬器自動化

    預設選項

    XcodeBuildMCP

    為何需要

    現有工具可設定模擬器、建置並啟動應用程式,也支援點按、文字輸入和手勢操作。偵錯時可擷取 UI 快照和螢幕截圖、蒐集記錄,以及附加偵錯器。

    需求

    智慧體工作流程

    為何需要

    透過外掛程式中的 iOS 偵錯智慧體,Codex 會先在模擬器中重現錯誤、蒐集證據,並在每次修改後驗證修正結果。

    需求

    應用程式可觀測性

    預設選項

    Logger、OSLog、LLDB 和模擬器螢幕截圖

    為何需要

    Codex 可根據記錄和偵錯器狀態說明哪裡出了問題,再儲存螢幕截圖,以佐證修正前後的實際 UI 狀態。

    需求 預設選項 為何需要
    模擬器自動化 XcodeBuildMCP 現有工具可設定模擬器、建置並啟動應用程式,也支援點按、文字輸入和手勢操作。偵錯時可擷取 UI 快照和螢幕截圖、蒐集記錄,以及附加偵錯器。
    智慧體工作流程 Build iOS Apps 外掛程式 透過外掛程式中的 iOS 偵錯智慧體,Codex 會先在模擬器中重現錯誤、蒐集證據,並在每次修改後驗證修正結果。
    應用程式可觀測性 Logger 、 OSLog 、LLDB 和模擬器螢幕截圖 Codex 可根據記錄和偵錯器狀態說明哪裡出了問題,再儲存螢幕截圖,以佐證修正前後的實際 UI 狀態。

    相關應用案例