mirror of https://github.com/dart-lang/sdk synced 2024-09-15 21:20:36 +00:00

History

Nate Bosch 6ebd2633cd Use `any` deps for all unpublished packages It should not be necessary to ever run `pub get` for a package which is not published. All packages used in the SDK are controlled by a single package config, so it's not necessary to declare versions or paths for any packages. Remove all dependency overrides. R=devoncarew@google.com Change-Id: Icb328813b471f35ee4c99995f4e90aac4d8ed438 Tested: Covered by existing static analysis. Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/244767 Commit-Queue: Nate Bosch <nbosch@google.com> Reviewed-by: Alexander Aprelev <aam@google.com> Reviewed-by: Devon Carew <devoncarew@google.com>		2022-05-17 01:22:25 +00:00
..
lib	move pkg/telemetry to using package:lints	2021-05-19 16:26:42 +00:00
test	move pkg/telemetry to using package:lints	2021-05-19 16:26:42 +00:00
analysis_options.yaml	telemetry: Use the new strict-casts instead of deprecated no-implicit-casts	2021-12-20 22:33:43 +00:00
LICENSE	Update LICENSE	2021-04-07 10:28:38 +00:00
OWNERS	[infra] Add OWNERS to the Dart SDK	2022-02-14 14:06:34 +00:00
pubspec.yaml	Use `any` deps for all unpublished packages	2022-05-17 01:22:25 +00:00
README.md

README.md

telemetry

A library to facilitate reporting analytics and crash reports.

Analytics

This library is designed to allow all Dart SDK tools to easily send analytics information and crash reports. The tools share a common setting to configure sending analytics data. To use this library for a specific tool:

import 'package:telemetry/telemetry.dart';
import 'package:usage/usage.dart';

main() async {
  final String myAppTrackingID = ...;
  final String myAppName = ...;

  Analytics analytics = createAnalyticsInstance(myAppTrackingID, myAppName);
  ...
  analytics.sendScreenView('home');
  ...
  await analytics.waitForLastPing();
}

The analytics object reads from the correct user configuration file automatically without any additional configuration. Analytics will not be sent if the user has opted-out.

Crash reporting

To use the crash reporting functionality, import crash_reporting.dart, and create a new CrashReportSender instance:

import 'package:telemetry/crash_reporting.dart';

main() {
  Analytics analytics = ...;
  CrashReportSender sender = new CrashReportSender(analytics);
  try {
    ...
  } catch (e, st) {
    sender.sendReport(e, st);
  }
}

Crash reports will only be sent if the cooresponding [Analytics] object is configured to send analytics.