如何在Flutter中运行时切换PostHog项目？

初始配置步骤 #

1. AndroidManifest.xml配置 #

在android/app/src/main/AndroidManifest.xml中添加PostHog元数据配置：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="your.package.name">
  <application>
    <meta-data android:name="com.posthog.posthog.API_KEY" android:value="YOUR_API_KEY" />
    <meta-data android:name="com.posthog.posthog.POSTHOG_HOST" android:value="https://app.posthog.com" />
    <meta-data android:name="com.posthog.posthog.TRACK_APPLICATION_LIFECYCLE_EVENTS" android:value="true" />
    <meta-data android:name="com.posthog.posthog.DEBUG" android:value="true" />
  </application>
</manifest>

2. 调整Android最低SDK版本 #

在android/app/build.gradle的defaultConfig块中更新最低SDK版本：

defaultConfig {
  minSdkVersion 21
}

3. 基础Flutter代码示例 #

import 'package:flutter/material.dart';
import 'package:posthog_flutter/posthog_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Analytics',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Home')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => Posthog().capture(event: 'button_clicked'),
          child: const Text('Click me'),
        ),
      ),
    );
  }
}

运行时切换PostHog项目的实现 #

PostHog Flutter SDK支持通过configure方法在运行时重新初始化配置，以此切换到不同项目，具体操作如下：

1. 登录成功后执行切换逻辑 #

在用户登录成功的回调中，先重置当前PostHog实例，再传入目标项目的API Key和Host完成配置切换：

// 模拟登录成功后的处理逻辑
Future<void> switchPostHogProject(String targetApiKey, String targetHost) async {
  // 重置旧实例，清除旧项目的事件队列与用户信息
  await Posthog().reset();
  
  // 配置新的PostHog项目
  await Posthog().configure(
    apiKey: targetApiKey,
    host: targetHost,
    trackApplicationLifecycleEvents: true,
    debug: true,
  );
  
  // 将当前用户关联到新项目
  await Posthog().identify(
    userId: '当前登录用户ID',
    userProperties: {
      'username': '用户昵称',
      'email': '用户邮箱',
    },
  );
}

2. 切换时的注意事项 #

• 必须调用reset()：避免旧项目的未发送事件混入新项目，保证数据隔离。
• 同步用户标识：切换后调用identify()，确保后续事件归属到当前用户。
• 保持配置一致性：如果需要沿用初始配置的其他参数（如trackApplicationLifecycleEvents），需在configure时一并传入，否则会使用SDK默认值。

3. 完整集成示例 #

将切换逻辑整合到登录流程中：

import 'package:flutter/material.dart';
import 'package:posthog_flutter/posthog_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Analytics',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const LoginPage(),
    );
  }
}

class LoginPage extends StatelessWidget {
  const LoginPage({super.key});

  Future<void> _handleLogin(BuildContext context) async {
    // 实际场景中从后端或用户配置获取目标项目信息
    const targetApiKey = 'NEW_PROJECT_API_KEY';
    const targetHost = 'https://app.posthog.com';

    // 切换PostHog项目
    await Posthog().reset();
    await Posthog().configure(
      apiKey: targetApiKey,
      host: targetHost,
      trackApplicationLifecycleEvents: true,
      debug: true,
    );

    // 标识当前用户
    await Posthog().identify(userId: 'user_123', userProperties: {'username': '张三'});

    // 跳转到首页
    if (mounted) {
      Navigator.pushReplacement(
        context,
        MaterialPageRoute(builder: (context) => const HomePage()),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('登录')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => _handleLogin(context),
          child: const Text('登录并切换项目'),
        ),
      ),
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('首页')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => Posthog().capture(event: 'home_button_clicked'),
          child: const Text('触发事件（已切换项目）'),
        ),
      ),
    );
  }
}

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