初めてのアプリを作る
アプリに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 | — |
3つのProパッケージは同じバージョンに揃える
dartastic_opentelemetry_native_engine、dartastic_opentelemetry_native、dartastic_opentelemetry_native_flutterは同時にリリースされ、すべて同じバージョンである必要があります。現在は3つとも1.22.4です。いずれも、オープンソースのSDKは^1.1.0-beta.17、APIは>=1.0.0-rc.4 <1.0.0-rc.5を必要とします。これらはdart pub getが自動で選びます。