iOS 18.2+下默认通话App如何接收来电通知？

先排查现有配置的遗漏项 #

• 确认com.apple.developer.calling-app权限的完整配置：不仅要在本地.entitlements文件添加，还要在苹果开发者后台的对应App ID中勾选该权限，本地配置与后台权限不一致会直接导致功能失效。
• 检查UIBackgroundModes的正确性：Info.plist中UIBackgroundModes数组必须包含小写的voip，大小写敏感，拼写错误会导致后台无法唤醒处理来电。
• 完善CXProviderConfiguration配置：
  • 必须设置localizedName（比如@"我的通话App"），这是系统识别默认通话App的关键标识；
  • 明确设置supportsVideo（即使仅做语音通话，也需设为NO）；
  • 配置maximumCallGroups和maximumCallsPerCallGroup（建议设为1和1，符合常规通话场景）；
  • 显式设置supportsIncomingCalls为YES（默认值为YES，但显式设置更稳妥）。
• 提前初始化CXProvider：必须在App启动阶段（比如application:didFinishLaunchingWithOptions:或SceneDelegate的scene:willConnectToSession:options:）完成CXProvider的初始化和代理设置，不能等到需要时才创建，否则系统后台唤醒时无法及时响应来电。

正确检测与处理来电的核心流程 #

你当前大概率遗漏了呼入来电的核心代理方法，以下是完整的处理步骤：

1. 实现CXProviderDelegate的provider:didReceiveIncomingCall:withCompletion:方法——这是系统传递呼入来电的唯一入口：

   - (void)provider:(CXProvider *)provider didReceiveIncomingCall:(CXCall *)call withCompletion:(void (^)(NSError * _Nullable))completion {
       // 1. 创建并配置来电信息
       CXCallUpdate *update = [[CXCallUpdate alloc] init];
       update.remoteHandle = [[CXHandle alloc] initWithType:CXHandleTypePhoneNumber value:call.handle.value];
       update.localizedCallerName = @"来电联系人"; // 可根据实际业务逻辑动态设置
       update.supportsVideo = NO;
   
       // 2. 告知系统已准备好处理来电
       completion(nil);
   
       // 3. 保存来电UUID，用于后续接听/挂断等操作
       self.currentCallUUID = call.UUID;
   
       // 4. 触发自定义来电UI或本地通知（按需实现）
       [self showIncomingCallUIWithUUID:call.UUID];
   }
   

2. 补充音频会话相关代理方法：必须实现provider:didActivateAudioSession:和provider:didDeactivateAudioSession:，负责管理通话音频的激活与释放，系统会因为缺失这些方法拒绝交付来电：

   - (void)provider:(CXProvider *)provider didActivateAudioSession:(AVAudioSession *)audioSession {
       NSError *error;
       [audioSession setActive:YES error:&error];
       // 处理音频会话激活后的逻辑，比如播放来电提示音
   }
   
   - (void)provider:(CXProvider *)provider didDeactivateAudioSession:(AVAudioSession *)audioSession {
       [audioSession setActive:NO withOptions:AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation error:nil];
       // 处理音频会话释放后的逻辑，比如停止提示音
   }
   

3. 必须用真机测试：模拟器不支持CallKit的真实运营商来电场景，需用两台真机测试（一台拨打，一台将你的App设为默认通话App接收）。

iOS18.2+的额外配置要求 #

iOS18.2对默认通话App的权限做了强化，需新增以下配置：

• 添加com.apple.developer.callkit.incoming-call-filter权限：
  1. 在苹果开发者后台的对应App ID中勾选「CallKit Incoming Call Filter」权限；
  2. 在本地.entitlements文件中添加该键，值设为布尔型YES：

     <key>com.apple.developer.callkit.incoming-call-filter</key>
     <true/>
     

• 确保后台权限未被限制：前往系统设置→通用→后台App刷新，开启你的App的后台刷新权限；同时确认App未被系统标记为「不允许后台活动」。

调试技巧 #

• 查看系统日志：用Xcode控制台过滤CallKit或CXProvider关键词，系统会输出具体的错误原因（比如权限缺失、代理方法未实现等）；
• 验证默认通话App设置：在系统设置→电话→默认通话App中，确认你的App已被选中，若刚设置完未生效，可重启App或设备；
• 检查音频会话：测试App能否正常激活/停用AVAudioSession，音频会话异常会导致系统拒绝交付来电。

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