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
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

Version History

Version Downloads Last updated
4.0.0.135214-pre4 2,477 2/6/2019
4.0.0.94569-pre3 3,212 1/24/2019
4.0.0.62955-pre2 7,288 1/10/2019
4.0.0.8055-pre1 9,404 12/4/2018
3.6.0.135200-pre1 318 2/6/2019
3.5.0.129452 29,848 2/6/2019
3.5.0.94564-pre3 461 1/24/2019
3.5.0.62956-pre2 592 1/10/2019
3.4.0.1029999 36,832 1/24/2019
3.4.0.1009999 52,540 1/4/2019
3.4.0.1008975 202,059 11/15/2018
3.4.0.987044-pre2 2,039 11/8/2018
3.4.0.925479-pre1 7,182 10/18/2018
3.3.0.967583 116,343 11/1/2018
3.3.0.912540 81,899 10/18/2018
3.3.0.893527-pre3 4,550 10/11/2018
3.3.0.871608-pre2 7,476 10/1/2018
3.3.0.840541-pre1 3,665 9/20/2018
3.2.0.871581 72,113 10/3/2018
3.2.0.839982 89,355 9/17/2018
3.2.0.809874-pre3 3,093 9/10/2018
3.2.0.729530-pre2 8,998 8/14/2018
3.2.0.637442-pre1 7,571 7/17/2018
3.1.0.697729 270,909 8/1/2018
3.1.0.637273 83,104 7/11/2018
3.1.0.583944 117,862 6/20/2018
3.1.0.561732-pre4 5,540 6/11/2018
3.1.0.550168-pre3 2,654 6/6/2018
3.1.0.530888-pre2 1,569 6/4/2018
3.1.0.469394-pre1 10,612 5/9/2018
3.0.0.561731 129,748 6/11/2018
3.0.0.550146 24,218 6/6/2018
3.0.0.530893 18,307 6/4/2018
3.0.0.482510 193,853 5/14/2018
3.0.0.446417 107,710 5/1/2018
3.0.0.427558-pre4 8,188 4/25/2018
3.0.0.354232-pre3 12,888 4/5/2018
3.0.0.296286-pre2 7,798 3/20/2018
2.5.1.527436 67,150 5/4/2018
2.5.1.444934 142,767 4/4/2018
2.5.1.392594-pre3 3,934 3/21/2018
2.5.1.340284-pre2 5,622 3/9/2018
2.5.1.317207-pre1 5,394 3/1/2018
2.5.0.280555 287,870 2/16/2018
2.5.0.122203 292,420 12/18/2017
2.5.0.121934 185,939 11/28/2017
2.5.0.91635 121,511 11/16/2017
2.5.0.77107 27,092 11/13/2017
2.5.0.75255-pre3 5,162 11/10/2017
2.5.0.19271-pre2 8,737 10/20/2017
2.4.0.91020 41,616 11/16/2017
2.4.0.74863 33,178 11/10/2017
2.4.0.38779 57,357 10/30/2017
2.4.0.18342 52,972 10/20/2017
2.4.0.282 152,872 9/29/2017
2.4.0.280 173,476 9/27/2017
2.4.0.275-pre3 7,790 9/19/2017
2.4.0.269-pre2 13,221 8/29/2017
2.4.0.266-pre1 18,308 8/16/2017
2.3.5.256-pre6 33,441 6/29/2017
2.3.5.255-pre5 4,636 6/26/2017
2.3.5.239-pre3 27,128 5/11/2017
2.3.5.235-pre2 10,953 4/26/2017
2.3.5.233-pre1 8,788 4/13/2017
2.3.4.270 127,934 8/29/2017
2.3.4.267 62,712 8/16/2017
2.3.4.247 378,094 5/16/2017
2.3.4.231 200,149 4/12/2017
2.3.4.224 239,897 3/29/2017
2.3.4.221-pre6 7,115 3/27/2017
2.3.4.214-pre5 9,997 3/14/2017
2.3.4.212-pre4 5,985 3/10/2017
2.3.4.211-pre3 3,828 3/9/2017
2.3.4.192-pre2 18,883 2/3/2017
2.3.4.184-pre1 12,222 1/13/2017
2.3.3.193 231,815 2/1/2017
2.3.3.180 203,676 1/5/2017
2.3.3.175 115,872 12/6/2016
2.3.3.168 64,583 11/23/2016
2.3.3.166-pre4 7,593 11/3/2016
2.3.3.163-pre3 6,202 10/17/2016
2.3.3.152-pre2 15,397 9/15/2016
2.3.2.127 259,335 9/14/2016
2.3.2.118-pre1 6,646 8/3/2016
2.3.1.114 153,116 8/3/2016
2.3.1.113-pre3 3,663 7/19/2016
2.3.1.111-pre2 4,617 7/4/2016
2.3.1.110-pre1 2,301 6/29/2016
2.3.0.107 194,489 6/29/2016
2.3.0.49 83,672 6/16/2016
2.3.0.46-pre3 15,578 5/30/2016
2.3.0.38-pre2 12,792 4/27/2016
2.3.0.34-pre1 8,472 4/27/2016
2.2.0.45 116,344 5/30/2016
2.2.0.31 125,592 4/27/2016
2.2.0.23-pre4 2,946 4/20/2016
2.2.0.18-pre3 2,160 4/20/2016
2.2.0.5-pre2 15,828 4/8/2016
2.2.0.4-pre1 18,368 4/5/2016
2.1.0.6529 96,281 3/13/2016
2.1.0.6526 17,108 3/9/2016
2.1.0.6524 32,449 3/2/2016
2.1.0.6521 11,682 3/1/2016
2.1.0.6517-pre5 1,943 2/18/2016
2.1.0.6513-pre4 1,923 2/9/2016
2.1.0.6508-pre3 2,244 1/28/2016
2.1.0.6503-pre2 6,829 1/22/2016
2.1.0.6501-pre1 1,390 1/21/2016
2.1.0.6500-pre1 1,212 1/20/2016
2.0.1.6505 91,563 1/28/2016
2.0.1.6495 74,121 1/20/2016
2.0.1.6492-pre1 3,677 12/3/2015
2.0.0.6490 95,171 12/1/2015
2.0.0.6484 17,531 11/21/2015
2.0.0.6482 233,259 11/17/2015
1.5.2.6478-pre3 1,104 11/17/2015
1.5.2.6477-pre2 3,687 11/10/2015
1.5.2.6469-pre1 2,007 10/20/2015
1.5.1.6471 75,027 10/20/2015
1.5.1.6468 3,707 10/20/2015
1.5.1.6460-pre2 1,485 10/13/2015
1.5.1.6455-pre1 2,824 10/2/2015
1.5.0.6447 51,850 9/25/2015
1.5.0.6446 21,156 9/16/2015
1.5.0.6404-pre3 3,126 8/25/2015
1.5.0.6401-pre2 1,336 8/21/2015
1.5.0.6396-pre1 1,793 8/5/2015
1.4.4.6449 2,512 9/25/2015
1.4.4.6443 1,477 9/16/2015
1.4.4.6392 75,283 7/29/2015
1.4.4.6391 1,846 7/28/2015
1.4.4.6387 2,785 7/27/2015
1.4.4.6379-pre3 1,374 7/20/2015
1.4.4.6378-pre2 1,201 7/16/2015
1.4.4.6377-pre1 1,191 7/14/2015
1.4.3.6376 40,592 7/9/2015
1.4.3.6374 16,298 7/1/2015
1.4.3.6372 1,902 6/30/2015
1.4.3.6364-pre3 2,156 6/16/2015
1.4.3.6358-pre2 5,582 4/24/2015
1.4.3.6356-pre1 1,299 4/21/2015
1.4.2.6359 59,979 4/30/2015
1.4.2.6355 13,969 4/21/2015
1.4.2.6353-pre2 2,335 3/31/2015
1.4.2.6350-pre1 1,402 3/30/2015
1.4.1.6349 43,952 3/30/2015
1.4.1.6347-pre2 3,082 3/19/2015
1.4.1.6342-pre1 1,540 3/10/2015
1.4.0.6341 28,389 3/9/2015
1.4.0.6340-pre2 2,347 3/6/2015
1.4.0.6336-pre1 1,372 3/3/2015
1.3.5.6337 4,934 3/5/2015
1.3.5.6335 23,422 3/2/2015
1.3.5.6333-pre1 1,933 2/17/2015
1.3.4.6332 18,148 2/17/2015
1.3.4.6331-pre4 1,384 2/13/2015
1.3.4.6329-pre3 1,127 2/12/2015
1.3.4.6328-pre2 1,131 2/11/2015
1.3.4.6325-pre1 1,097 2/9/2015
1.3.3.6323 51,643 2/9/2015
1.3.3.6322-pre3 1,087 2/6/2015
1.3.3.6321-pre2 1,243 2/4/2015
1.3.3.6318-pre1 1,250 2/2/2015
1.3.2.6316 7,493 2/3/2015
1.3.2.6313-pre3 1,228 1/30/2015
1.3.2.6309-pre2 1,276 1/28/2015
1.3.2.6299-pre1 1,985 1/20/2015
1.3.1.6296 54,155 1/4/2015
1.3.1.6294-pre1 4,255 12/24/2014
1.3.0.6292 9,362 12/24/2014
1.3.0.6286-pre4 1,987 12/19/2014
1.3.0.6284-pre3 1,490 12/12/2014
1.3.0.6280-pre2 1,439 12/9/2014
1.3.0.6275-pre1 7,716 11/12/2014
1.2.3.6257 38,169 10/2/2014
1.2.3.6256-pre4 2,132 9/26/2014
1.2.3.6255-pre3 2,525 9/20/2014
1.2.3.6249-pre2 1,701 9/9/2014
1.2.3.6246-pre1 4,227 8/15/2014
1.2.2.6243 28,140 7/30/2014
1.2.2.6241-pre3 2,634 7/28/2014
1.2.2.6240-pre2 4,470 7/22/2014
1.2.2.6238-pre1 3,591 7/17/2014
1.2.1.6229 8,273 7/14/2014
1.1.1.6206 14,049 6/19/2014
1.1.0.6201 13,151 6/12/2014
1.0.6197 4,025 6/4/2014
1.0.6188 11,469 5/28/2014
Show less