使用Call Directory Extension识别来电ID失败问题求助

Let’s walk through the most common issues that could be preventing your Call Directory Extension from displaying caller IDs, and fix them step by step:

1. Fix Phone Number Formatting (Critical!) #

CallKit requires all phone numbers to be in E.164 format—that means a leading + followed by the country code and full number (e.g., +14155551234 for a US number).

Your static test code uses EXAMPLE_NUMBER which is almost certainly not a valid E.164 number, and your real-world UserDefaults data might have unformatted numbers too. Also, your current code uses a force unwrap (CXCallDirectoryPhoneNumber(phoneNumber)!) which will skip invalid numbers or crash the extension entirely.

Update your identification code to validate numbers:

private func addAllIdentificationPhoneNumbers(to context: CXCallDirectoryExtensionContext) {
    guard let (phoneNumbersToIdentify, phoneNumberIdentificationLabels) = retrievePhoneNumbersToIdentifyAndLabels() else {
        NSLog("Unable to retrieve phone numbers to identify and their labels")
        let error = NSError(domain: "CallDirectoryHandler", code: 2, userInfo: nil)
        context.cancelRequest(withError: error)
        return
    }
    
    for (phoneNumber, label) in zip(phoneNumbersToIdentify, phoneNumberIdentificationLabels) {
        // Validate number format before adding
        guard let cxPhoneNumber = CXCallDirectoryPhoneNumber(phoneNumber) else {
            NSLog("Skipping invalid phone number: \(phoneNumber)")
            continue
        }
        context.addIdentificationEntry(withNextSequentialPhoneNumber: cxPhoneNumber, label: label)
    }
}

2. Trigger Extension Refresh from Your Main App #

Call Directory Extensions don’t automatically sync new data—your main app needs to tell iOS to reload the extension whenever your contact list updates.

Add this code to your main app (e.g., in AppDelegate, SceneDelegate, or wherever you update your contact data):

import CallKit

func refreshCallDirectoryExtension() {
    let extensionBundleID = "com.yourcompany.yourapp.CallDirectoryExtension" // Replace with your extension's actual Bundle ID
    CXCallDirectoryManager.shared.reloadExtension(withIdentifier: extensionBundleID) { error in
        if let error = error {
            print("Extension reload failed: \(error.localizedDescription)")
        } else {
            print("Extension reloaded successfully")
        }
    }
}

Call this function after you save new numbers to UserDefaults (e.g., when the user imports contacts).

Also double-check that the user has enabled your app in Settings → Phone → Call Identification & Blocking—the toggle must be on.

3. Verify App Groups & UserDefaults Sharing #

A misconfigured App Group is a common culprit for shared data failures:

• Confirm both your main app and extension target have the exact same App Group ID enabled in Xcode (Target → Signing & Capabilities → App Groups).
• Update your data retrieval code to avoid force unwraps (which can crash the extension if data is missing):

private func retrievePhoneNumbersToIdentifyAndLabels() -> (phoneNumbers: [String], labels: [String])? {
    guard let sharedDefaults = UserDefaults(suiteName: "group.EXTENSION_NAME"),
          let numbers = sharedDefaults.array(forKey: "contactsPhoneNumbers") as? [String],
          let names = sharedDefaults.array(forKey: "contactsNames") as? [String],
          numbers.count == names.count else {
        NSLog("Failed to load valid shared contact data")
        return nil
    }
    return (numbers, names)
}

4. Debug the Extension Directly #

To see what’s going wrong, run the extension target directly in Xcode:

1. Select your Call Directory Extension target from the run destination dropdown.
2. Choose a physical device (simulators don’t support CallKit extensions).
3. Check the Xcode console for logs about invalid numbers, data retrieval failures, or permission issues.

5. Do You Need Main App Call Handling? #

Nope! Your main app doesn’t need to handle incoming calls at all. The Call Directory Extension runs independently in the background to provide caller ID data—your main app’s only job is to manage the shared data and trigger extension refreshes.

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