Xamarin.Forms 2.3.3.166-pre4

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 2.3.3.166-pre4
dotnet add package Xamarin.Forms --version 2.3.3.166-pre4
paket add Xamarin.Forms --version 2.3.3.166-pre4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

### Important notes

* Xamarin.Forms 2.3.3 depends on a Xamarin installation of Cycle 8. Users upgrading from Xamarin.Forms 2.3.2 (or earlier) will experience numerous compile errors if they attempt to build without first upgrading their Xamarin installation.
* When upgrading Xamarin.Forms take care not to simply "update all" as that will update the Xamarin.Android.Support packages to an incompatible version. More info [here](https://developer.xamarin.com/guides/xamarin-forms/troubleshooting/).
* In 2.3.3 we are deprecating Classic support (More info [here](https://developer.xamarin.com/guides/cross-platform/macios/unified/)).

# 2.3.3 pre4

## Bug Fixes
* [44338](https://bugzilla.xamarin.com/show_bug.cgi?id=44338) - "Displaying context action causes ArgumentNullException when another item's context actions are already displayed on iOS10." ([PR](https://github.com/xamarin/Xamarin.Forms/pull/442))
* "[Win] Toolbar placement works with initial value" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/488))
* "[Android] SoftInputMode works with initial value" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/465))

# 2.3.3-pre3

