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

Version History

Version Downloads Last updated
4.0.0.232914-pre6 1,318 3/14/2019
4.0.0.169046-pre5 4,397 2/21/2019
4.0.0.135214-pre4 3,427 2/6/2019
4.0.0.94569-pre3 3,534 1/24/2019
4.0.0.62955-pre2 10,218 1/10/2019
4.0.0.8055-pre1 10,532 12/4/2018
3.6.0.264807 0 3/19/2019
3.6.0.220655 30,183 3/6/2019
3.6.0.169048-pre2 332 2/21/2019
3.6.0.135200-pre1 2,952 2/6/2019
3.5.0.169047 37,160 2/20/2019
3.5.0.129452 50,889 2/6/2019
3.5.0.94564-pre3 639 1/24/2019
3.5.0.62956-pre2 686 1/10/2019
3.4.0.1029999 49,481 1/24/2019
3.4.0.1009999 63,078 1/4/2019
3.4.0.1008975 255,491 11/15/2018
3.4.0.987044-pre2 2,108 11/8/2018
3.4.0.925479-pre1 7,731 10/18/2018
3.3.0.967583 127,063 11/1/2018
3.3.0.912540 87,908 10/18/2018
3.3.0.893527-pre3 4,963 10/11/2018
3.3.0.871608-pre2 7,961 10/1/2018
3.3.0.840541-pre1 3,912 9/20/2018
3.2.0.871581 77,327 10/3/2018
3.2.0.839982 96,769 9/17/2018
3.2.0.809874-pre3 3,205 9/10/2018
3.2.0.729530-pre2 9,590 8/14/2018
3.2.0.637442-pre1 7,932 7/17/2018
3.1.0.697729 279,367 8/1/2018
3.1.0.637273 87,243 7/11/2018
3.1.0.583944 120,377 6/20/2018
3.1.0.561732-pre4 5,663 6/11/2018
3.1.0.550168-pre3 2,714 6/6/2018
3.1.0.530888-pre2 1,621 6/4/2018
3.1.0.469394-pre1 10,728 5/9/2018
3.0.0.561731 132,509 6/11/2018
3.0.0.550146 24,676 6/6/2018
3.0.0.530893 18,791 6/4/2018
3.0.0.482510 200,127 5/14/2018
3.0.0.446417 111,059 5/1/2018
3.0.0.427558-pre4 8,361 4/25/2018
3.0.0.354232-pre3 13,093 4/5/2018
3.0.0.296286-pre2 7,890 3/20/2018
2.5.1.527436 71,989 5/4/2018
2.5.1.444934 148,491 4/4/2018
2.5.1.392594-pre3 3,986 3/21/2018
2.5.1.340284-pre2 5,696 3/9/2018
2.5.1.317207-pre1 5,451 3/1/2018
2.5.0.280555 293,742 2/16/2018
2.5.0.122203 298,388 12/18/2017
2.5.0.121934 190,249 11/28/2017
2.5.0.91635 122,699 11/16/2017
2.5.0.77107 27,494 11/13/2017
2.5.0.75255-pre3 5,225 11/10/2017
2.5.0.19271-pre2 8,834 10/20/2017
2.4.0.91020 42,780 11/16/2017
2.4.0.74863 33,438 11/10/2017
2.4.0.38779 57,770 10/30/2017
2.4.0.18342 53,465 10/20/2017
2.4.0.282 154,448 9/29/2017
2.4.0.280 178,235 9/27/2017
2.4.0.275-pre3 7,865 9/19/2017
2.4.0.269-pre2 13,306 8/29/2017
2.4.0.266-pre1 18,527 8/16/2017
2.3.5.256-pre6 33,918 6/29/2017
2.3.5.255-pre5 4,693 6/26/2017
2.3.5.239-pre3 27,287 5/11/2017
2.3.5.235-pre2 11,024 4/26/2017
2.3.5.233-pre1 8,872 4/13/2017
2.3.4.270 130,041 8/29/2017
2.3.4.267 63,586 8/16/2017
2.3.4.247 381,793 5/16/2017
2.3.4.231 201,580 4/12/2017
2.3.4.224 241,578 3/29/2017
2.3.4.221-pre6 7,168 3/27/2017
2.3.4.214-pre5 10,065 3/14/2017
2.3.4.212-pre4 6,043 3/10/2017
2.3.4.211-pre3 3,889 3/9/2017
2.3.4.192-pre2 18,978 2/3/2017
2.3.4.184-pre1 12,387 1/13/2017
2.3.3.193 234,683 2/1/2017
2.3.3.180 204,706 1/5/2017
2.3.3.175 116,294 12/6/2016
2.3.3.168 65,123 11/23/2016
2.3.3.166-pre4 7,712 11/3/2016
2.3.3.163-pre3 6,271 10/17/2016
2.3.3.152-pre2 15,547 9/15/2016
2.3.2.127 260,316 9/14/2016
2.3.2.118-pre1 6,704 8/3/2016
2.3.1.114 153,735 8/3/2016
2.3.1.113-pre3 3,722 7/19/2016
2.3.1.111-pre2 4,675 7/4/2016
2.3.1.110-pre1 2,360 6/29/2016
2.3.0.107 195,052 6/29/2016
2.3.0.49 84,663 6/16/2016
2.3.0.46-pre3 15,712 5/30/2016
2.3.0.38-pre2 12,900 4/27/2016
2.3.0.34-pre1 8,564 4/27/2016
2.2.0.45 116,945 5/30/2016
2.2.0.31 126,040 4/27/2016
2.2.0.23-pre4 3,001 4/20/2016
2.2.0.18-pre3 2,214 4/20/2016
2.2.0.5-pre2 15,890 4/8/2016
2.2.0.4-pre1 18,426 4/5/2016
2.1.0.6529 96,715 3/13/2016
2.1.0.6526 17,207 3/9/2016
2.1.0.6524 33,565 3/2/2016
2.1.0.6521 11,783 3/1/2016
2.1.0.6517-pre5 2,004 2/18/2016
2.1.0.6513-pre4 1,984 2/9/2016
2.1.0.6508-pre3 2,304 1/28/2016
2.1.0.6503-pre2 6,890 1/22/2016
2.1.0.6501-pre1 1,448 1/21/2016
2.1.0.6500-pre1 1,272 1/20/2016
2.0.1.6505 91,865 1/28/2016
2.0.1.6495 74,323 1/20/2016
2.0.1.6492-pre1 3,737 12/3/2015
2.0.0.6490 95,543 12/1/2015
2.0.0.6484 17,605 11/21/2015
2.0.0.6482 234,504 11/17/2015
1.5.2.6478-pre3 1,160 11/17/2015
1.5.2.6477-pre2 3,749 11/10/2015
1.5.2.6469-pre1 2,067 10/20/2015
1.5.1.6471 75,349 10/20/2015
1.5.1.6468 3,774 10/20/2015
1.5.1.6460-pre2 1,541 10/13/2015
1.5.1.6455-pre1 2,888 10/2/2015
1.5.0.6447 52,448 9/25/2015
1.5.0.6446 21,269 9/16/2015
1.5.0.6404-pre3 3,188 8/25/2015
1.5.0.6401-pre2 1,395 8/21/2015
1.5.0.6396-pre1 1,849 8/5/2015
1.4.4.6449 2,581 9/25/2015
1.4.4.6443 1,538 9/16/2015
1.4.4.6392 75,625 7/29/2015
1.4.4.6391 1,905 7/28/2015
1.4.4.6387 2,844 7/27/2015
1.4.4.6379-pre3 1,429 7/20/2015
1.4.4.6378-pre2 1,257 7/16/2015
1.4.4.6377-pre1 1,250 7/14/2015
1.4.3.6376 40,868 7/9/2015
1.4.3.6374 16,379 7/1/2015
1.4.3.6372 1,963 6/30/2015
1.4.3.6364-pre3 2,224 6/16/2015
1.4.3.6358-pre2 5,642 4/24/2015
1.4.3.6356-pre1 1,357 4/21/2015
1.4.2.6359 60,426 4/30/2015
1.4.2.6355 14,069 4/21/2015
1.4.2.6353-pre2 2,394 3/31/2015
1.4.2.6350-pre1 1,458 3/30/2015
1.4.1.6349 44,058 3/30/2015
1.4.1.6347-pre2 3,139 3/19/2015
1.4.1.6342-pre1 1,598 3/10/2015
1.4.0.6341 28,514 3/9/2015
1.4.0.6340-pre2 2,414 3/6/2015
1.4.0.6336-pre1 1,426 3/3/2015
1.3.5.6337 4,991 3/5/2015
1.3.5.6335 23,817 3/2/2015
1.3.5.6333-pre1 1,989 2/17/2015
1.3.4.6332 18,489 2/17/2015
1.3.4.6331-pre4 1,444 2/13/2015
1.3.4.6329-pre3 1,185 2/12/2015
1.3.4.6328-pre2 1,189 2/11/2015
1.3.4.6325-pre1 1,152 2/9/2015
1.3.3.6323 51,917 2/9/2015
1.3.3.6322-pre3 1,147 2/6/2015
1.3.3.6321-pre2 1,307 2/4/2015
1.3.3.6318-pre1 1,312 2/2/2015
1.3.2.6316 7,570 2/3/2015
1.3.2.6313-pre3 1,293 1/30/2015
1.3.2.6309-pre2 1,337 1/28/2015
1.3.2.6299-pre1 2,049 1/20/2015
1.3.1.6296 54,490 1/4/2015
1.3.1.6294-pre1 4,327 12/24/2014
1.3.0.6292 9,448 12/24/2014
1.3.0.6286-pre4 2,050 12/19/2014
1.3.0.6284-pre3 1,551 12/12/2014
1.3.0.6280-pre2 1,505 12/9/2014
1.3.0.6275-pre1 7,779 11/12/2014
1.2.3.6257 38,391 10/2/2014
1.2.3.6256-pre4 2,194 9/26/2014
1.2.3.6255-pre3 2,591 9/20/2014
1.2.3.6249-pre2 1,764 9/9/2014
1.2.3.6246-pre1 4,298 8/15/2014
1.2.2.6243 28,296 7/30/2014
1.2.2.6241-pre3 2,697 7/28/2014
1.2.2.6240-pre2 4,537 7/22/2014
1.2.2.6238-pre1 3,662 7/17/2014
1.2.1.6229 8,363 7/14/2014
1.1.1.6206 14,117 6/19/2014
1.1.0.6201 13,257 6/12/2014
1.0.6197 4,100 6/4/2014
1.0.6188 11,548 5/28/2014
Show less