Flutter双视图展示插件open_dual_view的使用

open_dual_view 插件为 Flutter 提供了在 Android 设备上以双视图模式打开其他应用程序的功能。双视图模式允许用户同时查看和与两个应用交互。

特性

• 在双视图模式下打开应用程序。
• 通过包名或 URI 方案启动应用程序。

开始使用

1. 添加依赖

在您的 pubspec.yaml 文件中添加 open_dual_view 依赖：

dependencies:
  flutter:
    sdk: flutter
  open_dual_view: ^1.0.0  # 检查 pub.dev 上的最新版本

2. 导入包

在 Dart 代码中导入 open_dual_view 包：

import 'package:open_dual_view/open_dual_view.dart';

3. 使用方式

可以通过指定包名或 URI 来在双视图模式下打开应用程序。注意，至少需要提供其中一个参数。

import 'package:open_dual_view/open_dual_view.dart';

Future<void> openAppInDualView() async {
  try {
    // 通过包名打开应用程序
    await OpenDualView.openInDualView(
      packageName: 'com.example.myapp', // 替换为目标应用的包名
    );

    // 或者通过 URI 打开应用程序或内容
    await OpenDualView.openInDualView(
      uri: 'example://content', // 替换为目标 URI
    );
  } catch (e) {
    print('未能在双视图模式下打开应用程序: $e');
  }
}

开发注意事项

可以使用 getAvailablePackagesName 获取可用的应用程序包名列表（如果需要通过包名打开应用程序）。如果遇到问题，请参考下方的已知问题和建议。

4. 平台支持

open_dual_view 插件适用于支持双视图模式的 Android 设备，最低支持 Android SDK 30（Android 11）及以上。

最低 SDK 版本

此插件要求最低 SDK 版本为 30（Android 11）。确保您的 android/app/build.gradle 文件中包含以下配置：

android {
    defaultConfig {
        minSdkVersion 30
    }
}

注意事项

• Android 11 (API level 30) 及更高版本引入了对应用程序查询机制的更改。在 AndroidManifest.xml 中使用 <queries> 元素来声明您的应用程序打算查询哪些包。确保您的应用程序包含必要的 <queries> 元素以指定需要交互的包。

• 权限：此包不使用 <QUERY_ALL_PACKAGES> 权限，而是仅通过 <queries> 元素查询特定包。

如果要通过包名打开应用程序，请确保您的 AndroidManifest.xml 配置正确（由于 Android 的包可见性过滤机制，这可能不可靠）：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="your.package.name">

    <application>
    </application>
    <!-- 声明需要查询的包 -->
    <queries>
        <package android:name="com.twitter.android" />
        <!-- 添加更多包 -->
    </queries>
</manifest>

已知问题和建议

• 包名限制：通过包名打开应用程序可能无法正常工作，因为目标应用程序可能存在限制或特殊配置。如果遇到此类问题，建议改用 URI。

• 使用 URI：如果目标应用程序支持通过 URI 方案进行深度链接，则使用 URI 方法更为可靠。确保目标应用程序支持您使用的 URI 方案。

• 自定义 Intent：如果您是目标应用程序的开发者，请考虑实现 Intent 处理逻辑，以确保应用程序能够正确打开并实现深度链接功能。

贡献

我们欢迎对 open_dual_view 插件的贡献！

1. 报告问题：如果发现任何错误或问题，请在 GitHub 上提交问题，并提供尽可能多的详细信息，包括重现步骤、日志和截图。

2. 提出功能建议：如果您有新功能或改进的想法，请在 GitHub 上提交建议。描述您的想法并解释它如何增强插件。

免责声明：open_dual_view 插件的功能也可以通过 android_intent_plus 插件实现。目前，open_dual_view 插件专注于双视图模式功能，并提供独特的接口。随着 Android API 的发展，我们将计划在该插件中实现更多独特功能。

如有更多问题或需要帮助，请随时联系我们。

祝您编码愉快！

完整示例代码

以下是完整的示例代码，展示如何使用 open_dual_view 插件。

示例代码

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('open_dual_view 示例')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              try {
                // 通过包名打开应用程序
                await OpenDualView.openInDualView(
                  packageName: 'com.example.myapp',
                );

                // 或者通过 URI 打开应用程序或内容
                await OpenDualView.openInDualView(
                  uri: 'example://content',
                );
              } catch (e) {
                print('未能在双视图模式下打开应用程序: $e');
              }
            },
            child: Text('打开双视图模式'),
          ),
        ),
      ),
    );
  }
}