Flutter创建固定快捷方式并实现点击跳转指定路径求助

你当前的核心问题是：创建的快捷方式仅打开主页面，因为Intent未携带路径参数，Flutter无法知晓需要跳转的目标位置。以下是分步骤的解决方案：

1. 修改Kotlin代码，为Intent添加路径参数 #

在你的createShortcut函数中，给启动Intent附加路径信息，这样点击快捷方式时，MainActivity能获取到目标路径：

private fun createShortcut(context:Context,folderId:String, folderShortLabel:String, folderLongLabel:String,folderPath:String){
    if (VERSION.SDK_INT>=28){
        val shortcutManager=context.getSystemService(Context.SHORTCUT_SERVICE) as ShortcutManager
        if (shortcutManager.isRequestPinShortcutSupported){
            // 构建携带路径参数的Intent
            val shortcutIntent = Intent(Intent.ACTION_VIEW, null, context, MainActivity::class.java).apply {
                // 添加自定义参数，传递目标路径
                putExtra("target_folder_path", folderPath)
                // 设置Flag避免复用任务栈时丢失参数
                flags = Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK
            }
            
            val pinShortcutInfo = ShortcutInfo.Builder(context,folderId)
                .setShortLabel(folderShortLabel)
                .setLongLabel(folderLongLabel)
                .setIcon(Icon.createWithResource(context,R.drawable.ic_lock_lock))
                .setIntent(shortcutIntent)
                .build()

            val pinShortcallBackIntent = shortcutManager.createShortcutResultIntent(pinShortcutInfo)
            // Android 12+必须指定PendingIntent的Flag，避免崩溃
            val successCallBack =PendingIntent.getBroadcast(context,0,pinShortcallBackIntent,PendingIntent.FLAG_IMMUTABLE)

            shortcutManager.requestPinShortcut(pinShortcutInfo,successCallBack.intentSender)
        }
    }
}

2. 在MainActivity中传递参数给Flutter #

修改MainActivity.kt，同时处理冷启动和热启动场景下的Intent参数，通过MethodChannel将路径传递给Flutter：

class MainActivity : FlutterActivity() {
    // 定义通道名称，需与Flutter端完全一致
    private val SHORTCUT_CHANNEL = "com.your.filemanager/shortcut"

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 处理应用冷启动时的快捷方式参数
        handleShortcutIntent(intent)
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        // 处理应用在后台时，点击快捷方式的参数
        handleShortcutIntent(intent)
    }

    private fun handleShortcutIntent(intent: Intent?) {
        intent?.getStringExtra("target_folder_path")?.let { targetPath ->
            flutterEngine?.dartExecutor?.binaryMessenger?.let { messenger ->
                val channel = MethodChannel(messenger, SHORTCUT_CHANNEL)
                // 调用Flutter端方法，传递路径参数
                channel.invokeMethod("navigateToFolder", targetPath)
            }
        }
    }
}

3. Flutter端接收参数并跳转页面 #

在Flutter主页面中监听MethodChannel调用，收到路径后跳转到对应文件浏览页面：

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

void main() => runApp(const MyFileManagerApp());

class MyFileManagerApp extends StatefulWidget {
  const MyFileManagerApp({super.key});

  @override
  State<MyFileManagerApp> createState() => _MyFileManagerAppState();
}

class _MyFileManagerAppState extends State<MyFileManagerApp> {
  // 与Android端通道名称完全一致
  static const MethodChannel _shortcutChannel = MethodChannel('com.your.filemanager/shortcut');

  @override
  void initState() {
    super.initState();
    // 设置通道方法处理器
    _shortcutChannel.setMethodCallHandler(_handleShortcutMethodCall);
  }

  Future<dynamic> _handleShortcutMethodCall(MethodCall call) async {
    switch (call.method) {
      case 'navigateToFolder':
        // 获取传递的路径参数
        final String targetPath = call.arguments;
        // 跳转到文件浏览页面
        if (mounted) {
          Navigator.push(
            context,
            MaterialPageRoute(
              builder: (context) => FileBrowserPage(currentPath: targetPath),
            ),
          );
        }
        break;
      default:
        throw MissingPluginException();
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '文件管理器',
      home: const MainScreen(), // 你的应用主页面
    );
  }
}

// 示例文件浏览页面，替换成你自己的页面实现
class FileBrowserPage extends StatelessWidget {
  final String currentPath;

  const FileBrowserPage({super.key, required this.currentPath});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(currentPath)),
      body: Center(child: Text('当前路径：$currentPath')),
    );
  }
}

额外注意事项 #

• 通道名称com.your.filemanager/shortcut在Android和Flutter端必须完全一致，大小写敏感。
• 若应用使用Scoped Storage，需确保目标路径对应的文件/文件夹已获取访问权限，否则跳转后无法加载内容。
• 测试时需覆盖两种场景：应用完全关闭时点击快捷方式（冷启动）、应用在后台时点击快捷方式（热启动），确保两种情况都能正确接收参数。

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