previous-api-comparison/mac-api-diff.md

mac-api-diff.md

title	description	author	ms.author	ms.date	ms.topic	ms.assetid	ms.prod
Xamarin.Mac SDK API diff	List of API changes for Xamarin.Mac.	spouliot	sepoulio	8/28/2023	article	f833f3cb-eea7-c1b8-a706-dfbb597746ea	xamarin

Xamarin.Mac SDK API diff

Xamarin.Mac.dll

Namespace CoreData

Type Changed: CoreData.NSAttributeType

Added value:

CompositeAttributeType = 2100,

Type Changed: CoreData.NSManagedObjectModel

Added property:

public virtual string VersionChecksum { get; }

Added method:

public static Foundation.NSDictionary<Foundation.NSString,Foundation.NSString> ChecksumsForVersionedModel (Foundation.NSUrl modelUrl, out Foundation.NSError error);

Type Changed: CoreData.NSPersistentStoreCoordinator

Added methods:

public virtual bool FinishDeferredLightweightMigration (out Foundation.NSError error);
public virtual bool FinishDeferredLightweightMigrationTask (out Foundation.NSError error);

Type Changed: CoreData.UserInfoKeys

Added properties:

public static Foundation.NSString DeferredLightweightMigrationOptionKey { get; }
public static Foundation.NSString StagedMigrationManagerOptionKey { get; }

New Type: CoreData.NSCompositeAttributeDescription

public class NSCompositeAttributeDescription : CoreData.NSAttributeDescription {
	// constructors
	public NSCompositeAttributeDescription ();
	public NSCompositeAttributeDescription (Foundation.NSCoder coder);
	protected NSCompositeAttributeDescription (Foundation.NSObjectFlag t);
	protected NSCompositeAttributeDescription (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual NSAttributeDescription[] Elements { get; set; }
}

New Type: CoreData.NSCustomMigrationStage

public class NSCustomMigrationStage : CoreData.NSMigrationStage {
	// constructors
	protected NSCustomMigrationStage (Foundation.NSObjectFlag t);
	protected NSCustomMigrationStage (IntPtr handle);
	public NSCustomMigrationStage (NSManagedObjectModelReference currentModel, NSManagedObjectModelReference nextModel);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual NSManagedObjectModelReference CurrentModel { get; }
	public virtual System.Func<NSStagedMigrationManager,CoreData.NSCustomMigrationStage,Foundation.NSError,System.Boolean> DidMigrateHandler { get; set; }
	public virtual NSManagedObjectModelReference NextModel { get; }
	public virtual System.Func<NSStagedMigrationManager,CoreData.NSCustomMigrationStage,Foundation.NSError,System.Boolean> WillMigrateHandler { get; set; }
}

New Type: CoreData.NSLightweightMigrationStage

public class NSLightweightMigrationStage : CoreData.NSMigrationStage {
	// constructors
	protected NSLightweightMigrationStage (Foundation.NSObjectFlag t);
	protected NSLightweightMigrationStage (IntPtr handle);
	public NSLightweightMigrationStage (string[] versionChecksums);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual string[] VersionChecksums { get; }
}

New Type: CoreData.NSManagedObjectModelReference

public class NSManagedObjectModelReference : Foundation.NSObject {
	// constructors
	protected NSManagedObjectModelReference (Foundation.NSObjectFlag t);
	protected NSManagedObjectModelReference (IntPtr handle);
	public NSManagedObjectModelReference (NSManagedObjectModel model, string versionChecksum);
	public NSManagedObjectModelReference (Foundation.NSUrl fileUrl, string versionChecksum);
	public NSManagedObjectModelReference (Foundation.NSDictionary versionHash, Foundation.NSBundle bundle, string versionChecksum);
	public NSManagedObjectModelReference (string modelName, Foundation.NSBundle bundle, string versionChecksum);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual NSManagedObjectModel ResolvedModel { get; }
	public virtual string VersionChecksum { get; }
}

New Type: CoreData.NSMigrationStage

public class NSMigrationStage : Foundation.NSObject {
	// constructors
	public NSMigrationStage ();
	protected NSMigrationStage (Foundation.NSObjectFlag t);
	protected NSMigrationStage (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual string Label { get; set; }
}

New Type: CoreData.NSStagedMigrationManager

public class NSStagedMigrationManager : Foundation.NSObject {
	// constructors
	public NSStagedMigrationManager (NSMigrationStage[] stages);
	protected NSStagedMigrationManager (Foundation.NSObjectFlag t);
	protected NSStagedMigrationManager (IntPtr handle);
	// properties
	public override IntPtr ClassHandle { get; }
	public virtual NSPersistentContainer Container { get; }
	public virtual NSMigrationStage[] Stages { get; }
}