# Flutter (https://talivia.com/zh-CN/docs/mobile-analytics/flutter)



`talivia_flutter` 支持 iOS 和 Android 上的 Flutter 应用。它向 Talivia 事件接收端发送原生应用活动，应用中无需私密 API 密钥。

## 安装 [#安装]

```sh
flutter pub add talivia_flutter
flutter pub add shared_preferences
```

## 初始化与追踪 [#初始化与追踪]

```dart
import 'dart:io';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:talivia_flutter/talivia_flutter.dart';

final analytics = Talivia(
  websiteId: 'YOUR_WEBSITE_UUID',
  platform: Platform.isIOS ? 'ios' : 'android',
  preferences: await SharedPreferences.getInstance(),
  hostname: 'example.com',
);

await analytics.screen('Home');
await analytics.track('signup_completed', {'plan': 'pro'});
await analytics.identify('your-stable-user-id');
// 退出登录时：await analytics.reset();
```

Navigator 或 Router 发生变化时调用 `screen()`。只有相关产品操作完成后才记录事件。仅在应用的同意和隐私设置允许采集时初始化。

使用与网站相同的 Website ID、域名和稳定账户 ID，在一个工作区查看两种来源。当前跨设备漏斗仍按访客标识统计。离线重试仅保存在内存中，最多容纳 100 个事件，应用退出后会丢失。应用商店购买和活动归因需要单独接入可信的数据来源。

[查看 Flutter 分析](https://talivia.com/zh-CN/mobile-app-analytics/flutter) · [在 pub.dev 上查看](https://pub.dev/packages/talivia_flutter)