Xamarin.Forms 1.3.0.6280-pre2

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

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

paket add Xamarin.Forms --version 1.3.0.6280-pre2

#r "nuget: Xamarin.Forms, 1.3.0.6280-pre2"

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

Dependencies

• MonoAndroid 1.0

  • Xamarin.Android.Support.v4 (>= 19.1.0)

• WindowsPhone 8.0

  • WPtoolkit (>= 4.2013.8.16)

Used By

NuGet packages (1.7K)

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)	3.5M
Rg.Plugins.Popup Plugin for Xamarin forms. Allows you to open any page as a popup.	3.1M
Xamarin.Forms.Maps Maps models and renderers for Xamarin.Forms	2.6M
SkiaSharp.Views.Forms SkiaSharp for Xamarin.Forms is a set of views that can be used to draw on the screen.	2.2M
Syncfusion.Xamarin.Core This package contains common classes and interfaces that are used in other Syncfusion Xamarin UI controls. It also includes the following controls: 1. Text input control (aka floating label entry) - Decorates the input controls such as SfNumericTextBox, SfMaskedEdit, SfComboBox, SfAutoComplete, and Xamarin.Forms framework's Entry and Editor controls with password toggle icon to show and hide password, leading and trailing icons, and assistive labels such as floating label, hint, error, and help text. This control is supported in iOS, Android, UWP and WPF (Editor and Entry alone) platforms. 2. Border - Provides the rounded corner support with same and different corner radii on each side for any type of views. This control is supported in iOS, Android, UWP, and WPF platforms. 3. Gradient view - Provides gradient effect for any type of views. This control is supported in iOS, Android, UWP, and WPF platforms. 4. Avatar view - Provides a graphical representation for user image that allows you to customize the view by adding image, background color, text, etc. This control is supported in iOS, Android, UWP, and WPF platforms. 5. Effects view - Provides modern effects like ripple, selection, scaling, and rotation. Users can render these effects through touch interactions like touch down, touch up, long press, and also by calling the API. This control is supported in iOS, Android and UWP platforms. 6. Shimmer - Improves the responsiveness of an application by showing a modern shimmer effect when the data is being loaded in the background. This control comes with six built-in shimmer types along with custom view support. This control is supported in iOS, Android and UWP platforms. Note: This package needs to be installed in all Xamarin.Forms projects (.NET Standard, Android, iOS, UWP, macOS, and WPF). In addition, you need to install the “Syncfusion.Xamarin.Core.WPF” package for Xamarin.Forms WPF platform only. Support: Incident: https://www.syncfusion.com/support/directtrac/incidents/newincident?utm_source=nuget&utm_medium=listing Forum: https://www.syncfusion.com/forums/xamarin.forms?utm_source=nuget&utm_medium=listing This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's EULA (https://www.syncfusion.com/eula/es/?utm_source=nuget&utm_medium=listing). To acquire a license, you can purchase one at https://www.syncfusion.com/sales/products?utm_source=nuget&utm_medium=listing or start a free 30-day trial here (https://www.syncfusion.com/account/manage-trials/start-trials?utm_source=nuget&utm_medium=listing). © Copyright 2021 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.	2.0M

GitHub repositories (294)

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

Repository	Stars
dotnet/maui .NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.	6.4K
microsoft/ailab Experience, Learn and Code the latest breakthrough innovations with Microsoft AI	6.3K
dotnet/BenchmarkDotNet Powerful .NET library for benchmarking	6.3K
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.	6.2K
xamarin/Xamarin.Forms Xamarin.Forms Official Home	5.2K

Version History