如何扩展MAUI iOS 16.1 API绑定以访问CAMetalLayer的EDR属性？

我需要在.NET MAUI 7中访问iOS 16为Core Animation Metal Layer新增的Extended Dynamic Range APIs，具体是CAMetalLayer的wantsExtendedDynamicRangeContent和edrMetadata属性。但目前MAUI 7 iOS 16.1绑定SDK并未暴露这些API。已安装的相关库及版本信息如下：

请问如何实现一个Swift库来设置CAMetalLayer的这两个属性？

实现Swift库并绑定到.NET MAUI的步骤 #

• 创建Swift库项目 #

  • 打开Xcode，创建一个新的Framework项目（选择iOS平台）
  • 在项目中创建一个Swift类，比如EDRCAMetalLayerHelper.swift，用于封装对CAMetalLayer属性的操作：

    import CoreAnimation
    import Metal
    
    @objc public class EDRCAMetalLayerHelper: NSObject {
        @objc public static func setWantsExtendedDynamicRangeContent(_ layer: CAMetalLayer, enabled: Bool) {
            layer.wantsExtendedDynamicRangeContent = enabled
        }
        
        @objc public static func getWantsExtendedDynamicRangeContent(_ layer: CAMetalLayer) -> Bool {
            return layer.wantsExtendedDynamicRangeContent
        }
        
        @objc public static func setEdrMetadata(_ layer: CAMetalLayer, metadata: CAMetalLayerEDRMetadata?) {
            layer.edrMetadata = metadata
        }
        
        @objc public static func getEdrMetadata(_ layer: CAMetalLayer) -> CAMetalLayerEDRMetadata? {
            return layer.edrMetadata
        }
        
        // 如果需要创建EDRMetadata的便捷方法，也可以添加
        @objc public static func createEDRMetadata(with brightness: CGFloat) -> CAMetalLayerEDRMetadata {
            let metadata = CAMetalLayerEDRMetadata()
            metadata.maxBrightness = brightness
            return metadata
        }
    }
    

  • 编译项目，生成.framework文件（注意选择对应的iOS架构，比如arm64或x86_64用于模拟器）

• 生成绑定库的ApiDefinition文件 #

  • 在.NET MAUI项目中，创建一个iOS绑定库项目（或直接在MAUI iOS项目中添加绑定配置）
  • 把编译好的Swift framework放入绑定项目的Native References中
  • 生成或手动编写ApiDefinition.cs，添加对Swift类的绑定：

    using Foundation;
    using CoreAnimation;
    using Metal;
    using ObjCRuntime;
    
    namespace YourBindingNamespace
    {
        [BaseType(typeof(NSObject))]
        interface EDRCAMetalLayerHelper
        {
            [Static]
            [Export("setWantsExtendedDynamicRangeContent:enabled:")]
            void SetWantsExtendedDynamicRangeContent(CAMetalLayer layer, bool enabled);
            
            [Static]
            [Export("getWantsExtendedDynamicRangeContent:")]
            bool GetWantsExtendedDynamicRangeContent(CAMetalLayer layer);
            
            [Static]
            [Export("setEdrMetadata:metadata:")]
            void SetEdrMetadata(CAMetalLayer layer, CAMetalLayerEDRMetadata metadata);
            
            [Static]
            [Export("getEdrMetadata:")]
            CAMetalLayerEDRMetadata GetEdrMetadata(CAMetalLayer layer);
            
            [Static]
            [Export("createEDRMetadataWithBrightness:")]
            CAMetalLayerEDRMetadata CreateEDRMetadata(nfloat brightness);
        }
    }
    

  • 注意：CAMetalLayerEDRMetadata如果在绑定SDK中也未暴露，需要额外绑定这个类的属性，比如maxBrightness等：

    [BaseType(typeof(NSObject))]
    interface CAMetalLayerEDRMetadata
    {
        [Export("maxBrightness")]
        nfloat MaxBrightness { get; set; }
    }
    

• 在MAUI项目中使用绑定的Swift库 #

  • 引用绑定库项目到MAUI iOS项目
  • 在代码中获取CAMetalLayer实例（比如从MAUI的MetalView或自定义视图中获取），然后调用Swift helper类的方法：

    using YourBindingNamespace;
    using CoreAnimation;
    
    // 假设你已经获取到CAMetalLayer实例
    var metalLayer = ...; // 比如从MetalView的Layer属性转换
    
    // 设置wantsExtendedDynamicRangeContent
    EDRCAMetalLayerHelper.SetWantsExtendedDynamicRangeContent(metalLayer, true);
    
    // 创建并设置edrMetadata
    var metadata = EDRCAMetalLayerHelper.CreateEDRMetadata(1000.0f);
    EDRCAMetalLayerHelper.SetEdrMetadata(metalLayer, metadata);
    
    // 获取属性值
    bool isEnabled = EDRCAMetalLayerHelper.GetWantsExtendedDynamicRangeContent(metalLayer);
    var currentMetadata = EDRCAMetalLayerHelper.GetEdrMetadata(metalLayer);
    

• 注意事项 #

  • 确保Swift framework编译时包含正确的架构，避免运行时出现架构不匹配的错误
  • 绑定过程中如果遇到方法签名不匹配的问题，可以通过objdump工具查看Swift库的导出符号来修正Export属性的字符串
  • 仅在iOS 16及以上版本调用这些API，避免在低版本系统上崩溃，可以通过UIDevice.CurrentDevice.CheckSystemVersion(16, 0)进行版本判断

内容的提问来源于stack exchange，提问作者Perse95