첫 앱 만들기
앱에 Dartastic을 추가하기 전에, 사용하려는 패키지에 맞을 만큼 Flutter와 Dart 버전이 최신인지 확인하세요.
필요한 Flutter 및 Dart 버전
아래에서 해당하는 앱을 찾으세요. 현재 버전은 flutter --version 명령으로 확인하세요(Dart 전용 앱은 dart --version).
| 앱 | 최소 요구 버전 | 제공 기능 |
|---|---|---|
| 모든 기능을 사용하는 Flutter 앱 | Flutter 3.44, Dart 3.12 | 트레이스, 로그, ANR, RUM과 리플레이, 그리고 프레임, 버벅거림, 시작 시간, Vitals 지표. |
| Flutter 3.22~3.43을 사용하는 Flutter 앱 | Flutter 3.22, Dart 3.4 | dartastic_opentelemetry_flutter_metrics 패키지를 제외한 모든 기능: 트레이스, 로그, ANR, RUM과 리플레이. 프레임, 버벅거림, 시작 시간, Vitals 지표는 제외됩니다. |
| 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가 필요한 이유: 웹 부분에서
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 | 프레임, 버벅거림, 시작 시간, Vitals 지표 | 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 버전입니다. 각 패키지에는 오픈 소스 SDK ^1.1.0-beta.17 버전과 API >=1.0.0-rc.4 <1.0.0-rc.5 버전이 필요하며, dart pub get 명령이 알맞은 버전을 골라 줍니다.