datadog_flutter icon indicating copy to clipboard operation
datadog_flutter copied to clipboard

Deprecation of Community Plugin

Open tshedor opened this issue 3 years ago • 4 comments

The Datadog team has released an official version of their SDK. Since they are a team and very close to the APIs and features of the iOS and Android SDKs, it is with a heavy and joyful heart that version 2 of datadog_flutter will be the final release of this community package.

The migration is not exactly one to one. Below is a migration guide, however, as the new SDK has just reached beta, it is impartial (add more in the comments and I'll edit this list as we discover disparity). If you have questions about the new SDK or APIs, please open issues on the new repo. Good luck @fuzzybinary @xgouchet and thanks for your work in releasing this new SDK.

Thank you to everyone for your support and contributions to this plugin, especially @btrautmann @charafau @QuirijnGB.

Migration Guide (WIP)

  • Rename datadog_flutter to datadog_flutter_plugin. The Datadog team has decided to not use the datadog_flutter package name.
  • The initialization API is extremely similar, however, you cannot pass keys for different platforms. Instead, consider applicationId: Platform.isAndroid ? androidKey : iosKey. For apps that use web/linux/mac/windows too, you'll have to be more creative with your solution.
  • Use the global logger in DatadogSdk.instance.logs. While you can still use the individual logger architecture, the class isn't publicly exposed (DataDog/dd-sdk-flutter#121) as of writing.
  • Web is not supported by the new SDK yet. Do not migrate if you use Flutter web.
  • HTTP tracing has been mostly completely rewritten (cc #104). Please review the new datadog_trackiing_http_client package to integrate with your app. Don't forget to enable automatic capture.
  • DatadogObserver is now DatadogNavigationObserver

tshedor avatar May 17 '22 20:05 tshedor

Thank you for all the time and effort!

QuirijnGB avatar May 17 '22 21:05 QuirijnGB

Thanks a lot @tshedor for making and maintaining this plugin!

xgouchet avatar May 18 '22 06:05 xgouchet

Thank you!!

masterwok avatar Jun 22 '22 16:06 masterwok

Thanks so much for all your contribution!

brunovsiqueira avatar Jul 05 '22 21:07 brunovsiqueira