建置您的第一個應用程式
在應用程式中加入Dartastic之前,請先確認您的Flutter和Dart版本夠新,足以使用您需要的套件。
您需要的Flutter和Dart版本
在下表中找到您的應用程式類型。使用flutter --version(純Dart應用程式則使用dart --version)檢查您目前的版本。
| 您的應用程式 | 最低需求 | 可取得的功能 |
|---|---|---|
| 具備所有功能的Flutter應用程式 | Flutter 3.44、Dart 3.12 | 追蹤、記錄、ANR、RUM和重播,以及影格、卡頓、啟動和關鍵指標。 |
| 使用Flutter 3.22至3.43的Flutter應用程式 | Flutter 3.22、Dart 3.4 | dartastic_opentelemetry_flutter_metrics以外的所有功能:追蹤、記錄、ANR、RUM和重播,但沒有影格、卡頓、啟動和關鍵指標。 |
| Dart伺服器或命令列應用程式 | Dart 3.4 | 搭配引擎的Pro API,以及程序和Dart VM指標。 |
- 為何指標需要Flutter 3.44:
dartastic_opentelemetry_flutter_metrics的Android部分仰賴自動套用Kotlin,而Flutter的工具從3.44起才會這麼做(適用於使用Android Gradle Plugin 9的應用程式)。只有這個套件需要它。 - 為何Pro API需要Dart 3.4: 它的Web部分使用
dart:js_interop。 - dartastic_opentelemetry_native_flutter在其pubspec中標示Flutter 3.16/Dart 3.0,但它依賴的套件需要Flutter 3.22/Dart 3.4,因此這才是它實際的最低需求。
每個套件及其需求
| 套件 | 說明 | 版本 | 最低Dart版本 | 最低Flutter版本 |
|---|---|---|---|---|
dartastic_opentelemetry_native_engine | 原生引擎 | 1.22.4 | 3.0 | — |
dartastic_opentelemetry_native | Pro API | 1.22.4 | 3.4 | — |
dartastic_opentelemetry_native_flutter | 將引擎帶入Flutter應用程式 | 1.22.4 | 3.4 | 3.22 |
dartastic_opentelemetry_flutter_metrics | 影格、卡頓、啟動和關鍵指標 | 5.0.x | 3.12 | 3.44 |
dartastic_opentelemetry_dart_metrics | 程序和Dart VM指標 | 3.0.x | 3.0 | — |
dartastic_semantics | Dartastic記錄的所有內容的名稱 | 3.6.x | 3.0 | — |
dartastic_opentelemetry | 開源OpenTelemetry SDK | 1.1.0-beta.17 | 3.0 | — |
dartastic_opentelemetry_api | 開源OpenTelemetry API | 1.0.0-rc.4 | 3.0 | — |
讓三個Pro套件維持在同一版本
dartastic_opentelemetry_native_engine、dartastic_opentelemetry_native和dartastic_opentelemetry_native_flutter會一起發布,且版本必須完全相同:目前三者皆為1.22.4。它們都需要^1.1.0-beta.17的開源SDK和>=1.0.0-rc.4 <1.0.0-rc.5的API;dart pub get會為您選取這些版本。