As already mentioned in the release notes of v1.2.0 and our 1.3.0 pre-releases, this version will have a newer Xamarin.Forms dependency. This release has a minimum dependency of Xamarin.Forms v5.0.0.2125 (the current release of Xamarin.Forms).

Furthermore we now have a great set of pre built animations ready for you to use in the Toolkit! Go check out #1667 for all the details! CameraView got a good amount of fixes and improvements, just as the TouchEffect. All in all, a lot of great stuff for you to use to build your next amazing app. Enjoy!

✨ Added/Improved

• Increase Xamarin.Forms Dependency to v5.0.0.2125 (#1621)
• Update SemanticEffectPage and underlying logic for semantic effects (#1381)
• Accessibility improvement: SetSemanticInclusion (#1420)
• Added Speed Property to MediaElement (#1415)
• Compound Animations (#1667)

🐛 Fixes

• Fixes regression TouchEffect + Button/ImageButton (#1465)
• Fixes Expander Regression (#1467)
• [DrawingView] DrawingView.Points is now unique per instance (#1478)
• [ShadowEffect] Fixed System.InvalidOperationException: Invalid on Color.Default (#1490)
• Fix Toast CornerRadius (#1498)
• Fix touch effect for PanCakeView and similar controls #1493 (#1507)
• Fix ObjectDisposedException in Platform Touch Effect on Android (#1513)
• Fix TouchEffect inside ScrollView is stuck (#1534)
• Fix TouchEffect + CanExecute (#1558)
• [CameraView] [iOS] Flash does not work fix (#1563)
• iOS, macOS - Clean DrawingView on Lines clean (#1520)
• [Bug] Fixed CameraView crash on FlashMode Torch (#1522)
• [Bug] Fixed CameraView Shutter not responding (#1535)
• [Bug][CameraView][iOS] Video orientation (#1583)
• [Android] Fix TouchEffect issues (#1600)
• Fix TouchEffect + CanExecute on Android (#1622)
• Update the status bar frame when rotating (#1639)
• Fix Shadow Effect + Entry on Android (#1648)
• Reset shadow if corner radius is changed (iOS & UWP) (#1649)
• Remove iOS default padding (#1653) (#1668)
• Fix build, Fix snackbar action button color on android, fix ios action button font (#1673)
• #1652 Fix gesture lines are not cleared, fix build (#1676)
• [Bug Fix] ValidationBehavior crash due to bug in handling CancellationTokenSource (#1694)

🏠 Housekeeping

• Consolidate our XCT platform class (#1559)

We could not have done this release without you, so thank you: @bijington, @Tum4ik, @rachelkang, @VladislavAntonyuk, @prshelke, @GUOLDEV, @AndreiMisiukevich, @federicobenedetti and @kyletran407

And of course our awesome dedicated team members: @bijington, @jsuarezruiz, @pictos, @brminnick and... me 🤓

You're looking at the Maui compatible version of the Xamarin Community Toolkit!

Don't tell anyone yet 🤫

You're looking at the Maui compatible version of the Xamarin Community Toolkit!

Don't tell anyone yet ?

This release contains all the good stuff from pre1 (beware of the new Forms dependency!) but adds more!

What to think of improvements to CameraView?! Flash now works decent on iOS and the shutter keeps working for multiple times! Check out the full list below and let us know what you think!

✨ Added/Improved

• Accessibility improvement: SetSemanticInclusion (#1420)
• Added Speed Property to MediaElement (#1415)

🐛 Fixes

• Fix touch effect for PanCakeView and similar controls #1493 (#1507)
• Fix ObjectDisposedException in Platform Touch Effect on Android (#1513)
• Fix TouchEffect inside ScrollView is stuck (#1534)
• Fix toucheffect + canexecute (#1558)
• [CameraView] [iOS] Flash does not work fix (#1563)
• iOS, macOS - Clean DrawingView on Lines clean (#1520)
• [Bug] Fixed CameraView crash on FlashMode Torch (#1522)
• [Bug] Fixed CameraView Shutter not responding (#1535)

🏠 Housekeeping

• Consolidate our XCT platform class (#1559)

We could not have done this release without you, so thank you: @prshelke, @VladislavAntonyuk, @GUOLDEV

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @brminnick and... me 🤓

As already mentioned in the release notes of v1.2.0, this version will have a newer Xamarin.Forms dependency.

This release has a minimum dependency of Xamarin.Forms v5.0.0.2083 (the current release of Xamarin.Forms).

This version (2083) of Xamarin.Forms induces a breaking change in Xamarin Commmunity Toolkit by increasing its Xamarin.AndroidX.Core dependency.

Therefore in this Toolkit release, v1.3.0, we increased our Xamarin.Forms dependency to use this new version of Xamarin.Forms and resolve the breaking changes.

Other than that, lots of new goodies to play with and things that are fixed!

✨ Added/Improved

• [BREAKING] Update NuGet Packages, Remove Duplicate NuGet Packages (#1502)
• Update SemanticEffectPage and underlying logic for semantic effects (#1381)

🐛 Fixes

• Fixes regression TouchEffect + Button/ImageButton (#1465)
• Fixes Expander Regression (#1467)
• [DrawingView] DrawingView.Points is now unique per instance (#1478)
• [ShadowEffect] Fixed System.InvalidOperationException: Invalid on Color.Default (#1490)
• Fix Toast CornerRadius (#1498)

We could not have done this release without you, so thank you: @bijington, @Tum4ik, @rachelkang, @VladislavAntonyuk

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @brminnick and... me 🤓

Special Note About This Release

This release has a maximum dependency of Xamarin.Forms v5.0.0.2012 (the current release of Xamarin.Forms).

The upcoming version of Xamarin.Forms induces a breaking change in Xamarin.CommmunityToolkit by increasing its Xamarin.AndroidX.Core dependency.

In our next release, v1.3.0, we will increase our Xamarin.Forms dependency to use this new version of Xamarin.Forms and resolve the breaking changes.

Release Notes

From 1.1.0 straight to 1.2.0! That's how we roll. Our F# friends will be pretty pleased to find out that our little Toolkit now also works for them. We've also got MediaElement for Tizen, more converters, a shiny new HexLayout! And last but certainly not least, SemanticEffect and SemanticOrderView in order to make your app more accessible. Feeling the urge to doodle around? We now have a DrawingView that lets you do just that.

As a cherry on top; loads of bugfixes! Enjoy!

✨ Added/Improved

• Adds select all text effect implementation for UWP (#1067)
• Implemented shadow on UWP (#1102)
• [Tizen] Added MediaElement implementation (#1140)
• Implement CompareConverter (#1172)
• F# Support (#1133 & #1181)
• AnimationBehavior enhancements: (#1180)
• [Converter] Added StringToListConverter (#1132)
• Math expression converter (#1117)
• SideMenuView: New types of appearance | Parallax effect | Scale factor (#1192)
• HexLayout (#436)
• EnumToIntConverter (#1203)
• Base implementations for SemanticEffect and SemanticOrderView (#1240)
• Added MediaElement renderer for WPF (#1275)
• Color converters / extensions (#353)
• Change iOS Snackbar/Toast default background color (#1336)
• Fix iOS - can't show Popup from a modal page (#1400)

🐛 Fixes

• [iOS] Make RangeSlider more natural look like (#1109)
• AvatarView: Show initials if stream is empty (#1125)
• StateLayout: Init previousState field with LayoutState.None (#1122)
• CameraView: photoOutput != null check taken off. (#1119)
• Fix animation behavior fires command twice (#1162)
• Fix MultiValidationBehavior overwrites external BindingContext bindings (#1163)
• [iOS] Update save area on orientation (#1092)
• Fix NullReferenceException when displaying Toast or SnackBar (#963)
• Snackbar/Toast Anchor (#1005)
• RangeSlider: Fixed regression crash (#1212)
• Fix Invalid Cast Exception on iOS (#1244)
• Fix right menu scale factor issue (#1250)
• [Regression] Update shadow layer on property change (#1278)
• Fix Snackbar/Toast crashes on iOS 12.5.2 (#1285)
• [ShadowEffect] Fixes shadow on android buttons (#1289)
• [TouchEffect] Fix argument null ex (#1291)
• StateLayout: Throw meaningful error on invalid cast (#1287)
• AvatarView crashes if generic style is defined in App.xml (#1292)
• ShadowEffect's shadow doesn't follow button's perimeter (#1298)
• TouchEffect NativeAmination doesn't work on images with TapGestureRecognizer (#1304)
• CameraView Video Recording Fix raising events with empty file on Android (#1258)
• Binding error on views inside a TabViewItem if the TabView page itself has a Binding defined (#1297)
• Added cache Context value (#1351)
• Allow null to be passed as a parameter to Execute and CanExecute if the target is a Nullable type (#1356)
• Fixed bugs with math expression converter (#1369)
• Fixes Popup Crashes on Android API 22 and Lower (#1367)
• Set anchor view only for pages, fix NativeSnackButton (#1378)
• Add defensive code to prevent possible NRE cause in SafeAreaEffect (#1404)
• [TabView] Fix oldPosition newPostion args issue (#1361)
• Fix Nested Touch Effects (#1435)

💀 Deprecated

• Deprecate WeekSubscribe method due to high probability of misuse (#1106)

🏡 Housekeeping

• Generate Mdoc documentation files (#932)
• Update dependencies (#1174)
• Fix UWP sample app (#1416)

We could not have done this release without you, so thank you: @Alex-Witkowski, @Cfun1, @sattew, @JoonghyunCho, @bijington, @GUOLDEV, @maxkoshevoi, @geskill, @VladislavAntonyuk, @Axemasta, @Hottemax, @peterfoot, @dansiegel, @framinosona, @ahoefling

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen, @brminnick and... me 🤓

Already preview 2 🤯, this of course has all the goodies from preview 1, and more! Check it out below.

✨ Added/Improved

• Added MediaElement renderer for WPF (#1275)
• Color converters / extensions (#353)

🐛 Fixes

• [Regression] Update shadow layer on property change (#1278)
• Fix Snackbar/Toast crashes on iOS 12.5.2 (#1285)
• [ShadowEffect] Fixes shadow on android buttons (#1289)
• [TouchEffect] Fix argument null ex (#1291)
• StateLayout: Throw meaningful error on invalid cast (#1287)

We could not have done this release without you, so thank you: @peterfoot, @VladislavAntonyuk, @dansiegel, @framinosona

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen, @brminnick and... me 🤓

From 1.1.0 straight to 1.2.0! That's how we roll. This is just a pre-release, but just look at all the goodness that is in there. Our F# friends will be pretty pleased to find out that our little Toolkit now also works for them. We've also got MediaElement for Tizen, more converters, a shiny new HexLayout! And last but certainly not least, SemanticEffect and SemanticOrderView in order to make your app more accessible.

As a cherry on top; loads of bugfixes! Enjoy!

✨ Added/Improved

• Adds select all text effect implementation for UWP (#1067)
• Implemented shadow on UWP (#1102)
• [Tizen] Added MediaElement implementation (#1140)
• Implement CompareConverter (#1172)
• F# Support (#1133 & #1181)
• AnimationBehavior enhancements: (#1180)
• [Converter] Added StringToListConverter (#1132)
• Math expression converter (#1117)
• SideMenuView: New types of appearance | Parallax effect | Scale factor (#1192)
• HexLayout (#436)
• EnumToIntConverter (#1203)
• Base implementations for SemanticEffect and SemanticOrderView (#1240)

🐛 Fixes

• [iOS] Make RangeSlider more natural look like (#1109)
• AvatarView: Show initials if stream is empty (#1125)
• StateLayout: Init previousState field with LayoutState.None (#1122)
• Fix Expander crash when Direction changed (#1147)
• CameraView: photoOutput != null check taken off. (#1119)
• Fix animation behavior fires command twice (#1162)
• Fix MultiValidationBehavior overwrites external BindingContext bindings (#1163)
• [iOS] Update save area on orientation (#1092)
• Fix NullReferenceException when displaying Toast or SnackBar (#963)
• Snackbar/Toast Anchor (#1005)
• RangeSlider: Fixed regression crash (#1212)
• Fix Invalid Cast Exception on iOS (#1244)
• Fix right menu scale factor issue (#1250)

💀 Deprecated

• Deprecate WeekSubscribe method due to high probability of misuse (#1106)

🏡 Housekeeping

• Generate Mdoc documentation files (#932)
• Update dependencies (#1174)

We could not have done this release without you, so thank you: @Alex-Witkowski, @Cfun1, @sattew, @JoonghyunCho, @bijington, @GUOLDEV, @maxkoshevoi, @geskill, @VladislavAntonyuk, @Axemasta, @Hottemax

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen, @brminnick and... me 🤓

Just look at the list below and you'll know that I cannot do this release any justice with some words here. Very grateful for all the work that has been put in by our team and contributors. We have complete new controls like LazyView, Popup and the ShadowEffect. But also lots of bugfixes and other things that were added to existing features.

One thing to be aware of: this release enables nullability, which is a good thing, but make sure to check all your nulls so that everything works correctly.

We hope you'll love this release just as much as we do. If there is anything you need, just let us know! Enjoy!

PS. from here on out we're trying to keep to a more strict release schedule so you know when to expect something and releases will also be a bit smaller and easier to digest :) more on that soon!

✨ Added

• Enum to boolean converter (#925)
• Add VSM to ValidationBehavior (#955)
• Add Scale support for SideMenuView (#1011)
• Enable Nullable (#1009) ❗
• Add SetFocusOnEntryCompleted (#841)
• Added new TextCaseType to TextCaseConverter (#763)
• Add LocalizedString class for automatic ViewModel string updates (#750)
• Add CommandFactory class (#797)
• ShadowEffect (#725)
• Implemented LazyView (#796)
• Adds Popup Control (#653)
• No padding around text in a Toast or Snackbar (#714) (bug, added? I'm an optimistic guy)
• Make ShieldView more customizable (#874)
• ProgressBar Attached Property to enable progress animation (#352)
• Add "Add(IEnumerable<T> collection)" to ObservableRangeCollection<T>
• LifeCycleEvents (#674)
• Add Grouping class from Refractored.MvvmHelpers (#957)

🐛 Fixes

• For WPF, Use Cross-Platform Implementation for BaseCommand.IsMainThread and BaseCommand.BeginInvokeOnMainThread (#965)
• Fix Java.Lang.NoSuchMethodError in TouchEffect (#971)
• Add null-check to prevent NRE on MediaElement for iOS (#982)
• View is stuck in pressed state when fast click (if PressedAnimationDuration is set) (#975)
• Fix LocalizedString gets unsubscribed while still in use (#987)
• Avoid ImageButtonRenderer ObjectDisposedException on Android (#996)
• [iOS] Fix missing binding context for popup view (#1003)
• Fix AvatarView UriImageSource Stream closed exception (#1052 & #1042)
• Changed LoadView to be Async (#828)
• Popup out of the screen horizontally in Android sample (#839)
• [Android] Converting dimensions to pixels in popup renderer (#856)
• SourceLink Support reinstated
• [iOS] Remove popup arrow if anchor isn't set (#854)
• [Breaking Change] ValidationBehavior Async checks support (#912)

💀 Deprecated

• Deprecate LocalizationResourceManager.SetCulture (#766)

🏡 Housekeeping

• Refactoring: Remove redundant logic from "Not" converters (#935)
• Fix Singleton Pattern for LocalizationResourceManager (#919)
• Adding converter samples (#954)

We could not have done this release without you, so thank you: @maxkoshevoi, @geskill, @Cfun1, @WebDucer and @jmegner, @JoacimWall, @ahoefling, @geskill, @Cfun1, @VladislavAntonyuk, @Depechie, @Hackavist

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen, @brminnick and... me 🤓

This pre-release brings some new goodies, more bugfixes and under the hood improvements. Biggest change is enabling nullability! We bit the bullet and made the whole library null proof. We'd love for you to try it out and let us know if you see anything weird because of this and start adapting your own apps as needed. Happy coding!

✨ Added

• Enum to boolean converter (#925)
• Add VSM to ValidationBehavior (#955)
• Add Scale support for SideMenuView (#1011)
• Enable Nullable (#1009) ❗
• Add SetFocusOnEntryCompleted (#841)

🐛 Fixes

• For WPF, Use Cross-Platform Implementation for BaseCommand.IsMainThread and BaseCommand.BeginInvokeOnMainThread (#965)
• Fix Java.Lang.NoSuchMethodError in TouchEffect (#971)
• Add null-check to prevent NRE on MediaElement for iOS (#982)
• View is stuck in pressed state when fast click (if PressedAnimationDuration is set) (#975)
• Fix LocalizedString gets unsubscribed while still in use (#987)
• Avoid ImageButtonRenderer ObjectDisposedException on Android (#996)
• [iOS] Fix missing binding context for popup view (#1003)
• Fix AvatarView UriImageSource Stream closed exception (#1052 & #1042)

🏡 Housekeeping

• Refactoring: Remove redundant logic from "Not" converters (#935)
• Fix Singleton Pattern for LocalizationResourceManager (#919)

We could not have done this release without you, so thank you: @maxkoshevoi, @geskill, @Cfun1, @WebDucer and @jmegner

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen, @brminnick and... me 🤓