文件版本
v2026.07.07.0
下載 PDF
效能與載入¶
頁面目標¶
協助你判斷 App 是否仍在正常推進,還是真的卡住了。
支援平台¶
iOSmacOS
適用對象¶
- 正在等待匯入或視圖準備,且不確定 App 是否仍在推進的使用者
- 分析載入停滯、疑似卡住或體感效能回歸的測試人員
前置條件¶
- 某份文件正在匯入、開啟,或正在建立 3D 視圖
- 你仍可觀察可見進度狀態、階段文字或 UI 回應
操作步驟¶
- 檢查階段文字、百分比或載入卡是否仍在變化。
- 確認 UI 是否仍回應基本互動。
- 在判定卡住前,記錄精確階段與停留時間。
- 將行為與下面的正常等待與可疑停滯模式比對。
結果¶
- 你可以區分正常分階段推進、保護性停止,以及可能的真實載入問題。
目前版本常見等待階段¶
匯入到 2D 準備¶
- 資料庫頂部會顯示匯入橫幅
- 工作區可能暫時切到
Data - 第一個 projected frame 發布前,2D 檢視器可能保持阻擋狀態
3D 視圖建構¶
3D 會顯示明確階段與進度文字,例如:
LoadingDetailsViewFinishing

如何判斷進度仍屬正常¶
請聚焦這些訊號:
- 進度數字或階段文字仍在變化
- UI 仍回應基本互動
- 匯入橫幅或 3D 載入卡持續更新
如果三者都成立,App 通常仍在正常推進。
何時應懷疑是真實問題¶
- App 長時間停在同一階段,且文字沒有變化
- UI 變得無回應
- 同一輸入在同一裝置上反覆停在同一點
- 這個行為只出現在目前版本,之前穩定版本沒有
幾個目前行為事實¶
- 匯入期間,檢視器可能自動切到
Data;這是正常轉換,不代表開啟失敗。 - 3D 需要具備足夠板級幾何的板級 3D 工作階段。如果缺少必要輸入而顯示清楚問題訊息,這不是效能問題。
- 巨大的
IPC-2581輸入會進入真實匯入流程;如果它非常慢或最後失敗,請把它記錄為真實匯入路徑問題。
需要記錄什麼¶
- 裝置與平台
- 輸入類型與大小
- App 停在哪個階段
- 停留時間
- UI 是否仍有回應
- 問題是否只出現在某一個視圖
常見問題¶
等很久是否一定代表出錯?¶
不一定。大型板件、第一次建立 3D 視圖,以及製造封裝辨識都可能需要明顯等待時間。關鍵是狀態是否仍在推進。
為什麼記錄精確階段很重要?¶
因為目前版本已把匯入與 3D 載入拆成明確階段。記錄階段可大幅加快重現與診斷。