使用VS for Mac开发Xamarin Cocoa应用时通讯录权限请求被拒

问题场景 #

使用VS for Mac 17.4.2创建Xamarin Cocoa应用，尝试读取MacOS通讯录，已在info.plist中添加权限描述，但请求权限时直接被拒绝，系统偏好设置的「安全与隐私」中无该应用的权限请求记录。

已配置的info.plist内容 #

<key>NSContactsUsageDescription</key>
<string>This app requires contacts access to function properly.</string>

应用核心代码 #

using AppKit;
using Contacts;
using Foundation;
using System;

namespace Upd2
{
    public partial class ViewController : NSViewController
    {
        private CNContactStore store;
        private CNAuthorizationStatus auth;

        public ViewController(IntPtr handle) : base(handle)
        {
            store = new Contacts.CNContactStore();
            auth = CNContactStore.GetAuthorizationStatus(CNEntityType.Contacts);
            Console.WriteLine(string.Format("\nAuthorizationStatus : {0}", auth.ToString()));
        }

        public override void ViewDidLoad()
        {
            base.ViewDidLoad();

            if (auth == CNAuthorizationStatus.NotDetermined)
            {
                store.RequestAccess(CNEntityType.Contacts, Handle_Contacts_RequestAccess);
            }
        }

        private void Handle_Contacts_RequestAccess(bool granted, NSError error)
        {
            Console.WriteLine(string.Format("granted : {0}", granted.ToString()));
            if (!granted)
            {
                Console.WriteLine(string.Format("Error : {0}", error.ToString()));
            }
        }
    }
}

控制台输出 #

AuthorizationStatus : NotDetermined
granted : False
Error : Access Denied

解决步骤 #

• 检查权限配置位置：确保NSContactsUsageDescription位于Info.plist的根层级，不要嵌套在NSAppTransportSecurity等其他字典节点下，否则系统无法识别权限请求描述。
• 清理重建项目：VS for Mac的缓存可能导致配置不生效，执行以下操作：
  1. 关闭VS for Mac，删除项目目录下的bin、obj文件夹
  2. 重新打开项目，依次执行Clean Solution和Rebuild Solution
• 验证应用签名与权限：MacOS要求权限请求的应用必须正确签名，在VS for Mac中：
  1. 右键项目 → Options → Mac OS X → Signing & Capabilities
  2. 选择有效的开发证书，勾选Contacts权限（该操作会自动同步权限配置到info.plist，但手动添加的描述文本需保留）
• 调整权限请求时机：避免在ViewController构造函数或启动阶段发起权限请求，MacOS对启动时的权限请求有拦截机制，改为在用户交互事件（如按钮点击）中触发请求：
  修改示例代码如下：

  public override void ViewDidLoad()
  {
      base.ViewDidLoad();
      // 添加触发权限请求的按钮
      var requestBtn = new NSButton(NSMakeRect(100, 100, 200, 40))
      {
          Title = "请求通讯录权限"
      };
      requestBtn.Activated += RequestBtn_Activated;
      View.AddSubview(requestBtn);
  }
  
  private void RequestBtn_Activated(object sender, EventArgs e)
  {
      var store = new CNContactStore();
      var auth = CNContactStore.GetAuthorizationStatus(CNEntityType.Contacts);
      if (auth == CNAuthorizationStatus.NotDetermined)
      {
          store.RequestAccess(CNEntityType.Contacts, (granted, error) =>
          {
              Console.WriteLine($"granted : {granted}");
              if (!granted && error != null)
              {
                  Console.WriteLine($"Error : {error}");
              }
          });
      }
  }
  

• 重置系统隐私缓存：如果系统仍未记录权限请求，打开终端执行命令重置通讯录权限数据库：

  tccutil reset Contacts
  

  执行后重启应用，再次发起权限请求。

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