Flutter Web iOS Smart Banner参数传递及Flutter App接收检测咨询

一、先确认Smart Banner的meta标签配置 #

确保你的Flutter Web页面里的apple-itunes-app meta标签包含app-argument参数，建议加入自定义标识方便后续判断来源，比如：

<meta name="apple-itunes-app" content="app-id=123456789, app-argument=from_smart_banner&target_page=home">

二、iOS原生端配置与参数传递 #

Flutter依赖原生层处理URL跳转逻辑，需修改iOS项目代码：

1. 配置唤起方式
   在Xcode项目设置中，添加对应URL Scheme（如yourapp://），或配置Universal Links（基于域名关联），确保App能被外部链接唤起。

2. 修改AppDelegate.swift
   处理App被唤起时的URL，提取app-argument并传递给Flutter：

   import UIKit
   import Flutter
   
   @UIApplicationMain
   @objc class AppDelegate: FlutterAppDelegate {
     override func application(
       _ application: UIApplication,
       didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
     ) -> Bool {
       GeneratedPluginRegistrant.register(with: self)
       
       // 处理冷启动时的URL参数
       if let url = launchOptions?[.url] as? URL {
         handleAppUrl(url: url)
       }
       return super.application(application, didFinishLaunchingWithOptions: launchOptions)
     }
     
     // 处理App后台唤起的情况
     override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
       handleAppUrl(url: url)
       return true
     }
     
     // 处理Universal Links唤起
     override func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
       if userActivity.activityType == NSUserActivityTypeBrowsingWeb, let url = userActivity.webpageURL {
         handleAppUrl(url: url)
       }
       return true
     }
     
     // 解析参数并传递给Flutter
     private func handleAppUrl(url: URL) {
       let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
       if let argument = components?.queryItems?.first(where: { $0.name == "app-argument" })?.value {
         let channel = FlutterMethodChannel(name: "com.yourapp/smart_banner", binaryMessenger: window?.rootViewController as! FlutterBinaryMessenger)
         channel.invokeMethod("receivedSmartBannerArgument", arguments: argument)
       }
     }
   }
   

三、Flutter端接收参数并判断来源 #

在Flutter代码中通过MethodChannel监听原生传递的参数：

import 'package:flutter/services.dart';

class SmartBannerHandler {
  static const MethodChannel _channel = MethodChannel('com.yourapp/smart_banner');
  
  static Future<String?> init() async {
    String? argument;
    // 监听原生传来的参数
    _channel.setMethodCallHandler((call) async {
      if (call.method == 'receivedSmartBannerArgument') {
        argument = call.arguments as String;
        // 判断是否来自Smart Banner
        if (argument?.contains('from_smart_banner') == true) {
          print('App was opened from Safari Smart Banner');
          // 这里添加对应业务逻辑
        }
      }
    });
    
    // 主动获取冷启动时的参数
    try {
      argument = await _channel.invokeMethod('getInitialSmartBannerArgument');
    } on PlatformException catch (e) {
      print('Failed to get initial argument: ${e.message}');
    }
    
    return argument;
  }
}

在main.dart的入口初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SmartBannerHandler.init();
  runApp(const MyApp());
}

关键说明 #

• 来源判断：通过app-argument中的自定义标识（如from_smart_banner），即可识别是否从Smart Banner打开App。
• 参数解析：若app-argument是复杂结构，可使用Uri.parse(argument)解析具体参数（如示例中的target_page）。
• 全场景覆盖：原生代码同时处理了冷启动和后台唤起两种情况，确保任何状态下都能获取到参数。

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