Flutter平台交互插件intent_launcher的使用

Flutter平台交互插件intent_launcher的使用

intent_launcher 是一个Flutter插件，它提供了一种简单的方式来通过Intents启动Android系统设置和其他活动。该包允许你轻松地打开各种Android系统设置屏幕，并从你的Flutter应用处理活动结果。

这个包受到并基于Expo团队的优秀工作，他们开发了expo-intent-launcher包。

特性

• 启动Android系统设置屏幕（如Wi-Fi、蓝牙、位置等）
• 使用自定义参数打开特定的Android活动
• 处理活动启动结果
• 支持意图附加项、标志和类别
• 丰富的预定义活动动作集
• 类型安全的API与强大的Flutter集成

平台支持

安装

运行以下命令来安装插件：

flutter pub add intent_launcher

使用

基本用法

// 打开位置设置
await startActivityAsync(ActivityAction.locationSourceSettings);

API 参考

startActivityAsync

启动一个Android活动并返回结果。

Future<IntentLauncherResult> startActivityAsync(
  String action, {
  IntentLauncherParams params = const IntentLauncherParams(),
})

IntentLauncherParams

用于启动活动的配置选项。

class IntentLauncherParams {
  final String? type;        // MIME类型
  final String? category;    // 意图类别
  final Map<String, dynamic>? extra;  // 附加键值对
  final String? data;        // URI数据
  final int? flags;          // 意图标志
  final String? packageName; // 目标包名
}

IntentLauncherResult

包含活动启动的结果。

class IntentLauncherResult {
  ResultCode? resultCode;  // 成功、取消或用户首次
  String? data;           // 结果数据URI
  Map<String, dynamic>? extra;  // 结果附加项
}

常见活动动作

该包提供了大量的预定义活动动作，包括但不限于：

• ActivityAction.settings - 打开系统设置
• ActivityAction.wifiSettings - 打开Wi-Fi设置
• ActivityAction.bluetoothSettings - 打开蓝牙设置
• ActivityAction.airplaneModeSettings - 打开飞行模式设置
• ActivityAction.securitySettings - 打开安全设置
• ActivityAction.locationSourceSettings - 打开位置设置
• ActivityAction.displaySettings - 打开显示设置
• ActivityAction.dateSettings - 打开日期和时间设置
• ActivityAction.soundSettings - 打开声音设置
• ActivityAction.privacySettings - 打开隐私设置
• 更多…

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用intent_launcher插件。

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

void main() {
  runApp(const Root());
}

class Root extends StatelessWidget {
  const Root({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Intent Launcher Example'),
        ),
        body: const IntentLauncherTest(),
      ),
    );
  }
}

class IntentLauncherTest extends StatelessWidget {
  const IntentLauncherTest({super.key});

  Future<void> _startActivityAsync({
    required BuildContext context,
    required String action,
    IntentLauncherParams params = const IntentLauncherParams(),
  }) async {
    final result = await startActivityAsync(
      action,
      params: params,
    );

    if (!context.mounted) return;
    debugPrint(result.toString());
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        children: [
          ElevatedButton(
            onPressed: () {
              _startActivityAsync(
                context: context,
                action: ActivityAction.wirelessSettings,
                params: const IntentLauncherParams(),
              );
            },
            child: const Text('无线设置'),
          ),
          ElevatedButton(
            onPressed: () {
              _startActivityAsync(
                context: context,
                action: ActivityAction.settings,
                params: const IntentLauncherParams(),
              );
            },
            child: const Text('设置'),
          ),
          ElevatedButton(
            onPressed: () {
              _startActivityAsync(
                context: context,
                action: ActivityAction.applicationDetailsSettings,
                params: const IntentLauncherParams(
                  data: 'package:com.android.vending',
                ),
              );
            },
            child: const Text('Play Store 应用详情'),
          ),
          ElevatedButton(
            onPressed: () {
              _startActivityAsync(
                context: context,
                action: ActivityAction.applicationDetailsSettings,
                params: const IntentLauncherParams(
                  data: 'package:package.name.that.doesnt.exist',
                ),
              );
            },
            child: const Text('不存在的包的应用详情'),
          ),
          ElevatedButton(
            onPressed: () {
              _startActivityAsync(
                context: context,
                action: 'android.media.action.IMAGE_CAPTURE',
                params: const IntentLauncherParams(
                  flags: 100,
                ),
              );
            },
            child: const Text('相机'),
          ),
        ],
      ),
    );
  }
}