stable-api-comparison/tvos-api-diff.md

tvos-api-diff.md

title	description	author	ms.author	ms.date	ms.topic	ms.assetid	ms.prod
Xamarin.TVOS SDK API diff: 16.0.0 vs 16.1.0	List of API changes between Xamarin.TVOS versions 16.0.0 and 16.1.0.	spouliot	sepoulio	10/12/2022	article	da7ebe13-4821-f1bc-e7c1-2482e368253a	xamarin

Xamarin.TVOS SDK API diff: 16.0.0 vs 16.1.0

Xamarin.TVOS.dll

Namespace CoreLocation

Type Changed: CoreLocation.CLError

Added value:

HistoricalLocationError = 19,

Namespace Foundation

Type Changed: Foundation.NSArray

Added interfaces:

System.Collections.Generic.IEnumerable<NSObject>
System.Collections.IEnumerable

Added methods:

public TKey[] ToArray<TKey> ();
public NSObject[] ToArray ();

Type Changed: Foundation.NSArray`1

Added method:

public TKey[] ToArray ();

Type Changed: Foundation.NSMutableUrlRequest

Added property:

public virtual bool RequiresDnsSecValidation { get; set; }

Type Changed: Foundation.NSUrlRequest

Added property:

public virtual bool RequiresDnsSecValidation { get; }

Namespace HomeKit

Type Changed: HomeKit.HMAccessory

Added property:

public virtual Foundation.NSNumber MatterNodeId { get; }

Type Changed: HomeKit.HMHome

Added properties:

public virtual string MatterControllerId { get; }
public virtual System.Func<Foundation.NSXpcConnection> MatterControllerXPCConnectBlock { get; }

Namespace MapKit

Type Changed: MapKit.MKDirectionsRequest

Added properties:

public virtual MKDirectionsRoutePreference HighwayPreference { get; set; }
public virtual MKDirectionsRoutePreference TollPreference { get; set; }

Type Changed: MapKit.MKMapCamera

Added method:

public static MKMapCamera CameraLookingAt (MKMapItem mapItem, CoreGraphics.CGSize viewSize, bool allowPitch);

Type Changed: MapKit.MKMapView

Added property:

public virtual MKMapConfiguration PreferredConfiguration { get; set; }

Type Changed: MapKit.MKOverlayRenderer

Added property:

public virtual CoreGraphics.CGBlendMode BlendMode { get; set; }

Type Changed: MapKit.MKRoute

Added properties:

public virtual bool HasHighways { get; }
public virtual bool HasTolls { get; }

Type Changed: MapKit.MKUserTrackingMode

Obsoleted fields:

 [Obsolete ("This is only available on iOS and MacCatalyst.")]
 FollowWithHeading = 2,

New Type: MapKit.MKDirectionsRoutePreference

[Serializable]
public enum MKDirectionsRoutePreference {
	Any = 0,
	Avoid = 1,
}

New Type: MapKit.MKHybridMapConfiguration

public class MKHybridMapConfiguration : MapKit.MKMapConfiguration {
	// constructors
	public MKHybridMapConfiguration ();
	public MKHybridMapConfiguration (Foundation.NSCoder coder);
	protected MKHybridMapConfiguration (Foundation.NSObjectFlag t);
	public MKHybridMapConfiguration (MKMapElevationStyle elevationStyle);
	protected MKHybridMapConfiguration (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual MKPointOfInterestFilter PointOfInterestFilter { get; set; }
	public virtual bool ShowsTraffic { get; set; }
}

New Type: MapKit.MKImageryMapConfiguration

public class MKImageryMapConfiguration : MapKit.MKMapConfiguration {
	// constructors
	public MKImageryMapConfiguration ();
	public MKImageryMapConfiguration (Foundation.NSCoder coder);
	protected MKImageryMapConfiguration (Foundation.NSObjectFlag t);
	public MKImageryMapConfiguration (MKMapElevationStyle elevationStyle);
	protected MKImageryMapConfiguration (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
}

New Type: MapKit.MKMapConfiguration

public class MKMapConfiguration : Foundation.NSObject, Foundation.INSCoding, Foundation.INSCopying, Foundation.INSSecureCoding, ObjCRuntime.INativeObject, System.IDisposable {
	// constructors
	public MKMapConfiguration (Foundation.NSCoder coder);
	protected MKMapConfiguration (Foundation.NSObjectFlag t);
	protected MKMapConfiguration (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual MKMapElevationStyle ElevationStyle { get; set; }
	// methods
	public virtual Foundation.NSObject Copy (Foundation.NSZone zone);
	public virtual void EncodeTo (Foundation.NSCoder encoder);
}

New Type: MapKit.MKMapElevationStyle

[Serializable]
public enum MKMapElevationStyle {
	Flat = 0,
	Realistic = 1,
}

New Type: MapKit.MKStandardMapConfiguration

public class MKStandardMapConfiguration : MapKit.MKMapConfiguration {
	// constructors
	public MKStandardMapConfiguration ();
	public MKStandardMapConfiguration (Foundation.NSCoder coder);
	protected MKStandardMapConfiguration (Foundation.NSObjectFlag t);
	public MKStandardMapConfiguration (MKMapElevationStyle elevationStyle);
	public MKStandardMapConfiguration (MKStandardMapEmphasisStyle emphasisStyle);
	protected MKStandardMapConfiguration (IntPtr handle);
	public MKStandardMapConfiguration (MKMapElevationStyle elevationStyle, MKStandardMapEmphasisStyle emphasisStyle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual MKStandardMapEmphasisStyle EmphasisStyle { get; set; }
	public virtual MKPointOfInterestFilter PointOfInterestFilter { get; set; }
	public virtual bool ShowsTraffic { get; set; }
}

New Type: MapKit.MKStandardMapEmphasisStyle

[Serializable]
public enum MKStandardMapEmphasisStyle {
	Default = 0,
	Muted = 1,
}

Namespace Network

Type Changed: Network.NWPath

Obsoleted methods:

 [Obsolete ("Use the overload that takes a 'Func<NWEndpoint, bool>' instead.")]
 public void EnumerateGateways (System.Action<NWEndpoint> callback);
 [Obsolete ("Use the overload that takes a 'Func<NWInterface, bool>' instead.")]
 public void EnumerateInterfaces (System.Action<NWInterface> callback);

Added methods:

public void EnumerateGateways (System.Func<NWEndpoint,System.Boolean> callback);
public void EnumerateInterfaces (System.Func<NWInterface,System.Boolean> callback);

Namespace ObjCRuntime

Type Changed: ObjCRuntime.Constants

Modified fields:

-public const string SdkVersion = "16.0";
+public const string SdkVersion = "16.1";
-public const string Version = "16.0.0";
+public const string Version = "16.1.0";

Added fields:

public static const string SharedWithYouCoreLibrary = "/System/Library/Frameworks/SharedWithYouCore.framework/SharedWithYouCore";
public static const string SharedWithYouLibrary = "/System/Library/Frameworks/SharedWithYou.framework/SharedWithYou";

New Namespace SharedWithYou

New Type: SharedWithYou.ISWHighlightCenterDelegate

public interface ISWHighlightCenterDelegate : ObjCRuntime.INativeObject, System.IDisposable {
	// methods
	public virtual void HighlightsDidChange (SWHighlightCenter highlightCenter);
}

New Type: SharedWithYou.SWAttributionView

public class SWAttributionView : UIKit.UIView {
	// constructors
	public SWAttributionView ();
	public SWAttributionView (CoreGraphics.CGRect frame);
	public SWAttributionView (Foundation.NSCoder coder);
	protected SWAttributionView (Foundation.NSObjectFlag t);
	protected SWAttributionView (IntPtr handle);
	// properties
	public static SWAttributionView.SWAttributionViewAppearance Appearance { get; }
	public virtual SWAttributionViewBackgroundStyle BackgroundStyle { get; set; }
	public override IntPtr ClassHandle { get; }
	public virtual SWAttributionViewDisplayContext DisplayContext { get; set; }
	public virtual bool EnablesMarquee { get; set; }
	public virtual SWHighlight Highlight { get; set; }
	public virtual UIKit.UIMenu HighlightMenu { get; }
	public virtual SWAttributionViewHorizontalAlignment HorizontalAlignment { get; set; }
	public virtual string MenuTitleForHideAction { get; set; }
	public virtual nfloat PreferredMaxLayoutWidth { get; set; }
	public virtual UIKit.UIMenu SupplementalMenu { get; set; }
	// methods
	public static SWAttributionView.SWAttributionViewAppearance AppearanceWhenContainedIn (System.Type[] containers);
	public static SWAttributionView.SWAttributionViewAppearance GetAppearance<T> ();
	public static SWAttributionView.SWAttributionViewAppearance GetAppearance<T> (UIKit.UITraitCollection traits);
	public static SWAttributionView.SWAttributionViewAppearance GetAppearance (UIKit.UITraitCollection traits);
	public static SWAttributionView.SWAttributionViewAppearance GetAppearance<T> (UIKit.UITraitCollection traits, System.Type[] containers);
	public static SWAttributionView.SWAttributionViewAppearance GetAppearance (UIKit.UITraitCollection traits, System.Type[] containers);

	// inner types
	public class SWAttributionViewAppearance : UIKit.UIView+UIViewAppearance {
		// constructors
		protected SWAttributionView.SWAttributionViewAppearance (IntPtr handle);
	}
}

New Type: SharedWithYou.SWAttributionViewBackgroundStyle

[Serializable]
public enum SWAttributionViewBackgroundStyle {
	Color = 1,
	Default = 0,
	Material = 2,
}

New Type: SharedWithYou.SWAttributionViewDisplayContext

[Serializable]
public enum SWAttributionViewDisplayContext {
	Detail = 1,
	Summary = 0,
}

New Type: SharedWithYou.SWAttributionViewHorizontalAlignment

[Serializable]
public enum SWAttributionViewHorizontalAlignment {
	Center = 2,
	Default = 0,
	Leading = 1,
	Trailing = 3,
}

New Type: SharedWithYou.SWHighlight

public class SWHighlight : Foundation.NSObject, Foundation.INSCoding, Foundation.INSCopying, Foundation.INSSecureCoding, ObjCRuntime.INativeObject, System.IDisposable {
	// constructors
	public SWHighlight (Foundation.NSCoder coder);
	protected SWHighlight (Foundation.NSObjectFlag t);
	protected SWHighlight (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual Foundation.NSObject Identifier { get; }
	public virtual Foundation.NSUrl Url { get; }
	// methods
	public virtual Foundation.NSObject Copy (Foundation.NSZone zone);
	public virtual void EncodeTo (Foundation.NSCoder encoder);
}

New Type: SharedWithYou.SWHighlightCenter

public class SWHighlightCenter : Foundation.NSObject {
	// constructors
	public SWHighlightCenter ();
	protected SWHighlightCenter (Foundation.NSObjectFlag t);
	protected SWHighlightCenter (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public ISWHighlightCenterDelegate Delegate { get; set; }
	public static string HighlightCollectionTitle { get; }
	public virtual SWHighlight[] Highlights { get; }
	public static bool SystemCollaborationSupportAvailable { get; }
	public virtual Foundation.NSObject WeakDelegate { get; set; }
	// methods
	protected override void Dispose (bool disposing);
	public virtual void GetHighlight (Foundation.NSUrl urL, System.Action<SWHighlight,Foundation.NSError> completionHandler);
	public virtual System.Threading.Tasks.Task<SWHighlight> GetHighlightAsync (Foundation.NSUrl urL);
}

New Type: SharedWithYou.SWHighlightCenterDelegate

public abstract class SWHighlightCenterDelegate : Foundation.NSObject, ObjCRuntime.INativeObject, ISWHighlightCenterDelegate, System.IDisposable {
	// constructors
	protected SWHighlightCenterDelegate ();
	protected SWHighlightCenterDelegate (Foundation.NSObjectFlag t);
	protected SWHighlightCenterDelegate (IntPtr handle);
	// methods
	public virtual void HighlightsDidChange (SWHighlightCenter highlightCenter);
}

New Type: SharedWithYou.SWHighlightCenterErrorCode

[Serializable]
public enum SWHighlightCenterErrorCode {
	AccessDenied = 3,
	InternalError = 1,
	InvalidURL = 2,
	NoError = 0,
}