Xamarin.Forms 1.5.2.6469-pre1

Build native UIs for iOS, Android, and Windows Phone from a single, shared C# codebase

This is a prerelease version of Xamarin.Forms.
There is a newer version of this package available.
See the version list below for details.
Install-Package Xamarin.Forms -Version 1.5.2.6469-pre1
dotnet add package Xamarin.Forms --version 1.5.2.6469-pre1
<PackageReference Include="Xamarin.Forms" Version="1.5.2.6469-pre1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Xamarin.Forms --version 1.5.2.6469-pre1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Important Notes ##

This release is more alpha than most pre-releases. We want to get as much testing on the new optimization work as possible. Expect to see changes and more work landing into this release before promotion to stable.

## Enhancements ##

### New properties ###

These all do pretty much what you expect

- Editor.TextColor
- Entry.TextColor
- Editor.FontSize
- Editor.FontAttributes
- Editor.FontFamily

### New API ###

```csharp
public enum ListViewCachingStrategy
{
RetainElement = 0,
RecycleElement,
}
```

This new `enum` is used in conjuction with a new constructor for ListView, `ListView (ListViewCachingStrategy cachingStrategy)`. The default mode, RetainElement represents the old ListView behavior. It is also the default behavior if the old constructor is retained. The new behavior has the following characteristics.

- Only works on Android/iOS. Windows will simply get the old behavior no matter what.
- DataTemplate will be inflated to match as many native renderers for the cells are created.
- During virtualization, the Cell will have its binding context updated.

This means if an App opt into the new mode, the app must appropriately handle BindingContext updates. All data about the cell must come from the binding context or consistency errors may occur. If the cells are using custom renderers, it must ensure they properly implement property change notification. This mode is not always a pure performance win, testing is the only way to know for sure, however there are some basic guidelines:

 - Use RecycleElement if:
   - Cell BindingContext defines all properties/data about the View
   - Cells are largely similar and do not morphe dramatically based on BindingContext
   - The Cell has a moderate to small number of bindings
   - The Cell adheres well to the new performance guidelines below
 - Use RetainElement if:
   - Cells morph frequently
   - Cells have large numbers of bindings (20 to 30 tends to be the crossover point)
   - When testing RecycleElement, it is slower

Generally speaking, prefer RecycleElement as it can offer significant performance gains when in the fast path scenario. Eventually RetainElement may be phased out, however this will only happen once RetainElement no longer offers any performance advantage in any scenario.

### Layout Optimization ###

There is a new experimental layout optimization in this release of Xamarin.Forms. The optimization is complex and currently only impacts layout updates. Effectively the optimization serves to block InvalidateMeasure call chains. To get the best possible performance follow these performance guidelines:

- Leave the View.VerticalOptions and View.HorizontalOptions alone as much as possible. The default value of Fill or FillAndExpand allows for the best layout optimization.
- When using a StackLayout, make sure to have only one child set to Expand.
- Avoid RelativeLayout when possible.
- When using Grid, avoid Auto rows/columns if possible. Fixed row/cols are best. Stars are equally good if parent tree follows guidelines.
- When using AbsoluteLayout, avoid using AutoSize if possible.
- When using Labels, set the LineBreakMode to NoWrap whenever possible.

This optimization may impact the layout of your app. If you experience any differences at all, please report them as bugs. Further the optimization will work with the new ListView caching strategy, effectively doubling down on scrolling performance.

## Bug Fixes ##