## Bug Fixes
* [44129](https://bugzilla.xamarin.com/show_bug.cgi?id=44129) - "[Forms Android] Removing and adding items to TabbedPage BindingContext crashes the app when VM uses MvvmLight property Set()-method" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/453))
* [44166](https://bugzilla.xamarin.com/show_bug.cgi?id=44166) - "41166 - Fix MasterDetailPage/NavigationPage leaks on iPad" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/426))
* [44596](https://bugzilla.xamarin.com/show_bug.cgi?id=44596) - "Grey/Blank Screen when switching MainPage to MasterDetail with TabbedPage" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/421))
* [45010](https://bugzilla.xamarin.com/show_bug.cgi?id=45010) - "[2.3.3] 45010 – Forms Sample "WorkingWithListview" throw exception with WinPhone8.1" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/416))
* [44166](https://bugzilla.xamarin.com/show_bug.cgi?id=44166) - "MasterDetailPage instances do not get disposed upon GC; instance accumulation crashes app with OOM error using Forms 2.3.2.118-pre1 and AppCompat" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/412))
* Don't unsubscribe/resubscribe the listener to the same INPC ([PR](https://github.com/xamarin/Xamarin.Forms/pull/384))
* [44886](https://bugzilla.xamarin.com/show_bug.cgi?id=44886) - "UWP Listview ItemSelected event triggered twice for each selection" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/402))
* [iOS] Fixes KVO native binding ([PR](https://github.com/xamarin/Xamarin.Forms/pull/403))
* Make CreateNativeControl virtual instead of abstract ([PR](https://github.com/xamarin/Xamarin.Forms/pull/406))
* [43993](https://bugzilla.xamarin.com/show_bug.cgi?id=43993) - "iOS: ListView size does not return to normal after keyboard disappears" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/333
))
* [39768](https://bugzilla.xamarin.com/show_bug.cgi?id=39768) - "PanGestureRecognizer sometimes won't fire completed event when dragging very slowly" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/389))
* [42602](https://bugzilla.xamarin.com/show_bug.cgi?id=42602) - "Custom BoxView Renderer Does Not Render All Its Children Elements" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/322))
* [Xaml] Xaml native views and bindings for WP8.1 ([PR](https://github.com/xamarin/Xamarin.Forms/pull/363))
* [XamlC] Compiled converters ([PR](https://github.com/xamarin/Xamarin.Forms/pull/358))
* [Xaml] allow compatible arguments for x:Factory ([PR](https://github.com/xamarin/Xamarin.Forms/pull/382))
* [XAMLC] specify type and default value for native bindings ([PR](https://github.com/xamarin/Xamarin.Forms/pull/376))
* [2.3.3-pre2] [XamlC] supports enum and consts in x:Static ([PR](https://github.com/xamarin/Xamarin.Forms/pull/369))
* Reuse Handler when invoking on main thread ([PR](https://github.com/xamarin/Xamarin.Forms/pull/383))

# 2.3.3-pre2

Nuget package [here]().

## New Features

#### Support native view declaration in Xaml, and native Bindings

The following Xaml is valid, and works as expected:

```
<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="https://schemas.microsoft.com/winfx/2009/xaml"
xmlns:ios="clr-namespace:UIKit;assembly=Xamarin.iOS;targetPlatform=iOS"
xmlns:androidWidget="clr-namespace:Android.Widget;assembly=Mono.Android;targetPlatform=Android"
xmlns:formsandroid="clr-namespace:Xamarin.Forms;assembly=Xamarin.Forms.Platform.Android;targetPlatform=Android"
xmlns:win="clr-namespace:Windows.UI.Xaml.Controls;assembly=Windows, Version=255.255.255.255, Culture=neutral, PublicKeyToken=null, ContentType=WindowsRuntime;targetPlatform=Windows"
      x:Class="Xamarin.Forms.Controls.XamlNativeViews">
<ContentPage.Content>
<ios:UILabel Text="{Binding NativeText}" View.HorizontalOptions="Start"/>
<androidWidget:TextView Text="{Binding NativeText}" x:Arguments="{x:Static formsandroid:Forms.Context}" />
<win:TextBlock Text="Foo"/>
</ContentPage.Content>
</ContentPage>
```

- native views are automagically wrapped into the appropriate wrapper
- xmlns  defined on a non-matching targetPlatform (see TargetPlatform enumeration) are ignored
- you can bind to property of native views. A proxy is created on the fly for supporting 2-Way bindings if possible. If the native property doesn't implements INPC, or support Observable (on iOS), or is a DependencyProperty (on UWP), you can pass an `UpdateSourceEventName` parameter to the binding expression.
- if you set, or bind to, attached BindableProperty to a native view that will be wrapped in a X.F.View, those property values and binding are transferred to the wrapper. See HorizontalOptions in the sample above.


#### Platform Specifics
*Introducing Platform Specifics!* Features or behaviors that apply to one platform only can now be implemented without requiring custom renderers. These new features/behaviors can then be accessed easily via a fluent code API or XAML.

Vendors can easily add their own Platform Specifics by attaching Effects to them (see [63a924d](https://github.com/xamarin/Xamarin.Forms/commit/63a924d) and [1f9482e](https://github.com/xamarin/Xamarin.Forms/commit/1f9482e4b5969f19fcde5c691443fcccc848c54e) for complete example).

This feature implements the framework that enables the new API and also includes several examples of platform specific features, which can be previewed using the Platform Specifics gallery page:

* Blur support for any VisualElement on iOS
* Translucent navigation bar on iOS
* Partially collapsed navigation bar (with icons!) on MasterDetailPage on Windows
* Toolbar placement options on Windows
* AdjustResize/AdjustPan on Android (known issue: AdjustResize disables status bar color)

## Bug Fixes
* [32733](https://bugzilla.xamarin.com/show_bug.cgi?id=32733) - "32733 – Switching Activity crash in 1.4.4.6392" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/286))
* [35132](https://bugzilla.xamarin.com/show_bug.cgi?id=35132) - "35132 – Pages are not collected when using a Navigationpage"
* [39768](https://bugzilla.xamarin.com/show_bug.cgi?id=39768) - "PanGestureRecognizer sometimes won't fire completed event when dragging very slowly" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/313))
* [39908](https://bugzilla.xamarin.com/show_bug.cgi?id=39908) - "Back button hit quickly results in jumbled pages" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/291))
* [41463](https://bugzilla.xamarin.com/show_bug.cgi?id=41463) - "CarouselView Crashes with "Sequence Does not Contain a Matching Element""
* [42061](https://bugzilla.xamarin.com/show_bug.cgi?id=42061) - "App crashes when registering an app link entry with invalid thumbnail url" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/299))
* [42112](https://bugzilla.xamarin.com/show_bug.cgi?id=42112) - "42112 - CarouselView throws error on Android while moving"
* [42341](https://bugzilla.xamarin.com/show_bug.cgi?id=42341) - "Page not removed from NavigationStack when hit Back quickly on iOS" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/291))
* [42519](https://bugzilla.xamarin.com/show_bug.cgi?id=42519) - "Text Truncation in UWP"
* [42697](https://bugzilla.xamarin.com/show_bug.cgi?id=42697) - "Slow swipe - System.InvalidOperationException: Sequence contains more than one element [CarouselView]"
* [43230](https://bugzilla.xamarin.com/show_bug.cgi?id=43230) - "DisplayAlert returns unexpected value when Escape key hit on UWP" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/292))
* [43328](https://bugzilla.xamarin.com/show_bug.cgi?id=43328) - "DisplayActionSheet() double-tap NullReferenceException crash Win8.1" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/305))
* [43354](https://bugzilla.xamarin.com/show_bug.cgi?id=43354) - "Button IsEnabled binding is position dependent" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/308))
* [43450](https://bugzilla.xamarin.com/show_bug.cgi?id=43450) - "Faulty syntax of Grid.RowDefinition wasn't caught with XamlC"
* [43516](https://bugzilla.xamarin.com/show_bug.cgi?id=43516) - "[UWP] Changing FontAttribute on a label to NONE changes font size as well" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/325))
* [43530](https://bugzilla.xamarin.com/show_bug.cgi?id=43530) - "[Android] Resuming app throws IllegalStateException from fragment manager"
* [43726](https://bugzilla.xamarin.com/show_bug.cgi?id=43726) - "Setting TabbedPage.ItemsSource to Null Causes Crash" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/320))
* [43774](https://bugzilla.xamarin.com/show_bug.cgi?id=43774) - "Appearing does not trigger for the first time for Tabpages in Android" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/328))
* [43892](https://bugzilla.xamarin.com/show_bug.cgi?id=43892) - "Xamarin.Forms.TabbedPage with FormsAppCompatActivity OnAppearing Troubles"
* [44056](https://bugzilla.xamarin.com/show_bug.cgi?id=44056) - "Picker Focused/Unfocused events not fired on iOS 10 preview" ([PR](https://github.com/xamarin/Xamarin.Forms/pull/339))

## Other fixes
* iOS10 fixes

# 2.3.3-pre1

(Only internal. No public artifacts)

Version History

Version Downloads Last updated
4.0.0.8055-pre1 2,955 12/4/2018
3.4.0.1008975 76,979 11/15/2018
3.4.0.987044-pre2 1,785 11/8/2018
3.4.0.925479-pre1 5,927 10/18/2018
3.3.0.967583 74,328 11/1/2018
3.3.0.912540 66,268 10/18/2018
3.3.0.893527-pre3 3,540 10/11/2018
3.3.0.871608-pre2 6,067 10/1/2018
3.3.0.840541-pre1 2,955 9/20/2018
3.2.0.871581 60,535 10/3/2018
3.2.0.839982 72,562 9/17/2018
3.2.0.809874-pre3 2,739 9/10/2018
3.2.0.729530-pre2 7,538 8/14/2018
3.2.0.637442-pre1 6,740 7/17/2018
3.1.0.697729 247,574 8/1/2018
3.1.0.637273 74,841 7/11/2018
3.1.0.583944 110,990 6/20/2018
3.1.0.561732-pre4 5,149 6/11/2018
3.1.0.550168-pre3 2,370 6/6/2018
3.1.0.530888-pre2 1,333 6/4/2018
3.1.0.469394-pre1 10,155 5/9/2018
3.0.0.561731 123,009 6/11/2018
3.0.0.550146 22,913 6/6/2018
3.0.0.530893 17,011 6/4/2018
3.0.0.482510 178,827 5/14/2018
3.0.0.446417 99,026 5/1/2018
3.0.0.427558-pre4 7,741 4/25/2018
3.0.0.354232-pre3 12,275 4/5/2018
3.0.0.296286-pre2 7,482 3/20/2018
2.5.1.527436 58,565 5/4/2018
2.5.1.444934 131,273 4/4/2018
2.5.1.392594-pre3 3,708 3/21/2018
2.5.1.340284-pre2 5,372 3/9/2018
2.5.1.317207-pre1 5,159 3/1/2018
2.5.0.280555 276,187 2/16/2018
2.5.0.122203 279,129 12/18/2017
2.5.0.121934 177,254 11/28/2017
2.5.0.91635 118,818 11/16/2017
2.5.0.77107 25,940 11/13/2017
2.5.0.75255-pre3 4,915 11/10/2017
2.5.0.19271-pre2 8,377 10/20/2017
2.4.0.91020 39,292 11/16/2017
2.4.0.74863 32,426 11/10/2017
2.4.0.38779 56,230 10/30/2017
2.4.0.18342 51,607 10/20/2017
2.4.0.282 149,519 9/29/2017
2.4.0.280 163,457 9/27/2017
2.4.0.275-pre3 7,558 9/19/2017
2.4.0.269-pre2 12,878 8/29/2017
2.4.0.266-pre1 17,643 8/16/2017
2.3.5.256-pre6 32,485 6/29/2017
2.3.5.255-pre5 4,419 6/26/2017
2.3.5.239-pre3 26,718 5/11/2017
2.3.5.235-pre2 10,700 4/26/2017
2.3.5.233-pre1 8,526 4/13/2017
2.3.4.270 123,232 8/29/2017
2.3.4.267 60,935 8/16/2017
2.3.4.247 370,339 5/16/2017
2.3.4.231 196,678 4/12/2017
2.3.4.224 235,933 3/29/2017
2.3.4.221-pre6 6,878 3/27/2017
2.3.4.214-pre5 9,728 3/14/2017
2.3.4.212-pre4 5,771 3/10/2017
2.3.4.211-pre3 3,607 3/9/2017
2.3.4.192-pre2 18,589 2/3/2017
2.3.4.184-pre1 11,824 1/13/2017
2.3.3.193 226,699 2/1/2017
2.3.3.180 201,394 1/5/2017
2.3.3.175 114,965 12/6/2016
2.3.3.168 63,899 11/23/2016
2.3.3.166-pre4 7,238 11/3/2016
2.3.3.163-pre3 6,064 10/17/2016
2.3.3.152-pre2 15,029 9/15/2016
2.3.2.127 257,084 9/14/2016
2.3.2.118-pre1 6,512 8/3/2016
2.3.1.114 151,916 8/3/2016
2.3.1.113-pre3 3,526 7/19/2016
2.3.1.111-pre2 4,490 7/4/2016
2.3.1.110-pre1 2,164 6/29/2016
2.3.0.107 193,526 6/29/2016
2.3.0.49 81,708 6/16/2016
2.3.0.46-pre3 15,265 5/30/2016
2.3.0.38-pre2 12,526 4/27/2016
2.3.0.34-pre1 8,252 4/27/2016
2.2.0.45 114,698 5/30/2016
2.2.0.31 124,669 4/27/2016
2.2.0.23-pre4 2,822 4/20/2016
2.2.0.18-pre3 2,017 4/20/2016
2.2.0.5-pre2 15,670 4/8/2016
2.2.0.4-pre1 18,203 4/5/2016
2.1.0.6529 95,125 3/13/2016
2.1.0.6526 16,796 3/9/2016
2.1.0.6524 29,776 3/2/2016
2.1.0.6521 11,351 3/1/2016
2.1.0.6517-pre5 1,711 2/18/2016
2.1.0.6513-pre4 1,698 2/9/2016
2.1.0.6508-pre3 2,000 1/28/2016
2.1.0.6503-pre2 6,592 1/22/2016
2.1.0.6501-pre1 1,130 1/21/2016
2.1.0.6500-pre1 982 1/20/2016
2.0.1.6505 90,808 1/28/2016
2.0.1.6495 73,592 1/20/2016
2.0.1.6492-pre1 3,414 12/3/2015
2.0.0.6490 94,283 12/1/2015
2.0.0.6484 17,271 11/21/2015
2.0.0.6482 230,804 11/17/2015
1.5.2.6478-pre3 837 11/17/2015
1.5.2.6477-pre2 3,412 11/10/2015
1.5.2.6469-pre1 1,760 10/20/2015
1.5.1.6471 74,193 10/20/2015
1.5.1.6468 3,440 10/20/2015
1.5.1.6460-pre2 1,216 10/13/2015
1.5.1.6455-pre1 2,528 10/2/2015
1.5.0.6447 50,483 9/25/2015
1.5.0.6446 20,788 9/16/2015
1.5.0.6404-pre3 2,891 8/25/2015
1.5.0.6401-pre2 1,035 8/21/2015
1.5.0.6396-pre1 1,559 8/5/2015
1.4.4.6449 2,272 9/25/2015
1.4.4.6443 1,244 9/16/2015
1.4.4.6392 74,418 7/29/2015
1.4.4.6391 1,618 7/28/2015
1.4.4.6387 2,517 7/27/2015
1.4.4.6379-pre3 1,115 7/20/2015
1.4.4.6378-pre2 949 7/16/2015
1.4.4.6377-pre1 932 7/14/2015
1.4.3.6376 39,778 7/9/2015
1.4.3.6374 15,992 7/1/2015
1.4.3.6372 1,667 6/30/2015
1.4.3.6364-pre3 1,895 6/16/2015
1.4.3.6358-pre2 5,323 4/24/2015
1.4.3.6356-pre1 996 4/21/2015
1.4.2.6359 58,816 4/30/2015
1.4.2.6355 13,647 4/21/2015
1.4.2.6353-pre2 2,087 3/31/2015
1.4.2.6350-pre1 1,178 3/30/2015
1.4.1.6349 43,491 3/30/2015
1.4.1.6347-pre2 2,854 3/19/2015
1.4.1.6342-pre1 1,272 3/10/2015
1.4.0.6341 27,965 3/9/2015
1.4.0.6340-pre2 2,062 3/6/2015
1.4.0.6336-pre1 1,150 3/3/2015
1.3.5.6337 4,703 3/5/2015
1.3.5.6335 22,705 3/2/2015
1.3.5.6333-pre1 1,541 2/17/2015
1.3.4.6332 17,651 2/17/2015
1.3.4.6331-pre4 1,085 2/13/2015
1.3.4.6329-pre3 877 2/12/2015
1.3.4.6328-pre2 898 2/11/2015
1.3.4.6325-pre1 877 2/9/2015
1.3.3.6323 50,922 2/9/2015
1.3.3.6322-pre3 831 2/6/2015
1.3.3.6321-pre2 1,006 2/4/2015
1.3.3.6318-pre1 966 2/2/2015
1.3.2.6316 7,181 2/3/2015
1.3.2.6313-pre3 938 1/30/2015
1.3.2.6309-pre2 992 1/28/2015
1.3.2.6299-pre1 1,707 1/20/2015
1.3.1.6296 53,134 1/4/2015
1.3.1.6294-pre1 3,986 12/24/2014
1.3.0.6292 9,033 12/24/2014
1.3.0.6286-pre4 1,762 12/19/2014
1.3.0.6284-pre3 1,271 12/12/2014
1.3.0.6280-pre2 1,183 12/9/2014
1.3.0.6275-pre1 7,450 11/12/2014
1.2.3.6257 37,567 10/2/2014
1.2.3.6256-pre4 1,887 9/26/2014
1.2.3.6255-pre3 2,273 9/20/2014
1.2.3.6249-pre2 1,466 9/9/2014
1.2.3.6246-pre1 3,980 8/15/2014
1.2.2.6243 27,715 7/30/2014
1.2.2.6241-pre3 2,402 7/28/2014
1.2.2.6240-pre2 4,232 7/22/2014
1.2.2.6238-pre1 3,338 7/17/2014
1.2.1.6229 7,964 7/14/2014
1.1.1.6206 13,809 6/19/2014
1.1.0.6201 12,802 6/12/2014
1.0.6197 3,789 6/4/2014
1.0.6188 11,179 5/28/2014
Show less