Xamarin.Forms 1.3.0.6292

Build native UIs for iOS, Android, and Windows Phone from a single, shared C# codebase

There is a newer version of this package available.
See the version list below for details.
Install-Package Xamarin.Forms -Version 1.3.0.6292
dotnet add package Xamarin.Forms --version 1.3.0.6292
<PackageReference Include="Xamarin.Forms" Version="1.3.0.6292" />
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.6292
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Important notes:
- Generators for XAML pages should to be updated to use the new tool MSBuild:UpdateDesignTimeXaml instead of MSBuild:Compile
- Grid default is now *

## New API and Enhancements

- Add MasterDetailPage.ShouldShowToolbarButton method to enable control over the appearance of the toolbar button.
- Device.GetNamedSize (NamedSize size, Type targetType); Same as Device.GetnamedSize (NamedSize size, Element element) but doesn't require an instance.
- MasterDetailPage.MasterBehavior : Used to control how the MasterDetailPage renderers the split view between the Master and Detail. Allowed values are:

```csharp
public enum MasterBehavior
{
Default,
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 Application class to replace previous methods of turning a Page into a platform specific object.
- 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
- Styles support Behaviors and Triggers
- DataTrigger and MultiTrigger added
- VisualElement.IsFocused is now a BindableProperty
- Use * as default grid size
- StaticResource searches in Application.Current.Resources too
- Add NavigationPage.HasBackButton
- Fix Fuchsia spelling, Obsolete the old spelling
- TypeConverter on FontSize
- SearchBar.CancelButtonColor (currently only supported on iOS)
- ListView context actions


## Bug Fixes

### Core
- Bindings are culture unaware
- SetValue now properly overrides settings from a Style when the Style is applied later.
- Grid now has more nuanced reflow logic for things like labels. This fixes some cases where grid would end up either too small or too large for its content.
- Fix crash in XAML with DataTemplates and event subscription.
- ListView/TableView respect WidthRequest/HeightRequest again (regression in 1.3.0-pre2)
- No longer crash when trying to download/access the same UriImageSource on hundreds of images (System.IOException).
- Fix issue where Grid sometimes measured out taller than it should, especially in ListView/StackLayout. Grid now prefers to expand in the direction of a "defined" constraint, which tends to match expected behavior when measuring. If both constraints are Infinite, previous behavior is retained.
- BindableObject.SetValue will now properly perform loss-less conversions on base types. e.g. Calling slider.SetValue (Slider.ValueProperty, 6.0f) will now work correctly.
- Fix issue where StackLayout in a Horizontal orientation would return an incorrect MinimumHeight in GetSizeRequest.
- 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.
- Don't throw NRE in ResourceDictionaries when reparenting
- Fix map issue with IsShowingUser and location
- fix binding against arrays (https://bugzilla.xamarin.com/show_bug.cgi?id=24263)
- Resolve issue where Labels didn't reflow correctly inside of grids
- RelativeLayout now gives sane error when relative to non-child view
- fix NRE on removing ListView items (https://bugzilla.xamarin.com/show_bug.cgi?id=23778)
- x:Reference now works inside other markup extensions.

### Android
- Pressing back and re-entering the app now cleans up the old Activity and associated renderers. This fixes both memory leak issues and some crashes.
- Label.FontSize = 18 no longer accidentally gives a font size of 14 on any devices.
- Fix another case where ScrollView content could flow outside of bounds (yay).
- Fix crash in WebView when being removed from the visual tree.
- Map no longer re-centers on Layout.
- 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
- Fix issue where ListView.SelectedItem = null sometimes did not work as expected.
- Fix issues where Switch did not show on some Samsung devices
- Fix issue where rotation ignored the anchor point
- Fix Button text allignment issue (https://bugzilla.xamarin.com/show_bug.cgi?id=21138, https://bugzilla.xamarin.com/show_bug.cgi?id=21368)


### iOS
- Renderers are now properly re-used in ListView. Performance enhancement.
- iOS 8 now uses UIAlertController for alerts.
- Fix a case where the keyboard could end up overlapping the input area.
- Mixing swipe to go back and press to go back no longer results in a blank page.
- ContextAction More/Cancel buttons now translate properly
- ImageCell no longer flashes old image on cell re-use.
- Slider now updates bindings correctly due to conversion fix.
- 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.
- Fix issue on Translating views of zero size
- Select picker first item (https://bugzilla.xamarin.com/show_bug.cgi?id=22352)
- TabbedPage now updates icons correctly
- Fix several memory leaks
- Modal dialog scrolls to far (https://bugzilla.xamarin.com/show_bug.cgi?id=23904)
- Fix NRE when disposing some renderers.

### WinPhone
- Fix crash when pressing back button with active ActionSheet.
- TableView no longer selects wrong item when in Landscape mode.
- OpenUriAction now uses LaunchUriAsync.
- ViewCell with a Picker no longer occasionally occludes other elements on screen.
- Back button now closes ActionSheets and Alerts before attempting Navigation.
- Picker no longer shows a bunch of blank entries.
- ListView selection now properly shows up.
- ListView allows selection of items multiple times in a row if the user calls SelectedItem = null. This behavior matches other platforms correctly now.
- Label now reports the correct minimum width to match other platforms.
- Fix crash in Picker

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.
xamarin/xamarin-forms-samples
Sample apps built using the Xamarin.Forms framework
MvvmCross/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Windows and Mac.
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.3.0.851321-pre3 5,722 10/2/2019
4.3.0.819712-pre2 6,469 9/19/2019
4.3.0.778476-pre1 6,383 9/11/2019
4.2.0.848062 46,569 10/2/2019
4.2.0.815419 47,346 9/19/2019
4.2.0.778463 41,568 9/11/2019
4.2.0.709249 88,252 8/21/2019
4.2.0.673161-pre3 6,831 8/7/2019
4.2.0.618605-pre2 8,191 7/24/2019
4.2.0.608146-pre1 3,522 7/16/2019
4.1.0.778454 7,251 9/11/2019
4.1.0.709244 19,378 8/21/2019
4.1.0.673156 77,565 8/7/2019
4.1.0.618606 79,741 7/24/2019
4.1.0.581479 92,210 7/9/2019
4.1.0.555618 153,993 6/28/2019
4.1.0.496342-pre2 7,145 6/13/2019
4.1.0.483098-pre1 4,764 6/5/2019
4.0.0.709238 1,867 8/21/2019
4.0.0.618610 2,247 7/24/2019
4.0.0.540366 31,505 6/27/2019
4.0.0.497661 63,783 6/13/2019
4.0.0.482894 50,296 6/3/2019
4.0.0.425677 181,625 5/14/2019
4.0.0.394984-pre10 9,395 5/3/2019
4.0.0.346134-pre9 15,843 4/18/2019
4.0.0.304370-pre8 11,024 4/3/2019
4.0.0.250467-pre7 7,632 3/20/2019
4.0.0.232914-pre6 8,554 3/14/2019
4.0.0.169046-pre5 6,031 2/21/2019
4.0.0.135214-pre4 4,740 2/6/2019
4.0.0.94569-pre3 4,353 1/24/2019
4.0.0.62955-pre2 13,587 1/10/2019
4.0.0.8055-pre1 13,861 12/4/2018
3.6.0.709228 8,081 8/21/2019
3.6.0.539721 23,684 6/27/2019
3.6.0.344457 175,219 4/18/2019
3.6.0.293080 96,656 4/3/2019
3.6.0.264807 166,405 3/19/2019
3.6.0.220655 109,524 3/6/2019
3.6.0.169048-pre2 551 2/21/2019
3.6.0.135200-pre1 4,984 2/6/2019
3.5.0.274416 16,860 3/26/2019
3.5.0.169047 93,125 2/20/2019
3.5.0.129452 139,381 2/6/2019
3.5.0.94564-pre3 1,129 1/24/2019
3.5.0.62956-pre2 1,058 1/10/2019
3.4.0.1039999 13,556 3/26/2019
3.4.0.1029999 91,488 1/24/2019
3.4.0.1009999 108,498 1/4/2019
3.4.0.1008975 467,274 11/15/2018
3.4.0.987044-pre2 2,378 11/8/2018
3.4.0.925479-pre1 11,193 10/18/2018
3.3.0.967583 170,647 11/1/2018
3.3.0.912540 125,525 10/18/2018
3.3.0.893527-pre3 8,047 10/11/2018
3.3.0.871608-pre2 12,312 10/1/2018
3.3.0.840541-pre1 6,323 9/20/2018
3.2.0.871581 117,563 10/3/2018
3.2.0.839982 166,636 9/17/2018
3.2.0.809874-pre3 3,867 9/10/2018
3.2.0.729530-pre2 13,215 8/14/2018
3.2.0.637442-pre1 11,008 7/17/2018
3.1.0.697729 361,435 8/1/2018
3.1.0.637273 109,600 7/11/2018
3.1.0.583944 151,505 6/20/2018
3.1.0.561732-pre4 6,445 6/11/2018
3.1.0.550168-pre3 3,121 6/6/2018
3.1.0.530888-pre2 1,944 6/4/2018
3.1.0.469394-pre1 11,523 5/9/2018
3.0.0.561731 147,593 6/11/2018
3.0.0.550146 28,293 6/6/2018
3.0.0.530893 21,832 6/4/2018
3.0.0.482510 255,227 5/14/2018
3.0.0.446417 137,851 5/1/2018
3.0.0.427558-pre4 9,387 4/25/2018
3.0.0.354232-pre3 14,323 4/5/2018
3.0.0.296286-pre2 8,441 3/20/2018
2.5.1.527436 94,468 5/4/2018
2.5.1.444934 173,570 4/4/2018
2.5.1.392594-pre3 4,310 3/21/2018
2.5.1.340284-pre2 6,573 3/9/2018
2.5.1.317207-pre1 5,811 3/1/2018
2.5.0.280555 329,492 2/16/2018
2.5.0.122203 341,381 12/18/2017
2.5.0.121934 222,875 11/28/2017
2.5.0.91635 166,819 11/16/2017
2.5.0.77107 30,987 11/13/2017
2.5.0.75255-pre3 5,578 11/10/2017
2.5.0.19271-pre2 9,587 10/20/2017
2.4.0.91020 50,209 11/16/2017
2.4.0.74863 35,298 11/10/2017
2.4.0.38779 62,248 10/30/2017
2.4.0.18342 56,334 10/20/2017
2.4.0.282 165,023 9/29/2017
2.4.0.280 207,123 9/27/2017
2.4.0.275-pre3 8,264 9/19/2017
2.4.0.269-pre2 13,883 8/29/2017
2.4.0.266-pre1 20,115 8/16/2017
2.3.5.256-pre6 36,314 6/29/2017
2.3.5.255-pre5 5,055 6/26/2017
2.3.5.239-pre3 28,337 5/11/2017
2.3.5.235-pre2 11,457 4/26/2017
2.3.5.233-pre1 9,325 4/13/2017
2.3.4.270 155,075 8/29/2017
2.3.4.267 68,980 8/16/2017
2.3.4.247 427,076 5/16/2017
2.3.4.231 214,452 4/12/2017
2.3.4.224 252,299 3/29/2017
2.3.4.221-pre6 7,590 3/27/2017
2.3.4.214-pre5 10,482 3/14/2017
2.3.4.212-pre4 6,412 3/10/2017
2.3.4.211-pre3 4,346 3/9/2017
2.3.4.192-pre2 19,627 2/3/2017
2.3.4.184-pre1 13,178 1/13/2017
2.3.3.193 249,508 2/1/2017
2.3.3.180 212,482 1/5/2017
2.3.3.175 118,870 12/6/2016
2.3.3.168 67,284 11/23/2016
2.3.3.166-pre4 8,232 11/3/2016
2.3.3.163-pre3 6,559 10/17/2016
2.3.3.152-pre2 16,287 9/15/2016
2.3.2.127 293,408 9/14/2016
2.3.2.118-pre1 6,968 8/3/2016
2.3.1.114 157,068 8/3/2016
2.3.1.113-pre3 3,973 7/19/2016
2.3.1.111-pre2 4,908 7/4/2016
2.3.1.110-pre1 2,626 6/29/2016
2.3.0.107 208,073 6/29/2016
2.3.0.49 89,242 6/16/2016
2.3.0.46-pre3 16,318 5/30/2016
2.3.0.38-pre2 13,382 4/27/2016
2.3.0.34-pre1 8,951 4/27/2016
2.2.0.45 139,449 5/30/2016
2.2.0.31 128,640 4/27/2016
2.2.0.23-pre4 3,249 4/20/2016
2.2.0.18-pre3 2,462 4/20/2016
2.2.0.5-pre2 16,158 4/8/2016
2.2.0.4-pre1 18,672 4/5/2016
2.1.0.6529 99,195 3/13/2016
2.1.0.6526 17,774 3/9/2016
2.1.0.6524 36,888 3/2/2016
2.1.0.6521 12,305 3/1/2016
2.1.0.6517-pre5 2,341 2/18/2016
2.1.0.6513-pre4 2,323 2/9/2016
2.1.0.6508-pre3 2,639 1/28/2016
2.1.0.6503-pre2 7,226 1/22/2016
2.1.0.6501-pre1 1,779 1/21/2016
2.1.0.6500-pre1 1,607 1/20/2016
2.0.1.6505 93,987 1/28/2016
2.0.1.6495 75,467 1/20/2016
2.0.1.6492-pre1 4,061 12/3/2015
2.0.0.6490 98,746 12/1/2015
2.0.0.6484 18,029 11/21/2015
2.0.0.6482 242,917 11/17/2015
1.5.2.6478-pre3 1,483 11/17/2015
1.5.2.6477-pre2 4,122 11/10/2015
1.5.2.6469-pre1 2,410 10/20/2015
1.5.1.6471 77,376 10/20/2015
1.5.1.6468 4,133 10/20/2015
1.5.1.6460-pre2 1,876 10/13/2015
1.5.1.6455-pre1 3,234 10/2/2015
1.5.0.6447 56,463 9/25/2015
1.5.0.6446 22,026 9/16/2015
1.5.0.6404-pre3 3,524 8/25/2015
1.5.0.6401-pre2 1,727 8/21/2015
1.5.0.6396-pre1 2,165 8/5/2015
1.4.4.6449 2,975 9/25/2015
1.4.4.6443 1,872 9/16/2015
1.4.4.6392 77,805 7/29/2015
1.4.4.6391 2,219 7/28/2015
1.4.4.6387 3,156 7/27/2015
1.4.4.6379-pre3 1,746 7/20/2015
1.4.4.6378-pre2 1,566 7/16/2015
1.4.4.6377-pre1 1,572 7/14/2015
1.4.3.6376 43,053 7/9/2015
1.4.3.6374 16,887 7/1/2015
1.4.3.6372 2,299 6/30/2015
1.4.3.6364-pre3 2,546 6/16/2015
1.4.3.6358-pre2 5,986 4/24/2015
1.4.3.6356-pre1 1,657 4/21/2015
1.4.2.6359 63,567 4/30/2015
1.4.2.6355 14,686 4/21/2015
1.4.2.6353-pre2 2,711 3/31/2015
1.4.2.6350-pre1 1,763 3/30/2015
1.4.1.6349 44,883 3/30/2015
1.4.1.6347-pre2 3,444 3/19/2015
1.4.1.6342-pre1 1,899 3/10/2015
1.4.0.6341 29,301 3/9/2015
1.4.0.6340-pre2 2,746 3/6/2015
1.4.0.6336-pre1 1,732 3/3/2015
1.3.5.6337 5,332 3/5/2015
1.3.5.6335 25,635 3/2/2015
1.3.5.6333-pre1 2,308 2/17/2015
1.3.4.6332 19,552 2/17/2015
1.3.4.6331-pre4 1,763 2/13/2015
1.3.4.6329-pre3 1,489 2/12/2015
1.3.4.6328-pre2 1,497 2/11/2015
1.3.4.6325-pre1 1,462 2/9/2015
1.3.3.6323 53,604 2/9/2015
1.3.3.6322-pre3 1,460 2/6/2015
1.3.3.6321-pre2 1,623 2/4/2015
1.3.3.6318-pre1 1,620 2/2/2015
1.3.2.6316 7,987 2/3/2015
1.3.2.6313-pre3 1,607 1/30/2015
1.3.2.6309-pre2 1,653 1/28/2015
1.3.2.6299-pre1 2,365 1/20/2015
1.3.1.6296 57,536 1/4/2015
1.3.1.6294-pre1 4,692 12/24/2014
1.3.0.6292 9,842 12/24/2014
1.3.0.6286-pre4 2,363 12/19/2014
1.3.0.6284-pre3 1,864 12/12/2014
1.3.0.6280-pre2 1,822 12/9/2014
1.3.0.6275-pre1 8,093 11/12/2014
1.2.3.6257 39,505 10/2/2014
1.2.3.6256-pre4 2,503 9/26/2014
1.2.3.6255-pre3 2,911 9/20/2014
1.2.3.6249-pre2 2,088 9/9/2014
1.2.3.6246-pre1 4,665 8/15/2014
1.2.2.6243 29,053 7/30/2014
1.2.2.6241-pre3 3,022 7/28/2014
1.2.2.6240-pre2 4,859 7/22/2014
1.2.2.6238-pre1 4,021 7/17/2014
1.2.1.6229 8,833 7/14/2014
1.1.1.6206 14,472 6/19/2014
1.1.0.6201 13,907 6/12/2014
1.0.6197 4,617 6/4/2014
1.0.6188 12,048 5/28/2014
Show less