Feature/upgrade announcer widget

[twklessor]

Add UpgradeAnnouncer widget. This widget should be used at the top of the widget tree just below MaterialApp. Uses a MaterialBanner with showMaterialBanner. We utilize the scaffoldMessengerKey to make this possible.

This has a distinct advantage over the UpgradeAlert as the MaterialBanner is shown globally; also during navigation.

This is the MaterialBanner shown globally;

When the MaterialBanner is tapped a bottom sheet is shown with the appropriate release notes;

The UpgradeAnnouncer also supports what is called enforceUpgrade which uses the Upgrader.minAppVersion to enforce an update if the current version is lower. This presents a dialog that cannot be dismissed; similar to what the UpgradeAlert supports;

Simple example of usage;

      MaterialApp(
        scaffoldMessengerKey: rootScaffoldMessengerKey,
        home: UpgradeAnnouncer(
          scaffoldMessengerKey: rootScaffoldMessengerKey,
          child: Scaffold(
            body: const Placeholder(),
            appBar: AppBar(title: const Text('Upgrader test')),
          ),
        ),
      );

Example with customizable icons, text styles and colors;

      const backgroundColor = Colors.red;
      const infoIcon = Icons.add;
      const infoIconColor = Colors.blue;
      const downloadIcon = Icons.abc;
      const downloadIconColor = Colors.yellow;
      const titleTextStyle = TextStyle(color: Colors.amber, fontSize: 20);
      const bottomSheetTitleTextStyle =
          TextStyle(color: Colors.orange, fontSize: 25);
      const bottomSheetReleaseNotesTextStyle =
          TextStyle(color: Colors.purple, fontSize: 30);
      const bottomSheetBackgroundColor = Colors.teal;

      MaterialApp(
        scaffoldMessengerKey: rootScaffoldMessengerKey,
        home: UpgradeAnnouncer(
          scaffoldMessengerKey: rootScaffoldMessengerKey,
          backgroundColor: backgroundColor,
          infoIcon: infoIcon,
          infoIconColor: infoIconColor,
          downloadIcon: downloadIcon,
          downloadIconColor: downloadIconColor,
          titleTextStyle: titleTextStyle,
          bottomSheetTitleTextStyle: bottomSheetTitleTextStyle,
          bottomSheetReleaseNotesTextStyle: bottomSheetReleaseNotesTextStyle,
          bottomSheetBackgroundColor: bottomSheetBackgroundColor,
          child: Scaffold(
            body: const Placeholder(),
            appBar: AppBar(title: const Text('Upgrader test')),
          ),
        ),
      );

This new UpgradeAnnouncer widget is fully backed by a test.

[twklessor]

@larryaasen We are considering making a fork of this package with our additions if it doesn't "fit the cake" but frankly we want to avoid that. We want to give back what you've already given us. We are very open to any feedback, changes or improvements. The UpgradeAnnouncer does have some overlapping features compared to the UpgradeAlert but they do compliment each other.

We already use the UpgradeAnnouncer in 2 production apps.

[codecov]

Codecov Report

Attention: Patch coverage is 97.88732% with 3 lines in your changes missing coverage. Please review.

Project coverage is 91.38%. Comparing base (7d08b0b) to head (ec6d719).
Report is 5 commits behind head on master.

Files with missing lines	Patch %	Lines
lib/src/upgrade_announcer.dart	97.79%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #464      +/-   ##
==========================================
+ Coverage   90.56%   91.38%   +0.82%     
==========================================
  Files          13       14       +1     
  Lines        1229     1382     +153     
==========================================
+ Hits         1113     1263     +150     
- Misses        116      119       +3     

Flag	Coverage Δ
	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.