總覽
Dartastic讓您看見Dart和Flutter應用程式在使用者手中的真實表現,並協助您修正出錯的地方。本頁是一張地圖。讀過一次後,再依照開始使用逐步進行。
平台
每個說明頁面都會顯示同一張圖,並標亮該頁涵蓋的部分,讓您隨時知道自己的位置。
- 您在自己的電腦和CI中建置。您的應用程式從Dartastic Pub取得Dartastic套件,就像從pub.dev取得套件一樣。
- 應用程式執行時,無論是在手機、桌面裝置、瀏覽器中,或作為Dart伺服器,其中的Dartastic OTel套件都會記錄發生的事,並傳送到Observatory。
- 出問題時,Symbolizer會使用您隨應用程式發布到Pub的符號,將當機還原成您的檔案和行號。
- 想知道原因時,就詢問Dartastic AI。它會讀取遙測資料和您在Pub上的原始碼,回答原因並提出修正。
- Control Room是您設定這一切的地方:它建立的權杖,開啟圖中的每一個箭頭。
各個組成
| 組成 | 用途 | 在哪裡使用 |
|---|---|---|
| Control Room | 您的帳戶。您在這裡建立權杖、邀請團隊成員、選擇方案,以及下載Reference Demo。 | 登入後的dartastic.io/control-room |
| Dartastic Pub | 運作方式和pub.dev相同的私有套件登錄服務。您從這裡取得Dartastic套件、存放自己的私有套件,並將應用程式的原始碼發布到這裡。 | dart pub get, dart pub publish |
| Dartastic OTel | 您加入應用程式的套件。它們以OpenTelemetry記錄應用程式中發生的事(畫面、點擊、網路呼叫、錯誤、當機、效能),並傳送出去。 | 您的pubspec.yaml和main() |
| Observatory | 您查看資料的地方。針對應用程式傳送的一切,提供含重播的工作階段、追蹤、記錄、指標、當機、儀表板和警示。 | 從Control Room開啟 |
| Symbolizer | 將經過模糊處理的發行建置版本中難以閱讀的堆疊追蹤,還原成您的檔案名稱和行號。當機資料抵達時,它會自動執行。 | 無需呼叫:它會讀取您發布到Pub的符號 |
| Dartastic AI | 以日常語言回答關於應用程式的問題。它會讀取您的遙測資料和Pub上的原始碼,找出原因並提出修正。 | Observatory和Control Room中的「Ask」按鈕 |
您會看到的內容
這就是Observatory。使用者的每個工作階段都會列出,並附上其畫面、點擊、錯誤和挫折訊號:

開啟其中一個並重播。在播放位置下方,您會看到當下的追蹤、記錄和錯誤,還能直接跳到對應的程式碼行:

權杖串連各個組成
圖中的每個箭頭都需要各自類型的權杖。權杖在Control Room中建立,每個權杖只會顯示一次,因此請在建立時複製。大多數開發者從未搭配dart pub使用過權杖;Pub頁面會逐步引導您。
| 權杖 | 來源 | 目的地 | 用途 |
|---|---|---|---|
| Pub權杖 | 您的電腦 | Dartastic Pub | dart pub get可下載Dartastic套件和您的私有套件;dart pub publish可上傳。 |
| CI交換 | 您的CI | Dartastic Pub | 您的CI不需儲存任何權杖,就能讀取及發布套件。 |
| OTLP權杖 | 手機或桌面裝置上的應用程式、您的Dart伺服器 | Observatory | 讓您的應用程式傳送遙測資料。 |
| Browser OTLP權杖 | 您的Flutter網頁應用程式 | Observatory | 讓您的網頁應用程式傳送遙測資料,且僅限您列出的網站。 |
您持有的所有權杖都列在同一個畫面上。權杖說明每種權杖,以及如何撤銷或更換。
執行位置:您的方案
- Cloud在Dartastic與其他客戶共用的基礎架構上執行。您的Pub位於
pub.dartastic.io。 - Dedicated為您的組織提供專屬伺服器,位於您選擇的子網域:您的Pub位於
pub.<subdomain>.dartastic.io。 - Self-Hosted在您自己的網路內執行整個平台。
每個方案的步驟都相同。網址不同之處,這些頁面會同時列出兩者。比較方案。
需要準備的項目
- 要使用所有功能,需要Flutter 3.44和Dart 3.12或更新版本;Flutter 3.22和Dart 3.4可使用Flutter指標以外的所有功能。各套件需要的版本。
- Dartastic帳戶:免費註冊。註冊後,您的組織會從Cloud Free開始,不需要信用卡。
- 僅Reference Demo的天氣後端需要:Docker。
學習方式
選擇適合您的方式;它們涵蓋相同的內容。
- 依序閱讀這些頁面。每頁底部的「上一頁」和「下一頁」會帶您往下讀。
- 執行Dartastic OTel Reference Demo。它是開源Dart OTel Reference Demo的商業加強版:包含更多示範,都是可實際執行的Flutter應用程式,展示Dartastic每項功能的用法,設定都已完成。閱讀它的程式碼、從中複製,或讓您的AI程式設計助理參考它。取得Reference Demo。
- 提問:支援團隊會回答您的問題。
這些頁面使用的用語
- OpenTelemetry(OTel)
- 記錄軟體行為的開放標準。Dartastic從頭到尾都採用它,因此您寫的任何程式碼都不會被Dartastic綁定。
- OTLP
- OpenTelemetry的傳輸格式:應用程式傳送所記錄資料的方式。
- 追蹤和span
- span是一段計時的工作(一次點擊、一次網路呼叫、一次資料庫查詢)。追蹤是同一項作業的span所組成的樹,即使橫跨您的應用程式和伺服器也一樣。
- 記錄
- 應用程式寫下的一行文字,與其發生時所在的追蹤相連。
- 指標
- 隨時間量測的數值:影格時間、記憶體、請求數。
- 工作階段
- 一個人使用您應用程式的一次造訪,從啟動到離開,包含其中的每個畫面、點擊、錯誤和追蹤。
- 重播
- 回看一個工作階段。擷取多少內容由您決定:事件時間軸、線框,或真實像素。
- RUM
- 真實使用者監控:來自真正在使用您應用程式的人的遙測資料,而非來自測試。
- 模糊處理和符號
- 發行建置版本可以打亂其名稱(flutter build --obfuscate)。它寫出的符號檔(--split-debug-info)就是還原名稱的鑰匙。
- 權杖
- 一串很長的機密字串,讓一個元件能與另一個元件溝通。每種權杖開啟上圖中的一條路徑。