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

NuGet packages (1.5K)

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
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.
SkiaSharp.Views.Forms
SkiaSharp for Xamarin.Forms is a set of views that can be used to draw on the screen.

GitHub repositories (263)

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
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.
dotnet/BenchmarkDotNet
Powerful .NET library for benchmarking
xamarin/Xamarin.Forms
Xamarin.Forms Official Home

Version History

Version Downloads Last updated
4.8.0.1238-pre3 709 7/30/2020
4.8.0.1187-pre2 1,182 7/23/2020
4.8.0.1143-pre1 1,380 7/15/2020
4.7.0.1239 7,006 7/30/2020
4.7.0.1179 23,209 7/22/2020
4.7.0.1142 29,211 7/15/2020
4.7.0.1080 57,283 7/1/2020
4.7.0.968 76,517 6/17/2020
4.7.0.937-pre4 5,139 6/11/2020
4.7.0.848-pre3 2,700 6/4/2020
4.7.0.813-pre2 5,391 5/19/2020
4.7.0.773-pre1 2,665 5/14/2020
4.6.0.1180 722 7/22/2020
4.6.0.1141 1,030 7/14/2020
4.6.0.1073 3,178 7/1/2020
4.6.0.967 19,243 6/17/2020
4.6.0.847 79,253 6/4/2020
4.6.0.800 123,524 5/19/2020
4.6.0.726 167,332 4/29/2020
4.6.0.616-pre4 10,458 4/9/2020
4.6.0.529-pre3 4,055 4/2/2020
4.6.0.494-pre2 4,759 3/25/2020
4.6.0.379-pre1 7,696 3/5/2020
4.5.0.725 23,585 4/29/2020
4.5.0.657 50,210 4/23/2020
4.5.0.617 128,437 4/9/2020
4.5.0.530 79,527 4/1/2020
4.5.0.495 79,211 3/25/2020
4.5.0.396 89,247 3/16/2020
4.5.0.356 217,223 2/26/2020
4.5.0.282-pre4 7,617 2/10/2020
4.5.0.266-pre3 2,965 2/5/2020
4.5.0.187-pre2 7,376 1/23/2020
4.5.0.142-pre1 4,007 1/13/2020
4.4.0.991864 20,507 3/23/2020
4.4.0.991757 30,642 2/26/2020
4.4.0.991640 130,983 2/5/2020
4.4.0.991537 106,095 1/23/2020
4.4.0.991477 90,946 1/10/2020
4.4.0.991265 248,774 12/12/2019
4.4.0.991220-pre3 4,036 12/4/2019
4.4.0.991210-pre2 9,244 11/14/2019
4.4.0.936621-pre1 8,010 10/31/2019
4.3.0.991250 44,091 12/12/2019
4.3.0.991221 74,868 12/4/2019
4.3.0.991211 176,473 11/14/2019
4.3.0.947036 155,490 10/29/2019
4.3.0.908675 190,171 10/21/2019
4.3.0.851321-pre3 13,185 10/2/2019
4.3.0.819712-pre2 12,503 9/19/2019
4.3.0.778476-pre1 15,801 9/11/2019
4.2.0.910310 47,458 10/21/2019
4.2.0.848062 185,672 10/2/2019
4.2.0.815419 101,830 9/19/2019
4.2.0.778463 77,552 9/11/2019
4.2.0.709249 224,116 8/21/2019
4.2.0.673161-pre3 11,605 8/7/2019
4.2.0.618605-pre2 13,165 7/24/2019
4.2.0.608146-pre1 7,192 7/16/2019
4.1.0.778454 29,144 9/11/2019
4.1.0.709244 39,511 8/21/2019
4.1.0.673156 126,622 8/7/2019
4.1.0.618606 135,458 7/24/2019
4.1.0.581479 157,865 7/9/2019
4.1.0.555618 291,778 6/28/2019
4.1.0.496342-pre2 11,613 6/13/2019
4.1.0.483098-pre1 8,022 6/5/2019
4.0.0.709238 12,997 8/21/2019
4.0.0.618610 5,476 7/24/2019
4.0.0.540366 57,354 6/27/2019
4.0.0.497661 80,429 6/13/2019
4.0.0.482894 71,253 6/3/2019
4.0.0.425677 268,815 5/14/2019
4.0.0.394984-pre10 12,108 5/3/2019
4.0.0.346134-pre9 21,537 4/18/2019
4.0.0.304370-pre8 16,161 4/3/2019
4.0.0.250467-pre7 10,447 3/20/2019
4.0.0.232914-pre6 11,092 3/14/2019
4.0.0.169046-pre5 8,589 2/21/2019
4.0.0.135214-pre4 7,063 2/6/2019
4.0.0.94569-pre3 6,735 1/24/2019
4.0.0.62955-pre2 18,231 1/10/2019
4.0.0.8055-pre1 16,781 12/4/2018
3.6.0.709228 44,161 8/21/2019
3.6.0.539721 38,530 6/27/2019
3.6.0.344457 374,455 4/18/2019
3.6.0.293080 118,881 4/3/2019
3.6.0.264807 202,916 3/19/2019
3.6.0.220655 154,239 3/6/2019
3.6.0.169048-pre2 2,836 2/21/2019
3.6.0.135200-pre1 9,011 2/6/2019
3.5.0.274416 36,001 3/26/2019
3.5.0.169047 168,351 2/20/2019
3.5.0.129452 253,116 2/6/2019
3.5.0.94564-pre3 3,249 1/24/2019
3.5.0.62956-pre2 3,325 1/10/2019
3.4.0.1039999 23,230 3/26/2019
3.4.0.1029999 110,674 1/24/2019
3.4.0.1009999 136,649 1/4/2019
3.4.0.1008975 597,474 11/15/2018
3.4.0.987044-pre2 4,362 11/8/2018
3.4.0.925479-pre1 16,098 10/18/2018
3.3.0.967583 203,055 11/1/2018
3.3.0.912540 188,389 10/18/2018
3.3.0.893527-pre3 12,347 10/11/2018
3.3.0.871608-pre2 18,355 10/1/2018
3.3.0.840541-pre1 10,377 9/20/2018
3.2.0.871581 143,811 10/3/2018
3.2.0.839982 214,218 9/17/2018
3.2.0.809874-pre3 6,532 9/10/2018
3.2.0.729530-pre2 18,037 8/14/2018
3.2.0.637442-pre1 15,174 7/17/2018
3.1.0.697729 452,282 8/1/2018
3.1.0.637273 128,624 7/11/2018
3.1.0.583944 190,595 6/20/2018
3.1.0.561732-pre4 8,825 6/11/2018
3.1.0.550168-pre3 5,158 6/6/2018
3.1.0.530888-pre2 4,273 6/4/2018
3.1.0.469394-pre1 14,464 5/9/2018
3.0.0.561731 163,211 6/11/2018
3.0.0.550146 32,681 6/6/2018
3.0.0.530893 27,895 6/4/2018
3.0.0.482510 323,482 5/14/2018
3.0.0.446417 174,747 5/1/2018
3.0.0.427558-pre4 12,211 4/25/2018
3.0.0.354232-pre3 16,990 4/5/2018
3.0.0.296286-pre2 10,823 3/20/2018
2.5.1.527436 119,200 5/4/2018
2.5.1.444934 206,167 4/4/2018
2.5.1.392594-pre3 6,167 3/21/2018
2.5.1.340284-pre2 9,644 3/9/2018
2.5.1.317207-pre1 7,697 3/1/2018
2.5.0.280555 378,999 2/16/2018
2.5.0.122203 393,486 12/18/2017
2.5.0.121934 293,605 11/28/2017
2.5.0.91635 233,916 11/16/2017
2.5.0.77107 39,064 11/13/2017
2.5.0.75255-pre3 7,732 11/10/2017
2.5.0.19271-pre2 12,096 10/20/2017
2.4.0.91020 57,107 11/16/2017
2.4.0.74863 38,974 11/10/2017
2.4.0.38779 67,789 10/30/2017
2.4.0.18342 61,276 10/20/2017
2.4.0.282 179,637 9/29/2017
2.4.0.280 248,593 9/27/2017
2.4.0.275-pre3 10,459 9/19/2017
2.4.0.269-pre2 17,015 8/29/2017
2.4.0.266-pre1 25,038 8/16/2017
2.3.5.256-pre6 40,530 6/29/2017
2.3.5.255-pre5 7,300 6/26/2017
2.3.5.239-pre3 31,275 5/11/2017
2.3.5.235-pre2 13,490 4/26/2017
2.3.5.233-pre1 11,816 4/13/2017
2.3.4.270 212,136 8/29/2017
2.3.4.267 78,831 8/16/2017
2.3.4.247 476,429 5/16/2017
2.3.4.231 244,381 4/12/2017
2.3.4.224 267,641 3/29/2017
2.3.4.221-pre6 10,501 3/27/2017
2.3.4.214-pre5 13,026 3/14/2017
2.3.4.212-pre4 8,735 3/10/2017
2.3.4.211-pre3 6,766 3/9/2017
2.3.4.192-pre2 22,245 2/3/2017
2.3.4.184-pre1 15,802 1/13/2017
2.3.3.193 273,021 2/1/2017
2.3.3.180 228,854 1/5/2017
2.3.3.175 124,142 12/6/2016
2.3.3.168 73,171 11/23/2016
2.3.3.166-pre4 9,832 11/3/2016
2.3.3.163-pre3 8,292 10/17/2016
2.3.3.152-pre2 18,426 9/15/2016
2.3.2.127 382,538 9/14/2016
2.3.2.118-pre1 8,619 8/3/2016
2.3.1.114 166,179 8/3/2016
2.3.1.113-pre3 5,619 7/19/2016
2.3.1.111-pre2 6,470 7/4/2016
2.3.1.110-pre1 4,283 6/29/2016
2.3.0.107 216,284 6/29/2016
2.3.0.49 99,822 6/16/2016
2.3.0.46-pre3 17,980 5/30/2016
2.3.0.38-pre2 15,272 4/27/2016
2.3.0.34-pre1 10,757 4/27/2016
2.2.0.45 149,398 5/30/2016
2.2.0.31 135,314 4/27/2016
2.2.0.23-pre4 4,817 4/20/2016
2.2.0.18-pre3 4,139 4/20/2016
2.2.0.5-pre2 17,785 4/8/2016
2.2.0.4-pre1 20,302 4/5/2016
2.1.0.6529 107,126 3/13/2016
2.1.0.6526 19,788 3/9/2016
2.1.0.6524 39,365 3/2/2016
2.1.0.6521 14,413 3/1/2016
2.1.0.6517-pre5 3,922 2/18/2016
2.1.0.6513-pre4 3,973 2/9/2016
2.1.0.6508-pre3 4,252 1/28/2016
2.1.0.6503-pre2 8,772 1/22/2016
2.1.0.6501-pre1 3,384 1/21/2016
2.1.0.6500-pre1 3,190 1/20/2016
2.0.1.6505 101,868 1/28/2016
2.0.1.6495 77,936 1/20/2016
2.0.1.6492-pre1 5,705 12/3/2015
2.0.0.6490 109,534 12/1/2015
2.0.0.6484 20,384 11/21/2015
2.0.0.6482 257,388 11/17/2015
1.5.2.6478-pre3 3,029 11/17/2015
1.5.2.6477-pre2 5,823 11/10/2015
1.5.2.6469-pre1 4,015 10/20/2015
1.5.1.6471 82,927 10/20/2015
1.5.1.6468 5,925 10/20/2015
1.5.1.6460-pre2 3,461 10/13/2015
1.5.1.6455-pre1 4,860 10/2/2015
1.5.0.6447 71,772 9/25/2015
1.5.0.6446 24,576 9/16/2015
1.5.0.6404-pre3 5,110 8/25/2015
1.5.0.6401-pre2 3,325 8/21/2015
1.5.0.6396-pre1 3,735 8/5/2015
1.4.4.6449 4,583 9/25/2015
1.4.4.6443 3,519 9/16/2015
1.4.4.6392 86,108 7/29/2015
1.4.4.6391 3,842 7/28/2015
1.4.4.6387 4,881 7/27/2015
1.4.4.6379-pre3 3,309 7/20/2015
1.4.4.6378-pre2 3,134 7/16/2015
1.4.4.6377-pre1 3,134 7/14/2015
1.4.3.6376 47,580 7/9/2015
1.4.3.6374 19,384 7/1/2015
1.4.3.6372 3,943 6/30/2015
1.4.3.6364-pre3 4,196 6/16/2015
1.4.3.6358-pre2 7,820 4/24/2015
1.4.3.6356-pre1 3,228 4/21/2015
1.4.2.6359 70,284 4/30/2015
1.4.2.6355 17,000 4/21/2015
1.4.2.6353-pre2 4,281 3/31/2015
1.4.2.6350-pre1 3,292 3/30/2015
1.4.1.6349 47,595 3/30/2015
1.4.1.6347-pre2 5,019 3/19/2015
1.4.1.6342-pre1 3,427 3/10/2015
1.4.0.6341 31,803 3/9/2015
1.4.0.6340-pre2 4,337 3/6/2015
1.4.0.6336-pre1 3,328 3/3/2015
1.3.5.6337 6,964 3/5/2015
1.3.5.6335 28,363 3/2/2015
1.3.5.6333-pre1 3,947 2/17/2015
1.3.4.6332 22,198 2/17/2015
1.3.4.6331-pre4 3,332 2/13/2015
1.3.4.6329-pre3 3,041 2/12/2015
1.3.4.6328-pre2 3,020 2/11/2015
1.3.4.6325-pre1 3,015 2/9/2015
1.3.3.6323 57,662 2/9/2015
1.3.3.6322-pre3 2,990 2/6/2015
1.3.3.6321-pre2 3,175 2/4/2015
1.3.3.6318-pre1 3,215 2/2/2015
1.3.2.6316 10,681 2/3/2015
1.3.2.6313-pre3 3,165 1/30/2015
1.3.2.6309-pre2 3,230 1/28/2015
1.3.2.6299-pre1 4,005 1/20/2015
1.3.1.6296 62,199 1/4/2015
1.3.1.6294-pre1 6,308 12/24/2014
1.3.0.6292 12,713 12/24/2014
1.3.0.6286-pre4 3,955 12/19/2014
1.3.0.6284-pre3 3,470 12/12/2014
1.3.0.6280-pre2 3,418 12/9/2014
1.3.0.6275-pre1 9,706 11/12/2014
1.2.3.6257 42,731 10/2/2014
1.2.3.6256-pre4 4,117 9/26/2014
1.2.3.6255-pre3 4,536 9/20/2014
1.2.3.6249-pre2 3,668 9/9/2014
1.2.3.6246-pre1 6,295 8/15/2014
1.2.2.6243 31,634 7/30/2014
1.2.2.6241-pre3 4,621 7/28/2014
1.2.2.6240-pre2 6,450 7/22/2014
1.2.2.6238-pre1 5,653 7/17/2014
1.2.1.6229 10,616 7/14/2014
1.1.1.6206 16,123 6/19/2014
1.1.0.6201 15,935 6/12/2014
1.0.6197 18,320 6/4/2014
1.0.6188 14,021 5/28/2014
Show less