Flutter链接处理插件linkrunner的使用

安装

步骤1：安装linkrunner

通过命令行安装

运行以下命令：

flutter pub add linkrunner

或者

手动添加依赖

在 pubspec.yaml 文件的 dependencies 下添加 linkrunner：

dependencies:
    linkrunner: ^0.7.9

然后运行：

flutter pub get

以安装新的依赖项。

步骤2：Android更新

在 app/build.gradle 文件中添加以下内容：

dependencies {
    ...
    implementation("com.android.installreferrer:installreferrer:2.2")
}

使用

初始化

你需要你的项目令牌来初始化包。将它放在 main 函数中：

import 'package:linkrunner/main.dart';

// 初始化包
final linkrunner = LinkRunner();

void main() async {
    // 在调用.init方法之前调用.ensureInitialized方法
    WidgetsFlutterBinding.ensureInitialized();

    final init = await linkrunner.init("YOUR_PROJECT_TOKEN");
    runApp(MyApp());
}

初始化响应类型

{
  ip_location_data: {
    ip: string;
    city: string;
    countryLong: string;
    countryShort: string;
    latitude: number;
    longitude: number;
    region: string;
    timeZone: string;
    zipCode: string;
  };
  deeplink: string;
  root_domain: boolean;
  campaign_data: {
    id: string;
    name: string;
    type: "ORGANIC" | "INORGANIC";
    ad_network: "META" | "GOOGLE" | null;
    group_name: string | null;
    asset_group_name: string | null;
    asset_name: string | null;
  };
}

触发

在您的引导完成并且主堆栈加载后调用此函数：

import 'package:linkrunner/main.dart';

void trigger() async {
    final trigger = await linkrunner.trigger(
        userData: LRUserData(
                id: '1',
                name: 'John Doe', // 可选
                phone: '9583849238', // 可选
                email: 'support@linkrunner.io', // 可选
            ),
        data: {}, // 您可能需要的任何其他数据
        config: TriggerConfig(
            triggerDeeplink: true // 默认为true
        )
    );
  }

设置 config > triggerDeeplink 为 true 将不会触发深层链接（仅当您自己处理重定向时才将其设置为false）。

您可以在 data 属性中传递任何其他与用户相关的数据。

触发响应类型

{
  ip_location_data: {
    ip: string;
    city: string;
    countryLong: string;
    countryShort: string;
    latitude: number;
    longitude: number;
    region: string;
    timeZone: string;
    zipCode: string;
  };
  deeplink: string;
  root_domain: boolean;
  trigger: boolean; // 如果为false，则不会触发深层链接
}

注意：trigger 的值仅在用户首次触发该功能时为true，以防止不必要的重定向。

捕获收入

在支付确认后调用此函数：

import 'package:linkrunner/models/lr_capture_payment.dart';

void capturePayment() async {
    await linkrunner.capturePayment(
        capturePayment: LRCapturePayment(
            userId: '666',
            amount: 24168, // 发送金额时只使用一种货币
            paymentId: 'AJKHAS' // 可选但推荐
        ),
    );
  }

注意：如果您接受多种货币的付款，在调用上述函数之前，请将其转换为一种货币。

移除捕获的支付收入

在支付被取消或退款后调用此函数：

import 'package:linkrunner/models/lr_remove_payment.dart';

void removeCapturedPayment() async {
    await linkrunner.removePayment(
        removePayment: LRRemovePayment(
            userId: '666',
            paymentId: 'AJKHAS' // 必须提供支付ID或用户ID之一
        ),
    );
  }