[Bug 34632](https://bugzilla.xamarin.com/show_bug.cgi?id=34632) - Can't change IsPresented when setting SplitOnLandscape
[Bug 34556](https://bugzilla.xamarin.com/show_bug.cgi?id=34556) - Minimum version determination methods on iOS will fail once iOS hits version 10
[Bug 34549](https://bugzilla.xamarin.com/show_bug.cgi?id=34549) - Setting a BindableProperty of Type DateTime? to null raises Error
[Bug 34235](https://bugzilla.xamarin.com/show_bug.cgi?id=34235) - Xamarin.Forms.Platform.WinRT.TabbedPageRenderer OnElementChanged not virtual
[Bug 34061](https://bugzilla.xamarin.com/show_bug.cgi?id=34061) - RelativeLayout - First child added after page display does not appear
[Bug 34007](https://bugzilla.xamarin.com/show_bug.cgi?id=34007) - Z order drawing of children views are different on Android and iOS
[Bug 33764](https://bugzilla.xamarin.com/show_bug.cgi?id=33764) - Frame outline colour doesn't change using ViewModel
[Bug 33612](https://bugzilla.xamarin.com/show_bug.cgi?id=33612) - Removing a page from the navigation stack causes an 'Object reference' exception in Android only
[Bug 33499](https://bugzilla.xamarin.com/show_bug.cgi?id=33499) - Android WebViewRenderer doesn't unhook events properly
[Bug 32902](https://bugzilla.xamarin.com/show_bug.cgi?id=32902) - [iOS | iPad] App Crashes (without debug log) when Master Detail isPresented and navigation being popped
[Bug 32801](https://bugzilla.xamarin.com/show_bug.cgi?id=32801) - Memory Leak in TabbedPage + NavigationPage
[Bug 32447](https://bugzilla.xamarin.com/show_bug.cgi?id=32447) - [iOS] App crash when scrolling quickly through a TableView that has Pickers in the cells.
[Bug 32040](https://bugzilla.xamarin.com/show_bug.cgi?id=32040) - EntryCell.Tapped or SwitchCell.Tapped does not fire when within a TableView
[Bug 31366](https://bugzilla.xamarin.com/show_bug.cgi?id=31366) - Pushing and then popping a page modally cause ArgumentOutOfRangeException
[Bug 29257](https://bugzilla.xamarin.com/show_bug.cgi?id=29257) - CarouselPage.CurrentPage Does Not Work Properly When Used Inside a NavigationPage

## Other Fixes ##

- [A] Non-AppCompat backend no longer fails to redraw Frame correctly
- OnPlatform now passing the Windows value to WinRT projects. This API is being considered for replacement with something more extensible.
- OpenGLView now uses IOpenGLViewController for backend communication

NuGet packages (1.6K)

Showing the top 5 NuGet packages that depend on Xamarin.Forms:

Package Downloads
Xamarin.FFImageLoading.Forms
Xamarin Library to load images quickly and easily on Xamarin.Forms. Ensure you call CachedImageRenderer.Init() on each platform!!! Features: - Xamarin.iOS, Xamarin.Android, Xamarin.Forms, Xamarin.Mac and Windows (WinRT, UWP) support - Configurable disk and memory caching - Multiple image views using the same image source (url, path, resource) will use only one bitmap which is cached in memory (less memory usage) - Deduplication of similar download/load requests. *(If 100 similar requests arrive at same time then one real loading will be performed while 99 others will wait).* - Error and loading placeholders support - Images can be automatically downsampled to specified size (less memory usage) - Fluent API which is inspired by Picasso naming - SVG / WebP / GIF support - Image loading Fade-In animations support - Can retry image downloads (RetryCount, RetryDelay) - Android bitmap optimization. Saves 50% of memory by trying not to use transparency channel when possible. - Transformations support - BlurredTransformation - CircleTransformation, RoundedTransformation, CornersTransformation, CropTransformation - ColorSpaceTransformation, GrayscaleTransformation, SepiaTransformation, TintTransformation - FlipTransformation, RotateTransformation - Supports custom transformations (native platform `ITransformation` implementations)
Rg.Plugins.Popup
Plugin for Xamarin forms. Allows you to open any page as a popup.
Xamarin.Forms.Maps
Maps models and renderers for Xamarin.Forms
SkiaSharp.Views.Forms
SkiaSharp for Xamarin.Forms is a set of views that can be used to draw on the screen.
Caliburn.Micro
A small, yet powerful framework designed for Xaml platforms, Caliburn.Micro implements a variety of UI patterns for solving real-world problems. Patterns that are highlighted include MVVM (Presentation Model), MVP and MVC.

GitHub repositories (279)

Showing the top 5 popular GitHub repositories that depend on Xamarin.Forms:

Repository Stars
dotnet-architecture/eShopOnContainers
Cross-platform .NET sample microservices and container based application that runs on Linux Windows and macOS. Powered by .NET Core 3.0, Docker Containers and Azure Kubernetes Services. Supports Visual Studio, VS for Mac and CLI based environments with Docker CLI, dotnet CLI, VS Code or any other code editor.
microsoft/ailab
Experience, Learn and Code the latest breakthrough innovations with Microsoft AI
dotnet/BenchmarkDotNet
Powerful .NET library for benchmarking
reactiveui/ReactiveUI
An advanced, composable, functional reactive model-view-viewmodel framework for all .NET platforms that is inspired by functional reactive programming. ReactiveUI allows you to abstract mutable state away from your user interfaces, express the idea around a feature in one readable place and improve the testability of your application.
xamarin/Xamarin.Forms
Xamarin.Forms Official Home

Version History

Version Downloads Last updated
5.0.0.1558-pre3 1,608 10/15/2020
5.0.0.1539-pre2 1,329 10/7/2020
5.0.0.1487-pre1 3,923 9/23/2020
4.8.0.1560 21,480 10/15/2020
4.8.0.1534 27,786 10/7/2020
4.8.0.1451 86,484 9/16/2020
4.8.0.1364 80,610 8/31/2020
4.8.0.1269 166,245 8/6/2020
4.8.0.1238-pre3 2,023 7/30/2020
4.8.0.1187-pre2 2,089 7/23/2020
4.8.0.1143-pre1 1,939 7/15/2020
4.7.0.1351 7,578 8/27/2020
4.7.0.1260 22,593 8/5/2020
4.7.0.1239 44,127 7/30/2020
4.7.0.1179 50,543 7/22/2020
4.7.0.1142 60,101 7/15/2020
4.7.0.1080 95,652 7/1/2020
4.7.0.968 148,321 6/17/2020
4.7.0.937-pre4 6,140 6/11/2020
4.7.0.848-pre3 3,010 6/4/2020
4.7.0.813-pre2 5,611 5/19/2020
4.7.0.773-pre1 3,658 5/14/2020
4.6.0.1180 6,668 7/22/2020
4.6.0.1141 22,703 7/14/2020
4.6.0.1073 7,043 7/1/2020
4.6.0.967 28,888 6/17/2020
4.6.0.847 115,178 6/4/2020
4.6.0.800 165,844 5/19/2020
4.6.0.726 215,163 4/29/2020
4.6.0.616-pre4 11,293 4/9/2020
4.6.0.529-pre3 4,182 4/2/2020
4.6.0.494-pre2 5,164 3/25/2020
4.6.0.379-pre1 8,198 3/5/2020
4.5.0.725 41,160 4/29/2020
4.5.0.657 60,283 4/23/2020
4.5.0.617 164,880 4/9/2020
4.5.0.530 98,567 4/1/2020
4.5.0.495 105,380 3/25/2020
4.5.0.396 100,285 3/16/2020
4.5.0.356 264,741 2/26/2020
4.5.0.282-pre4 8,109 2/10/2020
4.5.0.266-pre3 3,027 2/5/2020
4.5.0.187-pre2 7,725 1/23/2020
4.5.0.142-pre1 4,097 1/13/2020
4.4.0.991864 27,623 3/23/2020
4.4.0.991757 37,888 2/26/2020
4.4.0.991640 146,685 2/5/2020
4.4.0.991537 112,567 1/23/2020
4.4.0.991477 97,507 1/10/2020
4.4.0.991265 271,440 12/12/2019
4.4.0.991220-pre3 4,208 12/4/2019
4.4.0.991210-pre2 9,792 11/14/2019
4.4.0.936621-pre1 8,438 10/31/2019
4.3.0.991250 50,730 12/12/2019
4.3.0.991221 78,704 12/4/2019
4.3.0.991211 186,047 11/14/2019
4.3.0.947036 163,421 10/29/2019
4.3.0.908675 211,150 10/21/2019
4.3.0.851321-pre3 13,765 10/2/2019
4.3.0.819712-pre2 12,926 9/19/2019
4.3.0.778476-pre1 16,486 9/11/2019
4.2.0.910310 52,975 10/21/2019
4.2.0.848062 201,475 10/2/2019
4.2.0.815419 107,464 9/19/2019
4.2.0.778463 79,897 9/11/2019
4.2.0.709249 236,332 8/21/2019
4.2.0.673161-pre3 12,160 8/7/2019
4.2.0.618605-pre2 13,763 7/24/2019
4.2.0.608146-pre1 7,710 7/16/2019
4.1.0.778454 30,760 9/11/2019
4.1.0.709244 41,003 8/21/2019
4.1.0.673156 131,169 8/7/2019
4.1.0.618606 141,733 7/24/2019
4.1.0.581479 166,989 7/9/2019
4.1.0.555618 312,511 6/28/2019
4.1.0.496342-pre2 12,132 6/13/2019
4.1.0.483098-pre1 8,747 6/5/2019
4.0.0.709238 14,823 8/21/2019
4.0.0.618610 6,137 7/24/2019
4.0.0.540366 61,818 6/27/2019
4.0.0.497661 83,075 6/13/2019
4.0.0.482894 72,621 6/3/2019
4.0.0.425677 286,472 5/14/2019
4.0.0.394984-pre10 12,743 5/3/2019
4.0.0.346134-pre9 22,362 4/18/2019
4.0.0.304370-pre8 16,862 4/3/2019
4.0.0.250467-pre7 11,170 3/20/2019
4.0.0.232914-pre6 11,781 3/14/2019
4.0.0.169046-pre5 9,310 2/21/2019
4.0.0.135214-pre4 7,695 2/6/2019
4.0.0.94569-pre3 7,566 1/24/2019
4.0.0.62955-pre2 19,245 1/10/2019
4.0.0.8055-pre1 17,589 12/4/2018
3.6.0.709228 49,436 8/21/2019
3.6.0.539721 41,227 6/27/2019
3.6.0.344457 418,719 4/18/2019
3.6.0.293080 121,202 4/3/2019
3.6.0.264807 208,866 3/19/2019
3.6.0.220655 162,115 3/6/2019
3.6.0.169048-pre2 3,536 2/21/2019
3.6.0.135200-pre1 9,884 2/6/2019
3.5.0.274416 38,666 3/26/2019
3.5.0.169047 172,826 2/20/2019
3.5.0.129452 269,054 2/6/2019
3.5.0.94564-pre3 3,891 1/24/2019
3.5.0.62956-pre2 4,006 1/10/2019
3.4.0.1039999 25,039 3/26/2019
3.4.0.1029999 114,386 1/24/2019
3.4.0.1009999 145,016 1/4/2019
3.4.0.1008975 616,266 11/15/2018
3.4.0.987044-pre2 4,958 11/8/2018
3.4.0.925479-pre1 16,736 10/18/2018
3.3.0.967583 207,891 11/1/2018
3.3.0.912540 208,944 10/18/2018
3.3.0.893527-pre3 13,003 10/11/2018
3.3.0.871608-pre2 19,191 10/1/2018
3.3.0.840541-pre1 11,032 9/20/2018
3.2.0.871581 148,234 10/3/2018
3.2.0.839982 222,601 9/17/2018
3.2.0.809874-pre3 7,312 9/10/2018
3.2.0.729530-pre2 18,632 8/14/2018
3.2.0.637442-pre1 15,837 7/17/2018
3.1.0.697729 469,342 8/1/2018
3.1.0.637273 131,380 7/11/2018
3.1.0.583944 193,506 6/20/2018
3.1.0.561732-pre4 9,376 6/11/2018
3.1.0.550168-pre3 5,869 6/6/2018
3.1.0.530888-pre2 4,860 6/4/2018
3.1.0.469394-pre1 15,200 5/9/2018
3.0.0.561731 165,868 6/11/2018
3.0.0.550146 33,671 6/6/2018
3.0.0.530893 29,549 6/4/2018
3.0.0.482510 338,506 5/14/2018
3.0.0.446417 181,847 5/1/2018
3.0.0.427558-pre4 12,890 4/25/2018
3.0.0.354232-pre3 17,797 4/5/2018
3.0.0.296286-pre2 11,466 3/20/2018
2.5.1.527436 122,854 5/4/2018
2.5.1.444934 208,362 4/4/2018
2.5.1.392594-pre3 6,669 3/21/2018
2.5.1.340284-pre2 10,143 3/9/2018
2.5.1.317207-pre1 8,194 3/1/2018
2.5.0.280555 392,957 2/16/2018
2.5.0.122203 409,113 12/18/2017
2.5.0.121934 330,710 11/28/2017
2.5.0.91635 250,960 11/16/2017
2.5.0.77107 40,238 11/13/2017
2.5.0.75255-pre3 8,201 11/10/2017
2.5.0.19271-pre2 12,641 10/20/2017
2.4.0.91020 58,199 11/16/2017
2.4.0.74863 39,582 11/10/2017
2.4.0.38779 68,799 10/30/2017
2.4.0.18342 62,127 10/20/2017
2.4.0.282 181,651 9/29/2017
2.4.0.280 257,610 9/27/2017
2.4.0.275-pre3 10,954 9/19/2017
2.4.0.269-pre2 17,479 8/29/2017
2.4.0.266-pre1 25,893 8/16/2017
2.3.5.256-pre6 41,258 6/29/2017
2.3.5.255-pre5 7,733 6/26/2017
2.3.5.239-pre3 31,819 5/11/2017
2.3.5.235-pre2 13,986 4/26/2017
2.3.5.233-pre1 12,157 4/13/2017
2.3.4.270 225,343 8/29/2017
2.3.4.267 80,262 8/16/2017
2.3.4.247 487,231 5/16/2017
2.3.4.231 250,631 4/12/2017
2.3.4.224 270,470 3/29/2017
2.3.4.221-pre6 10,879 3/27/2017
2.3.4.214-pre5 13,412 3/14/2017
2.3.4.212-pre4 9,100 3/10/2017
2.3.4.211-pre3 7,125 3/9/2017
2.3.4.192-pre2 22,769 2/3/2017
2.3.4.184-pre1 16,216 1/13/2017
2.3.3.193 276,506 2/1/2017
2.3.3.180 231,136 1/5/2017
2.3.3.175 124,878 12/6/2016
2.3.3.168 73,807 11/23/2016
2.3.3.166-pre4 10,117 11/3/2016
2.3.3.163-pre3 8,593 10/17/2016
2.3.3.152-pre2 18,798 9/15/2016
2.3.2.127 396,512 9/14/2016
2.3.2.118-pre1 8,905 8/3/2016
2.3.1.114 167,580 8/3/2016
2.3.1.113-pre3 5,903 7/19/2016
2.3.1.111-pre2 6,726 7/4/2016
2.3.1.110-pre1 4,543 6/29/2016
2.3.0.107 217,414 6/29/2016
2.3.0.49 101,456 6/16/2016
2.3.0.46-pre3 18,248 5/30/2016
2.3.0.38-pre2 15,575 4/27/2016
2.3.0.34-pre1 11,062 4/27/2016
2.2.0.45 150,657 5/30/2016
2.2.0.31 136,114 4/27/2016
2.2.0.23-pre4 5,067 4/20/2016
2.2.0.18-pre3 4,411 4/20/2016
2.2.0.5-pre2 18,066 4/8/2016
2.2.0.4-pre1 20,551 4/5/2016
2.1.0.6529 108,316 3/13/2016
2.1.0.6526 20,098 3/9/2016
2.1.0.6524 39,719 3/2/2016
2.1.0.6521 14,679 3/1/2016
2.1.0.6517-pre5 4,196 2/18/2016
2.1.0.6513-pre4 4,256 2/9/2016
2.1.0.6508-pre3 4,528 1/28/2016
2.1.0.6503-pre2 9,035 1/22/2016
2.1.0.6501-pre1 3,666 1/21/2016
2.1.0.6500-pre1 3,462 1/20/2016
2.0.1.6505 102,770 1/28/2016
2.0.1.6495 78,319 1/20/2016
2.0.1.6492-pre1 5,968 12/3/2015
2.0.0.6490 110,604 12/1/2015
2.0.0.6484 20,659 11/21/2015
2.0.0.6482 259,590 11/17/2015
1.5.2.6478-pre3 3,286 11/17/2015
1.5.2.6477-pre2 6,098 11/10/2015
1.5.2.6469-pre1 4,270 10/20/2015
1.5.1.6471 83,732 10/20/2015
1.5.1.6468 6,199 10/20/2015
1.5.1.6460-pre2 3,706 10/13/2015
1.5.1.6455-pre1 5,120 10/2/2015
1.5.0.6447 75,216 9/25/2015
1.5.0.6446 24,943 9/16/2015
1.5.0.6404-pre3 5,366 8/25/2015
1.5.0.6401-pre2 3,569 8/21/2015
1.5.0.6396-pre1 3,983 8/5/2015
1.4.4.6449 4,850 9/25/2015
1.4.4.6443 3,798 9/16/2015
1.4.4.6392 86,668 7/29/2015
1.4.4.6391 4,121 7/28/2015
1.4.4.6387 5,125 7/27/2015
1.4.4.6379-pre3 3,541 7/20/2015
1.4.4.6378-pre2 3,385 7/16/2015
1.4.4.6377-pre1 3,374 7/14/2015
1.4.3.6376 47,984 7/9/2015
1.4.3.6374 19,670 7/1/2015
1.4.3.6372 4,190 6/30/2015
1.4.3.6364-pre3 4,444 6/16/2015
1.4.3.6358-pre2 8,075 4/24/2015
1.4.3.6356-pre1 3,451 4/21/2015
1.4.2.6359 70,798 4/30/2015
1.4.2.6355 17,286 4/21/2015
1.4.2.6353-pre2 4,510 3/31/2015
1.4.2.6350-pre1 3,529 3/30/2015
1.4.1.6349 47,921 3/30/2015
1.4.1.6347-pre2 5,242 3/19/2015
1.4.1.6342-pre1 3,653 3/10/2015
1.4.0.6341 32,121 3/9/2015
1.4.0.6340-pre2 4,564 3/6/2015
1.4.0.6336-pre1 3,544 3/3/2015
1.3.5.6337 7,219 3/5/2015
1.3.5.6335 28,799 3/2/2015
1.3.5.6333-pre1 4,184 2/17/2015
1.3.4.6332 22,563 2/17/2015
1.3.4.6331-pre4 3,571 2/13/2015
1.3.4.6329-pre3 3,278 2/12/2015
1.3.4.6328-pre2 3,268 2/11/2015
1.3.4.6325-pre1 3,229 2/9/2015
1.3.3.6323 58,282 2/9/2015
1.3.3.6322-pre3 3,194 2/6/2015
1.3.3.6321-pre2 3,392 2/4/2015
1.3.3.6318-pre1 3,447 2/2/2015
1.3.2.6316 10,958 2/3/2015
1.3.2.6313-pre3 3,401 1/30/2015
1.3.2.6309-pre2 3,454 1/28/2015
1.3.2.6299-pre1 4,218 1/20/2015
1.3.1.6296 63,281 1/4/2015
1.3.1.6294-pre1 6,526 12/24/2014
1.3.0.6292 12,937 12/24/2014
1.3.0.6286-pre4 4,177 12/19/2014
1.3.0.6284-pre3 3,694 12/12/2014
1.3.0.6280-pre2 3,634 12/9/2014
1.3.0.6275-pre1 9,913 11/12/2014
1.2.3.6257 43,759 10/2/2014
1.2.3.6256-pre4 4,354 9/26/2014
1.2.3.6255-pre3 4,764 9/20/2014
1.2.3.6249-pre2 3,878 9/9/2014
1.2.3.6246-pre1 6,529 8/15/2014
1.2.2.6243 31,898 7/30/2014
1.2.2.6241-pre3 4,822 7/28/2014
1.2.2.6240-pre2 6,655 7/22/2014
1.2.2.6238-pre1 5,876 7/17/2014
1.2.1.6229 10,859 7/14/2014
1.1.1.6206 16,349 6/19/2014
1.1.0.6201 16,210 6/12/2014
1.0.6197 18,564 6/4/2014
1.0.6188 14,323 5/28/2014
Show less