Flutter安卓意图调用插件android_intent_plus的使用

插件简介

android_intent_plus 是一个Flutter插件，它允许Flutter应用程序在Android平台上启动任意的意图（Intent）。该插件支持指定动作、类别、数据和额外参数来构建和启动意图。需要注意的是，这个插件只适用于Android平台，如果在iOS上调用将会导致应用崩溃。

平台支持

要求

• Flutter >=3.12.0
• Dart >=3.1.0 <4.0.0
• Android compileSDK 34
• Java 17
• Android Gradle Plugin >=8.3.0
• Gradle wrapper >=8.4

使用方法

以下是android_intent_plus的基本使用方法：

import 'package:android_intent_plus/android_intent.dart';
import 'package:platform/platform.dart';

if (Platform.isAndroid) {
  final intent = AndroidIntent(
    action: 'action_view', // 意图的动作类型
    data: Uri.encodeFull('https://flutter.dev'), // 意图的数据部分
    arguments: {'authAccount': 'user@example.com'}, // 额外参数
  );
  await intent.launch(); // 启动意图
}

对于某些特定的动作，例如打开应用设置或位置服务设置，可以使用预定义的动作字符串：

if (Platform.isAndroid) {
  final intent = AndroidIntent(
    action: 'action_application_details_settings',
    data: 'package:com.example.app', // 替换为你的应用包名
  );
  await intent.launch();
}

查询活动

你可以使用canResolveActivity()和getResolvedActivity()来检查是否有活动能够处理特定的意图，或者获取能够处理该意图的活动详情：

final intent = AndroidIntent(
  action: 'action_view',
  data: Uri.encodeFull('http://'),
);

// 检查是否有活动能处理此意图
final canHandleIntent = await intent.canResolveActivity();

// 获取将要处理此意图的活动详情
final details = await intent.getResolvedActivity();
print(details.packageName); // 打印出处理该意图的应用程序包名，如com.google.chrome

Android 11 包可见性

从Android 11开始引入了新的权限机制以控制包的可见性。如果你打算使用canResolveActivity()方法，你需要在AndroidManifest.xml中声明需要查询的具体包名：

<queries>
  <package android:name="com.example.specificapp" />
</queries>

更多关于包可见性的信息，请参阅官方文档。

完整示例Demo

下面是一个完整的Flutter项目示例，展示了如何使用android_intent_plus来创建各种类型的意图并启动它们：

import 'package:android_intent_plus/android_intent.dart';
import 'package:flutter/material.dart';
import 'package:platform/platform.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        useMaterial3: true,
        colorSchemeSeed: Color(0x9f4376f8),
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  void _createAlarm() {
    const intent = AndroidIntent(
      action: 'android.intent.action.SET_ALARM',
      arguments: <String, dynamic>{
        'android.intent.extra.alarm.DAYS': [2, 3, 4, 5, 6],
        'android.intent.extra.alarm.HOUR': 21,
        'android.intent.extra.alarm.MINUTES': 30,
        'android.intent.extra.alarm.SKIP_UI': true,
        'android.intent.extra.alarm.MESSAGE': 'Create a Flutter app',
      },
    );
    intent.launch();
  }

  @override
  Widget build(BuildContext context) {
    Widget body;
    if (const LocalPlatform().isAndroid) {
      body = Padding(
        padding: EdgeInsets.symmetric(vertical: 15.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: [
            ElevatedButton(
              onPressed: _createAlarm,
              child: Text('Tap here to set an alarm\non weekdays at 9:30pm.'),
            ),
            // ... 其他按钮 ...
          ],
        ),
      );
    } else {
      body = Text('This plugin only works with Android');
    }
    return Scaffold(
      appBar: AppBar(
        title: Text('Android intent plus example app'),
        elevation: 4,
      ),
      body: Center(child: body),
    );
  }
}

以上代码片段提供了一个简单的界面，其中包含一个按钮用于设置闹钟。你可以根据需求扩展这个例子，添加更多的按钮来测试其他类型的意图。