Flutter自定义URL Schema处理插件schema_dart的使用

在Flutter应用中，自定义URL Schema可以让你的应用通过特定的URL进行启动，并处理URL中的参数。schema_dart 是一个假设的插件名称（实际中，Flutter 并没有一个广泛使用的名为 schema_dart 的插件来处理自定义URL Schema，但我们可以基于类似功能的插件或手动实现一个类似的功能）。

下面是一个基于 Flutter 和原生代码（iOS 和 Android）的示例，展示如何实现自定义URL Schema的处理。

1. 配置 Flutter 项目

首先，确保你的 Flutter 项目已经创建并准备好。

2. 配置 iOS 项目

修改 Info.plist

在 ios/Runner/Info.plist 文件中，添加一个新的 URL type 配置：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mycustomschema</string>
        </array>
    </dict>
</array>

在 AppDelegate.swift 中处理 URL

打开 ios/Runner/AppDelegate.swift 文件，并添加以下代码来处理 URL：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }

  override func application(
    _ app: UIApplication,
    open url: URL,
    options: [UIApplication.OpenURLOptionsKey : Any] = [:]
  ) -> Bool {
    // 在这里处理自定义URL Schema
    if url.scheme == "mycustomschema" {
      let components = URLComponents(url: url, resolvingAgainstBaseURL: false)!
      let path = components.path
      let queryItems = components.queryItems ?? []
      
      // 假设我们有一个查询参数 `param`
      if let param = queryItems.first(where: { $0.name == "param" })?.value {
        print("Received URL with param: \(param)")
        
        // 传递参数到 Flutter
        let channel = FlutterMethodChannel(name: "com.example.myapp/custom_url_channel", binaryMessenger: self.flutterEngine!.binaryMessenger)
        channel.invokeMethod("handleCustomURL", arguments: ["param": param])
      }
      
      return true
    }
    return false
  }
}

3. 配置 Android 项目

修改 AndroidManifest.xml

在 android/app/src/main/AndroidManifest.xml 文件中，添加以下配置：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="mycustomschema" android:host="*" />
</intent-filter>

通常，这个 intent-filter 会添加到你的 MainActivity 配置中，如下所示：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTop"
    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="mycustomschema" android:host="*" />
    </intent-filter>
</activity>

在 MainActivity.kt 中处理 URL

打开 android/app/src/main/kotlin/com/yourcompany/yourapp/MainActivity.kt 文件（如果使用的是 Kotlin），并添加以下代码来处理 URL：

package com.yourcompany.yourapp

import android.content.Intent
import android.net.Uri
import androidx.annotation.NonNull
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity: FlutterActivity() {
    private val CHANNEL = "com.example.myapp/custom_url_channel"

    override fun configureFlutterEngine(@NonNull flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            // 这里通常处理来自 Dart 的消息
        }
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        setIntent(intent)
        handleIntent(intent)
    }

    private fun handleIntent(intent: Intent) {
        intent.data?.let { uri ->
            if (uri.scheme == "mycustomschema") {
                val param = uri.getQueryParameter("param")
                param?.let {
                    // 传递参数到 Flutter
                    MethodChannel(flutterEngine!!.dartExecutor.binaryMessenger, CHANNEL)
                        .invokeMethod("handleCustomURL", hashMapOf("param" to it))
                }
            }
        }
    }
}

4. 在 Flutter 中接收参数

最后，在 Flutter 中创建一个 Dart 方法来接收和处理从原生平台传递过来的参数：

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

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

class MyApp extends StatelessWidget {
  static const platform = MethodChannel('com.example.myapp/custom_url_channel');

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Custom URL Schema Example'),
        ),
        body: Center(
          child: Text('Waiting for custom URL...'),
        ),
      ),
    );
  }

  @override
  void initState() {
    super.initState();
    _handleCustomURL();
  }

  void _handleCustomURL() async {
    try {
      platform.setMethodCallHandler((call) async {
        if (call.method == "handleCustomURL") {
          final Map<String, dynamic> args = call.arguments as Map<String, dynamic>;
          print("Received custom URL with param: ${args['param']}");
          // 在这里处理接收到的参数
        }
      });
    } on PlatformException catch (e) {
      print("Failed to set platform message handler: '${e.message}'.");
    }
  }
}

以上代码展示了如何在 Flutter 应用中处理自定义URL Schema，并通过原生代码（iOS 和 Android）将URL参数传递给 Flutter。注意，这只是一个示例，实际项目中可能需要根据具体需求进行调整。