Flutter url_launcher 在 iOS 上失效怎么办？

2024-07-10 05:26:13

Flutter 开发者必看：iOS 设备上 Url Launcher 失效解决方案

在 Flutter 应用开发中，调用系统功能如拨打电话、发送邮件、打开网页等十分常见。url_launcher 插件为我们提供了一种跨平台的解决方案，然而，不少开发者反映在 iOS 设备上遇到了 url_launcher 失效的问题。本文将深入探讨这个问题的根源，并提供有效的解决方案，帮助你在 iOS 平台上顺利实现应用内调用系统功能。

iOS 系统以其严格的安全机制著称，这与 Android 系统形成了鲜明对比。在 iOS 上，应用访问系统资源的权限管理更为严格，这也是 url_launcher 插件在 iOS 平台上失效的主要原因。具体来说，如果你的应用需要调用电话、发送邮件等功能，必须事先在应用的 Info.plist 文件中声明相应的权限，否则 iOS 系统会阻止应用执行这些操作。

精准配置 Info.plist 文件

Info.plist 文件是 iOS 应用的关键配置文件，用于存储应用的配置信息，包括应用名称、版本号、权限设置等。要解决 url_launcher 在 iOS 上失效的问题，你需要在 Info.plist 文件中添加相应的权限声明。

添加权限声明需要根据你的应用所需要调用的功能，在 Info.plist 文件中添加不同的 Key-Value 对。下面列举了一些常用的权限声明：

拨打电话:
- Key: NSUserActivityTypes
- Value: 将 com.apple.developer.authentication-services.tel 添加到数组中。
发送邮件:
- Key: LSApplicationQueriesSchemes
- Value: 将 mailto 添加到数组中。

需要注意的是， 打开网页通常不需要额外的权限声明。

以下是配置 Info.plist 文件的步骤：

打开你的 Flutter 项目，找到 ios/Runner/Info.plist 文件。

在 <dict> 标签内添加上述 Key-Value 对。

例如，添加拨打电话权限的代码如下：

<key>NSUserActivityTypes</key>
<array>
    <string>com.apple.developer.authentication-services.tel</string>
</array>

保存 Info.plist 文件，并重新编译你的应用。

代码示例：拨打电话

以下代码示例展示了在添加权限声明后，如何使用 url_launcher 拨打电话：

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';

class CallButton extends StatelessWidget {
  final String phoneNumber;

  const CallButton({Key? key, required this.phoneNumber}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () async {
        final Uri launchUri = Uri(
          scheme: 'tel',
          path: phoneNumber,
        );
        if (await canLaunchUrl(launchUri)) {
          await launchUrl(launchUri);
        } else {
          // 处理无法拨打电话的情况
          // 例如，显示错误提示
        }
      },
      child: const Text('拨打电话'),
    );
  }
}