iOS Call Directory Extension无来电标签问题咨询

我之前折腾Call Directory Extension的时候也遇到过一模一样的情况——权限开了，代码看起来没问题，但就是不显示标签。给你列几个必查的关键点，按顺序试应该能解决：

1. 确保号码是严格的E.164格式 #

CXCallDirectoryPhoneNumber要求是不带任何符号的纯数字E.164号码，必须包含国家码，不能有空格、括号、加号。比如：

• 国内手机号要写成 8613xxxxxxxxx（不能只写13xxxxxxxxx）
• 你代码里的48791111222是波兰号码（国家码48），格式是对的，但如果你测试用的是自己的号码，一定要确认加了正确的国家码，比如中国用户的号码得是86开头的完整数字。

2. 给扩展加上错误日志，排查隐性问题 #

你的requestFailed函数是空的，这会错过所有关键错误！比如号码格式非法、数据量超限、权限异常这些问题都会在这里抛出错误，赶紧补上日志：

import os.log

extension CallDirectoryHandler: CXCallDirectoryExtensionContextDelegate {
    func requestFailed(for extensionContext: CXCallDirectoryExtensionContext, withError error: Error) {
        os_log("Call Directory Extension Error: %@", log: .default, type: .error, error.localizedDescription)
        // 调试时也可以用NSLog，在Xcode控制台直接查看
        NSLog("Call Directory Failed: %@", error.localizedDescription)
    }
}

运行后看控制台，就能明确知道到底是哪里出问题了——我当时就是因为号码少了国家码，在这里看到了直接的错误提示。

3. 强制刷新扩展数据 #

有时候权限开了，但扩展的本地缓存没更新，试试这几步：

• 打开「设置>电话>阻止并识别来电」，先关掉你的扩展，等10秒再重新打开
• 或者重启你的iPhone，很多时候重启能解决缓存类的问题
• 调试时可以在主App里加个按钮，手动触发刷新：

import CallKit

// 主App内的代码示例
func reloadCallDirectoryExtension() {
    let extensionIdentifier = "你的扩展Bundle ID" // 比如com.yourapp.CallDirectoryExtension
    CXCallDirectoryManager.shared.reloadExtension(withIdentifier: extensionIdentifier) { error in
        if let error = error {
            print("Reload failed: \(error)")
        } else {
            print("Reload success!")
        }
    }
}

4. 必须用真实设备测试，且用外部号码拨打 #

模拟器完全不支持Call Directory功能，一定要用真实iPhone测试。而且不能用本机号码打给自己（比如FaceTime或者同一运营商的号码），必须用另一个设备的号码打进来——iOS对本机号码的识别逻辑不一样，不会触发Call Directory的标签显示。

5. 检查扩展的配置是否正确 #

打开扩展的Info.plist，确认以下配置：

• NSExtension -> NSExtensionPointIdentifier 必须是 com.apple.callkit.calldirectory
• NSExtension -> NSExtensionAttributes -> CXCallDirectoryEnabled 设为 YES
  另外，确保你的扩展和主App用的是同一个开发者账号签名，设备已经信任了你的开发者证书（设置>通用>VPN与设备管理里完成信任）。

6. 重置扩展数据 #

如果之前运行过旧版本的扩展，可能残留了旧数据，试试：

• 删掉主App（扩展会跟着主App一起被删除）
• 重新安装App，再去设置里打开扩展权限
• 确保第一次运行时，扩展的beginRequest走的是非增量逻辑（context.isIncremental为false），这样会重新添加所有号码

按这些步骤试下来，应该就能看到来电标签了。我当时就是卡在前两个点——号码格式不对，又没加错误日志，折腾了半天。

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