Flutter iOS端如何请求拨打电话权限？权限弹窗不显示问题排查

我开发的Flutter应用需要实现拨打电话功能，期望触发拨号时自动获取权限。当前代码在Android端运行正常，但iOS端使用permission_handler: ^11.3.1调用Permission.phone.request()时，完全没有弹出权限请求弹窗。查库文档发现Permission.phone仅适用于Android，换成Permission.contacts会弹出通讯录权限请求，但这不是我需要的拨打电话权限。我已经在info.plist中添加了相关配置，但问题仍未解决。想请教iOS端应该用什么权限替代Permission.phone，或者是否需要更换权限处理库？

现有实现代码 #

Future<void> _makePhoneCall() async {
    if (Platform.isAndroid) {
      final callPermissionStatus = await Permission.phone.request();
      if (callPermissionStatus.isGranted) {
        final String userPhone = contactPhone;
        try {
          const MethodChannel('caller').invokeMethod('makeCall', userPhone);
        } on PlatformException catch (e) {
          Fluttertoast.showToast(
            msg: AppLocalizations.instance.translate("failedToCallTheNumber") +
                ("$contactPhone, ${e.message}"),
          );
        }
      } else {
        Fluttertoast.showToast(
          msg: AppLocalizations.instance.translate("failedToCallTheNumber") +
              ("$contactPhone"),
        );
      }
    } else if (Platform.isIOS) {
      final callPermissionStatus = await Permission.phone.request();
      if (callPermissionStatus.isGranted) {
        final String userPhone = contactPhone;
        try {
          const MethodChannel('caller')
              .invokeMethod('makeCall', userPhone);
        } on PlatformException catch (e) {
          Fluttertoast.showToast(
            msg: AppLocalizations.instance.translate("failedToCallTheNumber") +
                (" $contactPhone, ${e.message}"),
          );
        }
      } else {
        final String userPhone = contactPhone;
        Fluttertoast.showToast(
          msg: AppLocalizations.instance.translate("failedToCallTheNumber") +
              (" $userPhone"),
        );
      }
    }
  }

info.plist配置 #

<key>LSApplicationQueriesSchemes</key>
    <array>
    <string>needed to make phone calls</string>
    </array>
    <key>NSCallKitUsageDescription</key>
    <string>Call access permission is required to make calls.</string>
    <key>NSContactsUsageDescription</key>
    <string>Permission to access contacts is required to make calls.</string>
    <key>NSMicrophoneUsageDescription</key>
    <string>Permission to access the microphone is required to make calls.</string>

Flutter环境检测结果 #

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.5, on macOS 14.4.1 23E224 darwin-arm64, locale ru-UA)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.3)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.2)
[✓] VS Code (version 1.87.2)
[✓] VS Code (version 1.87.2)
[✓] Connected device (3 available)
[✓] Network resources

• No issues found!

问题分析与解决方案 #

1. iOS拨打电话的权限逻辑澄清 #

iOS系统本身没有专门的“拨打电话”权限：

• 如果是跳转到系统电话应用拨号，不需要任何权限，也无需调用权限请求接口，直接触发拨号即可。
• 只有当你使用**CallKit框架在App内直接发起通话（不跳转系统电话）**时，才需要配置NSCallKitUsageDescription，此时对应的permission_handler权限是Permission.callKit（v11.3.1版本已支持该权限）。

2. 修正代码建议 #

方案一：使用官方推荐的url_launcher库（简洁跨平台）

替换自定义MethodChannel实现，直接调用系统拨号链接：

import 'package:url_launcher/url_launcher.dart';

Future<void> _makePhoneCall() async {
  final Uri telUri = Uri(scheme: 'tel', path: contactPhone);
  try {
    if (await canLaunchUrl(telUri)) {
      await launchUrl(telUri);
    } else {
      Fluttertoast.showToast(
        msg: "${AppLocalizations.instance.translate("failedToCallTheNumber")} $contactPhone",
      );
    }
  } catch (e) {
    Fluttertoast.showToast(
      msg: "${AppLocalizations.instance.translate("failedToCallTheNumber")} $contactPhone, ${e.toString()}",
    );
  }
}

方案二：保留自定义MethodChannel实现

• iOS端无需请求权限，直接调用拨号逻辑；如果用CallKit实现通话，需替换权限请求为Permission.callKit：

  // iOS部分代码修改
  else if (Platform.isIOS) {
    // 仅当使用CallKit时才需要请求该权限
    final callPermissionStatus = await Permission.callKit.request();
    if (callPermissionStatus.isGranted || callPermissionStatus.isLimited) {
      final String userPhone = contactPhone;
      try {
        const MethodChannel('caller').invokeMethod('makeCall', userPhone);
      } on PlatformException catch (e) {
        Fluttertoast.showToast(
          msg: "${AppLocalizations.instance.translate("failedToCallTheNumber")} $contactPhone, ${e.message}",
        );
      }
    } else {
      Fluttertoast.showToast(
        msg: "${AppLocalizations.instance.translate("failedToCallTheNumber")} $contactPhone",
      );
    }
  }
  

3. 修正info.plist配置错误 #

LSApplicationQueriesSchemes的配置有误，需要添加tel协议而非描述文本：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>tel</string>
</array>

如果不用CallKit，可移除NSCallKitUsageDescription；如果不需要访问通讯录，也可移除NSContactsUsageDescription，避免不必要的权限提示。

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