Upgrade the Dart/Flutter SDK to v4 (#2599)

src/includes/before-breadcrumb/dart.mdx

@@ -0,0 +1,11 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Breadcrumb beforeBreadcrumb(Breadcrumb breadcrumb, dynamic hint) {
+  return 'a.spammy.Logger' == breadcrumb.category ? null : breadcrumb;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeBreadcrumb = beforeBreadcrumb);
+}
+```

src/includes/breadcrumbs-example/dart.mdx

@@ -0,0 +1,5 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Sentry.addBreadcrumb(Breadcrumb(message: 'Authenticated user'));
+```

src/includes/capture-error/dart.mdx

@@ -0,0 +1,14 @@
+In Dart you can capture any exception object that you caught:
+
+```dart
+import 'package:sentry/sentry.dart';
+
+try {
+  aMethodThatMightFail();
+} catch (exception, stackTrace) {
+  await Sentry.captureException(
+    exception,
+    stackTrace: stackTrace,
+  );
+}
+```

src/includes/capture-message/dart.mdx

@@ -0,0 +1,5 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+await Sentry.captureMessage('Something went wrong');
+```

src/includes/configuration/auto-session-tracking/flutter.mdx

@@ -0,0 +1,14 @@
+```dart
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) => options.enableAutoSessionTracking = true, // it's enabled by default
+    () {
+      // Run your App
+      runApp(MyApp());
+    },
+  );
+}
+```

src/includes/configuration/before-breadcrumb-hint/dart.mdx

@@ -0,0 +1,11 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Breadcrumb beforeBreadcrumb(Breadcrumb crumb, dynamic hint) {
+  return hint is MyHint ? null : crumb;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeBreadcrumb = beforeBreadcrumb);
+}
+```

src/includes/configuration/before-send-fingerprint/dart.mdx

@@ -0,0 +1,14 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+  if (event.exception is DatabaseException) {
+    event = event.copyWith(fingerprint: ['database-connection-error']);
+  }
+  return event;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeSend = beforeSend);
+}
+```

src/includes/configuration/before-send-hint/dart.mdx

@@ -0,0 +1,13 @@
+A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+
+```dart
+import 'package:sentry/sentry.dart';
+
+SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+  return hint is MyHint ? null : event;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeSend = beforeSend);
+}
+```

src/includes/configuration/before-send/dart.mdx

@@ -0,0 +1,15 @@
+A `BiFunction<SentryEvent, Object, SentryEvent>` can be used to mutate, discard (return null), or return a completely new event.
+
+```dart
+import 'package:sentry/sentry.dart';
+
+SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+  // Modify the event here:
+  event = event.copyWith(serverName: null); // Don't send server names.
+  return event;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeSend = beforeSend);
+}
+```

src/includes/configuration/config-intro/dart.mdx

@@ -0,0 +1,12 @@
+Options are passed to the `Sentry.init` method:
+
+```dart
+import 'package:sentry/sentry.dart';
+
+Future<void> main() async {
+  await Sentry.init((options) => options
+    ..dsn = '___PUBLIC_DSN___'
+    ..release = 'my-project-name@2.3.12'
+    ..environment = 'staging');
+}
+```

src/includes/configuration/config-intro/flutter.mdx

@@ -1,11 +1,19 @@
-Options are passed to the `SentryClient()` class:
+Options are passed to the `SentryFlutter.init` method:
 
 ```dart
-final sentry = SentryClient(
-  dsn: '___PUBLIC_DSN___',
-  environmentAttributes: const Event(
-    release: 'my-project-name@2.3.12',
-    environment: 'production',
-  )
-);
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) => options
+      ..dsn = '___PUBLIC_DSN___'
+      ..release = 'my-project-name@2.3.12'
+      ..environment = 'staging',
+    () {
+      // Run your App
+      runApp(MyApp());
+    },
+  );
+}
 ```

src/includes/configuration/drain-example/flutter.mdx

@@ -0,0 +1 @@
+The Flutter SDK for Android and iOS stores the Sentry events on the device's disk before shutdown.

src/includes/configuration/sample-rate/dart.mdx

@@ -0,0 +1,8 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Future<void> main() async {
+  // Capture only 25% of events
+  await Sentry.init((options) => options.sampleRate = 0.25);
+}
+```

src/includes/configuration/session-tracking-interval/flutter.mdx

@@ -0,0 +1,14 @@
+```dart
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) => options.autoSessionTrackingIntervalMillis = 10000, // it's 30000 millis by default
+    () {
+      // Run your App
+      runApp(MyApp());
+    },
+  );
+}
+```

src/includes/configure-scope/dart.mdx

