Xamarin.Forms 1.3.0.6280-pre2

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.3.0.6280-pre2
dotnet add package Xamarin.Forms --version 1.3.0.6280-pre2
<PackageReference Include="Xamarin.Forms" Version="1.3.0.6280-pre2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Xamarin.Forms --version 1.3.0.6280-pre2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Important Notes
This release (1.3.0 final) will be the last release to support the current *Preview* Unified iOS API. The next release will support the *Stable* iOS Unified API, which is not ABI/API compatible. This package is not compatible with the new Stable iOS Unified API. Xamarin.Forms 1.3.1 will be simultaneously released when the Stable Unified API releases to the stable channel.

If you are using the Classic iOS API this change does not affect you.

## New API
- MasterDetailPage.MasterBehavior : Used to control how the MasterDetailPage renderers the split view between the Master and Detail. Allowed values are:

```csharp
public enum MasterBehavior
{
SplitOnLandscape,
Split,
Popover,
SplitOnPortrait
}
```

- VisualElement.Navigation now contains overloads for all Pushing and Popping methods that accept a boolean parameter to enable/disable animations.
- INavigation contains methods needed for more complex navigation scenarios:

```csharp
public interface INavigation
{
IReadOnlyList<Page> NavigationStack { get; }
IReadOnlyList<Page> ModalStack { get; }

void RemovePage (Page page);
void InsertPageBefore (Page page, Page before);

Task PushAsync (Page page);
Task<Page> PopAsync ();
Task PopToRootAsync ();
Task PushModalAsync (Page page);
Task<Page> PopModalAsync ();

Task PushAsync (Page page, bool animated);
Task<Page> PopAsync (bool animated);
Task PopToRootAsync (bool animated);
Task PushModalAsync (Page page, bool animated);
Task<Page> PopModalAsync (bool animated);
}
```
- New member on Page: `protected virtual bool OnBackButtonPressed ()`: Override in order to handle *physical* back button press events. Events bubble down from root page and back up. Unhandled back button events will cause the app to exit. NavigationPage and the Platform still handle the back button as expected, however it is now possible to intercept and modify these behaviors. Not overriding this method retains the existing back button behavior.
- DependencyService now has Register methods for users needing more advanced ways to register dependencies.
- WidthRequest, HeightRequest, MinimumWidthRequest, and MinimumHeightRequest are now BindableProperties
- IViewController, IVisualElementController, and IElementController now available and explicitly implemented on VisualElement. These interfaces will eventually replace all internal API's currently used to communicate between platform renderers and the frontend API.
- IElementController.SetValueFromRenderer allows for updating of BindableProperties from renderers without accidentally clearing bindings.
- XAML now supports text as the content node in Label: `<Label>Hello World</Label>`
- Pin now has a Clicked property for detecting when the user taps or clicks on a Map pin after the information window is visible.
- Layout constructor is now marked protected and not internal

## Bug Fixes

