构建您的第一个应用
在应用中添加Dartastic之前,请确认您的Flutter和Dart版本足以支持您要使用的package。
需要哪个版本的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的应用)。只有这一个package需要它。 - 为什么Pro API需要Dart 3.4: 它的Web部分使用
dart:js_interop。 - dartastic_opentelemetry_native_flutter在其pubspec中声明Flutter 3.16 / Dart 3.0,但它依赖的package需要Flutter 3.22 / Dart 3.4,因此这才是它真正的最低要求。
每个package及其要求
| Package | 说明 | 版本 | 最低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 package保持同一版本
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会为您选好这些版本。