@@ -0,0 +1,7 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Sentry.configureScope((scope) => scope
+  ..setTag('my-tag', 'my value')
+  ..user = User(id: '42', email: 'john.doe@example.com'));
+```

src/includes/getting-started-config/dart.mdx

@@ -0,0 +1,7 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Future<void> main() async {
+  await Sentry.init((options) => options.dsn = '___PUBLIC_DSN___');
+}
+```

src/includes/getting-started-config/flutter.mdx

@@ -0,0 +1,16 @@
+```dart
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) => options.dsn = '___PUBLIC_DSN___',
+    () {
+      // Run your App
+      runApp(MyApp());
+    },
+  );
+
+  // or define SENTRY_DSN via Dart environment variable (--dart-define)
+}
+```

src/includes/getting-started-install/dart.mdx

@@ -0,0 +1,4 @@
+```yml {filename:pubspec.yaml}
+dependencies:
+  sentry: ^4.0.0
+```

src/includes/getting-started-install/flutter.mdx

@@ -0,0 +1,4 @@
+```yml {filename:pubspec.yaml}
+dependencies:
+  sentry_flutter: ^4.0.0
+```

src/includes/getting-started-primer/dart.mdx

@@ -0,0 +1,5 @@
+<Note>
+
+_Pure Dart SDK used by any Dart application like AngularDart, CLI and Server, it enables reporting messages and errors._
+
+</Note>

src/includes/getting-started-primer/flutter.mdx

@@ -0,0 +1,7 @@
+<Note>
+
+_Sentry's Flutter SDK enables capturing sessions for Release Health, offline caching as well as reporting messages and errors._
+
+_Sentry's Flutter SDK depends on the [Dart SDK](/platforms/dart/) and includes support to native crashes through Sentry's native SDKs (Android and iOS), It'll capture errors in the native layer, including Java, Kotlin, C and C++ code for `Android` and ObjC, Swift and C for `iOS`._
+
+</Note>

src/includes/getting-started-verify/dart.mdx

@@ -0,0 +1,12 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+try {
+  aMethodThatMightFail();
+} catch (exception, stackTrace) {
+  await Sentry.captureException(
+    exception,
+    stackTrace: stackTrace,
+  );
+}
+```

src/includes/sensitive-data/set-tag/dart.mdx

@@ -0,0 +1,8 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Sentry.configureScope((scope) => scope.setTag(
+      'birthday',
+      checksumOrHash('08/12/1990'),
+    ));
+```

src/includes/sensitive-data/set-user/dart.mdx

@@ -0,0 +1,8 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Sentry.configureScope((scope) => scope.user = User(
+      id: clientUser.id,
+      username: clientUser.username,
+    ));
+```

src/includes/set-context/dart.mdx

@@ -0,0 +1,9 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+final person = {
+  'name': 'Mighty Fighter',
+  'age': '19',
+};
+Sentry.configureScope((scope) => scope.setContexts('person', person));
+```

src/includes/set-environment/dart.mdx

@@ -0,0 +1,7 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Future<void> main() async {
+  await Sentry.init((options) => options.environment = 'staging');
+}
+```

src/includes/set-environment/flutter.mdx

@@ -1,9 +1,17 @@
 ```dart
-import 'package:sentry/sentry.dart';
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) => options.environment = 'staging',
+    () {
+      // Run your App
+      runApp(MyApp());
+    },
+  );
+
+  // or define SENTRY_ENVIRONMENT via Dart environment variable (--dart-define)
+}
 
-final sentry = SentryClient(
-  environmentAttributes: const Event(
-    environment: 'production'
-  )
-);
 ```

src/includes/set-extra/dart.mdx

@@ -0,0 +1,8 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+Sentry.configureScope((scope) => scope.setExtra(
+      'character.name',
+      'Mighty Fighter',
+    ));
+```

src/includes/set-fingerprint/basic/dart.mdx

@@ -0,0 +1,14 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+  if (event.exception is DatabaseException) {
+    event = event.copyWith(fingerprint: ['database-connection-error']);
+  }
+  return event;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeSend = beforeSend);
+}
+```

src/includes/set-fingerprint/database-connection/dart.mdx

@@ -0,0 +1,14 @@
+```dart
+import 'package:sentry/sentry.dart';
+
+SentryEvent beforeSend(SentryEvent event, dynamic hint) {
+  if (event.exception is DatabaseException) {
+    event = event.copyWith(fingerprint: ['database-connection-error']);
+  }
+  return event;
+}
+
+Future<void> main() async {
+  await Sentry.init((options) => options.beforeSend = beforeSend);
+}
+```