Flutter App Scheme
配置说明
1、Android 端配置说明
在您项目中 Android 的AndroidManifest.xml文件中按照如下规范添加Scheme,例如android/app/src/main/AndroidManifest.xml
a、在需要启动的 Activity 中新增以下格式的代码
<!--Android Scheme--><intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <!--需要被网页拉起必须设置--> <category android:name="android.intent.category.BROWSABLE" /> <category android:name="android.intent.category.APP_BROWSER" /> <!--协议部分--> <dataandroid:host="hong.com"android:path="/product"android:scheme="app" /></intent-filter>
复制代码
2、iOS 端配置说明
在你的项目中,ios 工程中Info.plist文件中按照如下规范添加Scheme,例如:ios/Runner/Info.plist
a、在Info.plist文件中添加如下格式的代码
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"> <dict>...<key>CFBundleURLTypes</key><!-- 表示添加Scheme相关信息 --><array> <dict><key>CFBundleURLName</key><string>hong.com/product</string><key>CFBundleURLSchemes</key><array> <string>app</string><!-- 此处是Scheme --></array> </dict></array>... </dict></plist>
复制代码
使用方法
1、初始化
AppScheme appScheme = AppSchemeImpl.getInstance();
复制代码
2、getInitScheme
appScheme.getInitScheme().then((value){ if(value != null){setState(() { _platformVersion = "Init ${value.dataString}";}); }});
复制代码
3、getLatestScheme
appScheme.getLatestScheme().then((value){ if(value != null){setState(() { _platformVersion = "Latest ${value.dataString}";}); }});
复制代码
4、注册从外部打开的 Scheme 监听信息
appScheme.registerSchemeListener().listen((event) { if(event != null){setState(() { _platformVersion = "listen ${event.dataString}";}); }});
复制代码
URL Scheme 协议格式：
一个完整的完整的 URL Scheme 协议格式由 scheme、host、port、path 和 query 组成，其结构如下所示
<scheme>://<host>:<port>/<path>?<query>
复制代码
xiaoxiongapp://xapi.xiaomanxiong.com/home?redirect_type=1&ios_redirect_url=aaaaaaa.com&android_redirect_url=aaaaaaa.com 如下就是一个自定义的 URLopenapp://hhong:80/product?productId=10000007openapp： 即 Scheme 该 Scheme 协议名称（必填）hhong： 即 Host,代表 Scheme 作用于哪个地址域（必填）80： 即 port，代表端口号 product：即 path，代表打开的页面 param： 即 query，代表传递的参数
传递参数的方法跟 web 端一样，通过问号?分隔，参数名和值之间使用等号=连接，多个参数之间使用 &拼接。
Scheme 使用
既然我们使用 scheme 来做打开 app 并跳转的逻辑，那这个 scheme 应该声明在哪里比较合适呢？如果你的应用在启动页（splash）或者在主界面(main)初始化了一些必要的设置，比如必要的 token 信息检查交易或者一些其它校验等，没有这些信息会造成崩溃的，这个时候我们就需要在启动页来声明这个 scheme 了，获取 scheme 信息保存起来，然后在主界面做处理逻辑，如跳转到其它界面等。当然你也可以声明 scheme 在其它地方，具体得需要看怎么实现业务比较方便。
HTML 示列
<!DOCTYPE html><html><head><meta charset='utf-8'><meta http-equiv='X-UA-Compatible' content='IE=edge'><title>测试App Scheme</title><meta name='viewport' content='width=device-width, initial-scale=1'><meta name="viewport" content="width=device-width,initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"/></head><body>
</body></html>
<html><head> </head><body><div><a href="app://hong.com/product?productId=10000007&">Android、iOS</a></div>
<div><a href="app://">app:// 无host</a></div>
<div><a href="app://hong.com">app:// 无path</a></div>
<div><a href="app://hong.com/product">app:// 无query</a></div>
<div><a href="intent://hong.com/product?productId=10000007#Intent;scheme=app;end">Android特殊机型</a></div>
<div style="text-align:center;"><h4>小熊有好货测试</h4><div><a href="xiaoxiongapp://xapi.xiaomanxiong.com/home?redirect_type=1&ios_redirect_url=www.baidu.com&android_redirect_url=www.baidu.com">测试类型1</a></div><div><a href="intent://xapi.xiaomanxiong.com/home?redirect_type=1&ios_redirect_url=www.baidu.com&android_redirect_url=www.baidu.com#Intent;scheme=xiaoxiongapp;end">(Android特殊机型)测试类型1</a></div></div></body></html>
复制代码
评论