### Core
- Adding a bad Path to a UriImageSource no longer crashes
- Improved XAML error reporting
- Fix crash where calling Navigation.PushAsync from re-initialized View sometimes crashed
- Fix error where cloning a Binding did not clone the Source parameter
- IsPresented is now respected correctly when using MasterDetailPage. May throw exception now if IsPresented is set to a disallowed value with MasterBehavior.
- Several bugs relating to culture invariance in XAML parsing.
- ThicknessConverter no longer depends on device culture
- Label properly resizes after setting Label.FontSize/Font/FontAttributes [Bug](https://bugzilla.xamarin.com/show_bug.cgi?id=24722)
- XAML InitializeComponent calls in some apps this will result in a massive performance improvement when loading pages.
- Serialization now property supports DataMemberAttributes
- ListView and TableView now return consistent sizing across all platforms. This change should not affect most apps, however some apps suffering from inconsistent sizing with ListViews/TableViews should find the situation better.
- Small set of changes to Layout to enable performance optimization with unneeded measure invalidation.

### iOS
- Button.Image is now rendered with original image to match other platforms
- Editor now scrolls to the correct location when a keyboard is shown
- Fix NullReferenceException when assigning to SearchBar.BackgroundColor
- Fix issue where PushModalAsync could sometimes result in a unhandled exception from UIKit.
- MasterDetailPage now disposes of child renderers correctly, resolves a memory leak.
- Fix issue where cells could not be unselected using blank rows.
- WebViewRenderer now uses correct path for finding resources
- Resolve issue where calling CreateViewController multiple times would cause an exception
- Use proxy when downloading images if configured on device.
- Partial swipes on a NavigationPage no longer cause the NavigationPage to get out of sync with the UINavigationController
- ActionSheet now correctly shows on iOS 8
- ActionSheet no longer gets incorrectly positions when rotating while visible.
- Assigning to Application.MainPage now works reliably

### Android
- MasterDetailPage container width now matches android design guidelines on tablets. (No longer insanely wide).
- SwitchCell height is no longer squished
- No longer crashes on Android 5.0
- No longer renders with a black bar at the bottom of Android 5.0 devices
- Other compatibility fixes with Android 5.0
- WebViewRenderer now uses correct path for finding resources
- Fix issue where calling SetPage multiple times would throw an exception
- Fix crash when restarting the Activity introduced in last pre-release
- Assigning to Application.MainPage now works reliably

### WinPhone
- Assigning to Application.MainPage now works reliably
- Application.OnStart now is called correctly

## Still to come
Some things coming post-1.3:

- Android bitmap optimization (automatic downsampling to prevent OOM exceptions with large images)
- WinRT support (Windows & Windows Phone 8.1)
- Bug fixes as always
- CarouselView
- Much much more

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

Repository Stars
dotnet-architecture/eShopOnContainers
Easy to get started sample reference microservice and container based application. Cross-platform on Linux and Windows Docker Containers, powered by .NET Core 2.2, Docker engine and optionally Azure, Kubernetes or Service Fabric. 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
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.
PrismLibrary/Prism
Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Windows 10 UWP, and Xamarin Forms.
MvvmCross/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Windows and Mac.
xamarin/xamarin-forms-samples
Sample apps built using the Xamarin.Forms framework
mono/monodevelop
MonoDevelop is a cross platform .NET IDE
Caliburn-Micro/Caliburn.Micro
A small, yet powerful framework, designed for building applications across all XAML platforms. Its strong support for MV* patterns will enable you to build your solution quickly, without the need to sacrifice code quality or testability.
reactiveui/Akavache
An asynchronous, persistent key-value store created for writing desktop and mobile applications, based on SQLite3. Akavache is great for both storing important data as well as cached local data that expires.
xamarin/XamarinComponents
Plugins for Xamarin

Version History

Version Downloads Last updated
4.2.0.709249 8,851 8/21/2019
4.2.0.673161-pre3 3,948 8/7/2019
4.2.0.618605-pre2 5,407 7/24/2019
4.2.0.608146-pre1 3,008 7/16/2019
4.1.0.709244 581 8/21/2019
4.1.0.673156 37,920 8/7/2019
4.1.0.618606 50,524 7/24/2019
4.1.0.581479 64,228 7/9/2019
4.1.0.555618 81,417 6/28/2019
4.1.0.496342-pre2 6,417 6/13/2019
4.1.0.483098-pre1 4,336 6/5/2019
4.0.0.709238 125 8/21/2019
4.0.0.618610 1,311 7/24/2019
4.0.0.540366 24,453 6/27/2019
4.0.0.497661 53,874 6/13/2019
4.0.0.482894 43,813 6/3/2019
4.0.0.425677 153,828 5/14/2019
4.0.0.394984-pre10 9,158 5/3/2019
4.0.0.346134-pre9 13,433 4/18/2019
4.0.0.304370-pre8 10,001 4/3/2019
4.0.0.250467-pre7 6,842 3/20/2019
4.0.0.232914-pre6 7,101 3/14/2019
4.0.0.169046-pre5 5,853 2/21/2019
4.0.0.135214-pre4 4,490 2/6/2019
4.0.0.94569-pre3 4,202 1/24/2019
4.0.0.62955-pre2 13,052 1/10/2019
4.0.0.8055-pre1 13,523 12/4/2018
3.6.0.709228 207 8/21/2019
3.6.0.539721 13,655 6/27/2019
3.6.0.344457 134,836 4/18/2019
3.6.0.293080 85,308 4/3/2019
3.6.0.264807 146,732 3/19/2019
3.6.0.220655 97,004 3/6/2019
3.6.0.169048-pre2 517 2/21/2019
3.6.0.135200-pre1 4,601 2/6/2019
3.5.0.274416 12,815 3/26/2019
3.5.0.169047 82,899 2/20/2019
3.5.0.129452 113,303 2/6/2019
3.5.0.94564-pre3 1,105 1/24/2019
3.5.0.62956-pre2 1,010 1/10/2019
3.4.0.1039999 9,987 3/26/2019
3.4.0.1029999 86,344 1/24/2019
3.4.0.1009999 100,625 1/4/2019
3.4.0.1008975 424,742 11/15/2018
3.4.0.987044-pre2 2,322 11/8/2018
3.4.0.925479-pre1 10,531 10/18/2018
3.3.0.967583 162,650 11/1/2018
3.3.0.912540 115,509 10/18/2018
3.3.0.893527-pre3 7,451 10/11/2018
3.3.0.871608-pre2 11,484 10/1/2018
3.3.0.840541-pre1 5,701 9/20/2018
3.2.0.871581 109,074 10/3/2018
3.2.0.839982 150,697 9/17/2018
3.2.0.809874-pre3 3,720 9/10/2018
3.2.0.729530-pre2 12,443 8/14/2018
3.2.0.637442-pre1 10,146 7/17/2018
3.1.0.697729 340,348 8/1/2018
3.1.0.637273 103,527 7/11/2018
3.1.0.583944 141,279 6/20/2018
3.1.0.561732-pre4 6,233 6/11/2018
3.1.0.550168-pre3 3,062 6/6/2018
3.1.0.530888-pre2 1,885 6/4/2018
3.1.0.469394-pre1 11,331 5/9/2018
3.0.0.561731 144,212 6/11/2018
3.0.0.550146 27,566 6/6/2018
3.0.0.530893 21,161 6/4/2018
3.0.0.482510 241,136 5/14/2018
3.0.0.446417 130,841 5/1/2018
3.0.0.427558-pre4 9,046 4/25/2018
3.0.0.354232-pre3 14,048 4/5/2018
3.0.0.296286-pre2 8,329 3/20/2018
2.5.1.527436 90,485 5/4/2018
2.5.1.444934 167,945 4/4/2018
2.5.1.392594-pre3 4,251 3/21/2018
2.5.1.340284-pre2 6,409 3/9/2018
2.5.1.317207-pre1 5,740 3/1/2018
2.5.0.280555 321,064 2/16/2018
2.5.0.122203 330,392 12/18/2017
2.5.0.121934 214,509 11/28/2017
2.5.0.91635 156,770 11/16/2017
2.5.0.77107 29,975 11/13/2017
2.5.0.75255-pre3 5,508 11/10/2017
2.5.0.19271-pre2 9,449 10/20/2017
2.4.0.91020 48,984 11/16/2017
2.4.0.74863 34,928 11/10/2017
2.4.0.38779 61,329 10/30/2017
2.4.0.18342 55,758 10/20/2017
2.4.0.282 162,971 9/29/2017
2.4.0.280 200,296 9/27/2017
2.4.0.275-pre3 8,190 9/19/2017
2.4.0.269-pre2 13,750 8/29/2017
2.4.0.266-pre1 19,711 8/16/2017
2.3.5.256-pre6 35,838 6/29/2017
2.3.5.255-pre5 5,003 6/26/2017
2.3.5.239-pre3 28,146 5/11/2017
2.3.5.235-pre2 11,366 4/26/2017
2.3.5.233-pre1 9,246 4/13/2017
2.3.4.270 144,794 8/29/2017
2.3.4.267 67,672 8/16/2017
2.3.4.247 417,705 5/16/2017
2.3.4.231 209,838 4/12/2017
2.3.4.224 249,947 3/29/2017
2.3.4.221-pre6 7,514 3/27/2017
2.3.4.214-pre5 10,404 3/14/2017
2.3.4.212-pre4 6,358 3/10/2017
2.3.4.211-pre3 4,170 3/9/2017
2.3.4.192-pre2 19,491 2/3/2017
2.3.4.184-pre1 13,053 1/13/2017
2.3.3.193 246,006 2/1/2017
2.3.3.180 210,655 1/5/2017
2.3.3.175 118,277 12/6/2016
2.3.3.168 66,717 11/23/2016
2.3.3.166-pre4 8,089 11/3/2016
2.3.3.163-pre3 6,501 10/17/2016
2.3.3.152-pre2 16,130 9/15/2016
2.3.2.127 283,954 9/14/2016
2.3.2.118-pre1 6,920 8/3/2016
2.3.1.114 156,291 8/3/2016
2.3.1.113-pre3 3,929 7/19/2016
2.3.1.111-pre2 4,870 7/4/2016
2.3.1.110-pre1 2,577 6/29/2016
2.3.0.107 207,060 6/29/2016
2.3.0.49 87,911 6/16/2016
2.3.0.46-pre3 16,226 5/30/2016
2.3.0.38-pre2 13,292 4/27/2016
2.3.0.34-pre1 8,880 4/27/2016
2.2.0.45 136,295 5/30/2016
2.2.0.31 128,031 4/27/2016
2.2.0.23-pre4 3,204 4/20/2016
2.2.0.18-pre3 2,420 4/20/2016
2.2.0.5-pre2 16,119 4/8/2016
2.2.0.4-pre1 18,621 4/5/2016
2.1.0.6529 98,576 3/13/2016
2.1.0.6526 17,641 3/9/2016
2.1.0.6524 36,604 3/2/2016
2.1.0.6521 12,200 3/1/2016
2.1.0.6517-pre5 2,275 2/18/2016
2.1.0.6513-pre4 2,251 2/9/2016
2.1.0.6508-pre3 2,571 1/28/2016
2.1.0.6503-pre2 7,164 1/22/2016
2.1.0.6501-pre1 1,721 1/21/2016
2.1.0.6500-pre1 1,547 1/20/2016
2.0.1.6505 93,436 1/28/2016
2.0.1.6495 75,253 1/20/2016
2.0.1.6492-pre1 4,001 12/3/2015
2.0.0.6490 97,765 12/1/2015
2.0.0.6484 17,955 11/21/2015
2.0.0.6482 240,482 11/17/2015
1.5.2.6478-pre3 1,426 11/17/2015
1.5.2.6477-pre2 4,053 11/10/2015
1.5.2.6469-pre1 2,341 10/20/2015
1.5.1.6471 76,912 10/20/2015
1.5.1.6468 4,065 10/20/2015
1.5.1.6460-pre2 1,816 10/13/2015
1.5.1.6455-pre1 3,171 10/2/2015
1.5.0.6447 55,477 9/25/2015
1.5.0.6446 21,829 9/16/2015
1.5.0.6404-pre3 3,465 8/25/2015
1.5.0.6401-pre2 1,666 8/21/2015
1.5.0.6396-pre1 2,107 8/5/2015
1.4.4.6449 2,901 9/25/2015
1.4.4.6443 1,809 9/16/2015
1.4.4.6392 77,314 7/29/2015
1.4.4.6391 2,164 7/28/2015
1.4.4.6387 3,097 7/27/2015
1.4.4.6379-pre3 1,686 7/20/2015
1.4.4.6378-pre2 1,512 7/16/2015
1.4.4.6377-pre1 1,510 7/14/2015
1.4.3.6376 42,725 7/9/2015
1.4.3.6374 16,784 7/1/2015
1.4.3.6372 2,236 6/30/2015
1.4.3.6364-pre3 2,481 6/16/2015
1.4.3.6358-pre2 5,925 4/24/2015
1.4.3.6356-pre1 1,599 4/21/2015
1.4.2.6359 62,720 4/30/2015
1.4.2.6355 14,535 4/21/2015
1.4.2.6353-pre2 2,651 3/31/2015
1.4.2.6350-pre1 1,705 3/30/2015
1.4.1.6349 44,676 3/30/2015
1.4.1.6347-pre2 3,389 3/19/2015
1.4.1.6342-pre1 1,844 3/10/2015
1.4.0.6341 29,088 3/9/2015
1.4.0.6340-pre2 2,686 3/6/2015
1.4.0.6336-pre1 1,672 3/3/2015
1.3.5.6337 5,265 3/5/2015
1.3.5.6335 25,298 3/2/2015
1.3.5.6333-pre1 2,247 2/17/2015
1.3.4.6332 19,381 2/17/2015
1.3.4.6331-pre4 1,698 2/13/2015
1.3.4.6329-pre3 1,431 2/12/2015
1.3.4.6328-pre2 1,436 2/11/2015
1.3.4.6325-pre1 1,400 2/9/2015
1.3.3.6323 53,205 2/9/2015
1.3.3.6322-pre3 1,397 2/6/2015
1.3.3.6321-pre2 1,557 2/4/2015
1.3.3.6318-pre1 1,558 2/2/2015
1.3.2.6316 7,901 2/3/2015
1.3.2.6313-pre3 1,546 1/30/2015
1.3.2.6309-pre2 1,595 1/28/2015
1.3.2.6299-pre1 2,300 1/20/2015
1.3.1.6296 56,956 1/4/2015
1.3.1.6294-pre1 4,623 12/24/2014
1.3.0.6292 9,768 12/24/2014
1.3.0.6286-pre4 2,303 12/19/2014
1.3.0.6284-pre3 1,805 12/12/2014
1.3.0.6280-pre2 1,756 12/9/2014
1.3.0.6275-pre1 8,036 11/12/2014
1.2.3.6257 39,300 10/2/2014
1.2.3.6256-pre4 2,442 9/26/2014
1.2.3.6255-pre3 2,851 9/20/2014
1.2.3.6249-pre2 2,020 9/9/2014
1.2.3.6246-pre1 4,583 8/15/2014
1.2.2.6243 28,895 7/30/2014
1.2.2.6241-pre3 2,952 7/28/2014
1.2.2.6240-pre2 4,791 7/22/2014
1.2.2.6238-pre1 3,949 7/17/2014
1.2.1.6229 8,742 7/14/2014
1.1.1.6206 14,407 6/19/2014
1.1.0.6201 13,767 6/12/2014
1.0.6197 4,372 6/4/2014
1.0.6188 11,945 5/28/2014
Show less