Flutter如何实现一键拉起

发布于:2025-03-22 ⋅ 阅读:(19) ⋅ 点赞:(0)

引言

APP想要实现分享功能,从落地页直接跳转安装,无需打开三方浏览器;或者在已安装的情况下一键拉起/唤起。

为了减少重复造轮子,可以使用Xinstall现有的SDK,集成一键拉起、携带参数安装、事件统计等功能。

相关链接:

一键拉起介绍- Xinstall

SDK下载-Xinstall

集成文档 · XInstall

下面我们介绍如何进行Flutter接入:

一、配置

先从Xinstall申请开发者账号并创建应用,获取 AppKey

在 pubspec.yaml 添加依赖,

dependencies:
  ...
  # 依赖XInstall
  xinstall_flutter_plugin: ^1.5.7

终端进入项目目录并输入 flutter pub get 安装

Android平台配置

在 /android/app/build.gradle 中添加下列代码:

android: {
  ....
  defaultConfig {
    ...
    manifestPlaceholders = [
        XINSTALL_APPKEY : "XInstall为应用分配的 AppKey",
    ]
  }    
}

在/android/app/src/main/AndroidMenifest.xml application

修改 /android/app/src/main/AndroidMenifest.xml 文件,
在 application 标签内添加

<meta-data
    android:name="com.xinstall.APP_KEY"
    android:value="${XINSTALL_APPKEY}" />

在 activity 标签内添加 intent-filter (一般为 MainActivity)

<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="xi${XINSTALL_APPKEY}"/>
</intent-filter>

iOS平台配置

1、配置appkey

在Flutter工程下的ios/Runner/Info.plist文件中配置appkey键值对,如下:

<key>com.xinstall.APP_KEY</key>
<string>xinstall分配给应用的appkey</string>
以下为一键拉起 功能相关配置和代码
2、Universal Links相关配置(支持iOS9.0以后)

Xinstall 通过universal link(iOS≥9 ),在app已安装的情况下,从各种浏览器(包括微信、QQ、新浪微博、钉钉等主流社交软件的内置浏览器)拉起app并传递动态参数,避免重复安装。

首先,我们需要到苹果开发者网站 ,为当前的App ID开启关联域名(Associated Domains)服务:

Associated Domains

为刚才开发关联域名功能的AppID创建新的(或更新现有的)描述文件,下载并导入到Xcode中(通过Xcode自动生成的描述文件,可跳过这一步):

config

在Xcode中配置Xinstall为当前应用生成的关联域名 (Associated Domains) :applinks:xxxx.xinstall.top 和 applinks:xxxx.xinstall.net

具体的关联域名可在 Xinstall管理后台 - 对应的应用控制台 - iOS下载配置 页面中找到

在 ios/Runner/AppDelegate.m 中添加通用链接(Universal Link)回调方法,委托插件来处理:

在头部引入


#import <xinstall_flutter_plugin/XinstallFlutterPlugin.h>

添加如下方法

//添加此方法以获取拉起参数
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{
    //判断是否通过Xinstall Universal Link 唤起App
    if ([XinstallFlutterPlugin continueUserActivity:userActivity]){//如果使用了Universal link ,此方法必写
        return YES;
    }
    //其他第三方回调;
    return YES;
}
3、集成Scheme

首先,在Xcode选中Target -> Info -> URL Types,配置Xinstall 为当前应用生成的 Scheme,如图所示: 

applinks

代码部分:

在 AppDelegate 的两个scheme回调方法中添加Xinstall的Scheme方法

//iOS9以下调用这个方法
-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    // 处理通过Xinstall URL SchemeURL 唤起App的数据
    [XinstallFlutterPlugin handleSchemeURL:url];
    //其他第三方回调;
    return YES;
}
//iOS9以上会优先走这个方法
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(nonnull NSDictionary *)options{
    // 处理通过Xinstall URL SchemeURL 唤起App的数据
    [XinstallFlutterPlugin handleSchemeURL:url];
    //其他第三方回调;
    return YES;
}

二、初始化

在 main.dart 添加
import 'package:xinstall_flutter_plugin/xinstall_flutter_plugin.dart';

 _xinstallFlutterPlugin = XinstallFlutterPlugin.getInstance();
 // 普通初始化
 _xinstallFlutterPlugin.init();
 // 广告初始化xPermissionBackHandler 为初始化后的回调,内部可添加自己的逻辑
 _xinstallFlutterPlugin.initWithAd({"adEnable":true,"idfa":"测试外传idfa","asaEnable":true},xPermissionBackHandler);

 Future xPermissionBackHandler() async {
    setState(() {
      // 此处初始化结束后我执行了安装参数获取
      print("执行了获取安装参数的方法");
      _getXInstallParam();
    });
  }

三、功能集成

1.快速下载/一键拉起

如果只需要快速下载功能和一键拉起,无需其它功能(携带参数安装、渠道统计),完成初始化配置即可。其他影响因素如下图 

 还有一些 携带参数安装/唤起、高级数据统计、场景定制统计、广告平台渠道功能、苹果搜索广告(ASA)渠道功能可以看集成文档

三、导出apk/ipa包并上传

参考官网文档

iOS集成-导出ipa包并上传

Android-集成

四、如何测试功能

参考官方文档 测试集成效果


网站公告

今日签到

点亮在社区的每一天
去签到