@minqian/react-native-umeng 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @minqian/react-native-umeng
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+面向 Expo / React Native 的友盟统计（统计上报）轻量封装。
+
+- **同时支持 Android 与 iOS**，两端 API 完全一致，少量行为差异见下文。
+- **Android 延迟 / 两段式初始化**，符合国内隐私合规要求；iOS 端 `preInit` 为 no-op。
+- **自动会话跟踪**，基于 Expo 的 Activity 生命周期钩子实现（Android）。
+- **内置 Expo Config Plugin**：Android 自动注入 `UMENG_APPKEY`、`UMENG_CHANNEL` 元数据及阿里云 Maven 镜像；iOS 自动为模拟器排除 `arm64` 架构以兼容老版本 Umeng framework。
+
+## 安装
+
+```
+npm i file:../react-native-umeng    # 在你的 Expo 项目中执行
+```
+
+`app.json` 配置：
+
+```json
+{
+  "expo": {
+    "plugins": [
+      ["@minqian/react-native-umeng", { "appKey": "<你的友盟 App Key>", "channel": "Umeng" }]
+    ]
+  }
+}
+```
+
+然后执行 `npx expo prebuild --clean`，再按平台运行：
+
+```
+npx expo run:android
+npx expo run:ios
+```
+
+## 使用
+
+```ts
+import Umeng from '@minqian/react-native-umeng';
+
+// App 启动后即可调用（在用户同意隐私政策前也安全）。
+Umeng.preInit('<appKey>', 'Umeng');
+
+// 用户同意隐私政策之后再调用：
+Umeng.init('<appKey>', 'Umeng', { logEnabled: __DEV__ });
+
+// 上报自定义事件。
+Umeng.onEvent('home_open', { source: 'tab' });
+
+// 用户画像（可选）。
+Umeng.onProfileSignIn('user-123');
+Umeng.onProfileSignOff();
+```
+
+## API
+
+| 方法 | 说明 |
+|------|------|
+| `setLogEnabled(enabled)` | 开关友盟 SDK 详细日志 |
+| `preInit(appKey, channel?)` | 预初始化，不上报数据 |
+| `init(appKey, channel?, options?)` | 正式初始化 |
+| `isInitialized()` | 同步获取初始化状态 |
+| `onEvent(eventId, properties?)` | 自定义事件上报 |
+| `onProfileSignIn(userId, provider?)` | 标记当前会话的用户 |
+| `onProfileSignOff()` | 清除用户标记 |
+| `onPageStart(name)` / `onPageEnd(name)` | 手动页面统计 |
+| `reportError(message)` | 自定义错误上报 |
+
+会话生命周期（`onResume` / `onPause`）在 Android 上由 Expo Module 内部的 `OnActivityEntersForeground/Background` 钩子自动驱动，因此**无需**像旧版 SDK 文档建议的那样去重写 `MainActivity`。iOS 端由友盟 SDK 自身处理。
+
+## 平台差异
+
+| 行为 | Android | iOS |
+|------|---------|-----|
+| `preInit` | 真正的预初始化，仅做合规准备，不上报 | no-op（友盟 iOS SDK 没有两段式初始化） |
+| `init` | 调用 `UMConfigure.init` | 调用 `UMConfigure setAppKey:channel:` |
+| `reportError` | 调用 `MobclickAgent.reportError` | UMCAnalytics 6.0 无官方错误 API，退化为自定义事件 `rn_reported_error` |
+| 模拟器架构 | 不涉及 | Config Plugin 自动在 pbxproj 中为 Debug 配置排除 `arm64`，以兼容老版 Umeng framework |
+
+## 许可证
+
+MIT

package/android/build.gradle

@@ -0,0 +1,37 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'com.minqian.umeng'
+version = '0.1.0'
+
+android {
+  namespace "com.minqian.umeng"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+    consumerProguardFiles 'proguard-rules.pro'
+  }
+  lintOptions {
+    abortOnError false
+  }
+}
+
+repositories {
+  maven { url 'https://maven.aliyun.com/repository/public' }
+  maven { url 'https://repo1.maven.org/maven2/' }
+  mavenCentral()
+}
+
+dependencies {
+  // Umeng common SDK + the asms native bridge.
+  // - common 9.4.0: long-standing stable release, widely used in production.
+  // - asms is bumped to 1.6.3 (paired with the 9.4.x common line, modern JNI
+  //   surface). NOTE: no asms release (1.2.3 / 1.6.3 / 1.8.7.2 all checked)
+  //   ships an x86_64 libumeng-spy.so — Umeng's matrix is armeabi-v7a +
+  //   arm64-v8a + x86 only. Real-device testing should use an arm64 phone;
+  //   an x86_64 emulator will fail to load the native lib at init.
+  implementation 'com.umeng.umsdk:common:9.4.0'
+  implementation 'com.umeng.umsdk:asms:1.6.3'
+}

package/android/proguard-rules.pro

@@ -0,0 +1,8 @@
+# Umeng analytics — keep public SDK surface intact in release builds.
+-keep class com.umeng.** { *; }
+-keep class com.uc.** { *; }
+-keep class com.efs.** { *; }
+-keep class org.repackage.** { *; }
+-dontwarn com.umeng.**
+-dontwarn com.uc.**
+-dontwarn com.efs.**

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest />

package/android/src/main/java/com/minqian/umeng/UmengModule.kt

@@ -0,0 +1,123 @@
+package com.minqian.umeng
+
+import android.util.Log
+import com.umeng.analytics.MobclickAgent
+import com.umeng.commonsdk.UMConfigure
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+/**
+ * Umeng (友盟+) Analytics module for Expo.
+ *
+ * Implementation notes:
+ *   - `preInit` is safe to call *before* the user accepts the privacy policy.
+ *   - `init` actually starts collecting + uploading. Call it once consent is in.
+ *   - Session events (`onResume` / `onPause`) are wired automatically through
+ *     Expo's `OnActivityEntersForeground/Background` hooks, so the host app
+ *     does not need to override MainActivity.
+ */
+class UmengModule : Module() {
+
+  companion object {
+    private const val TAG = "UmengModule"
+
+    @Volatile
+    private var initialized: Boolean = false
+  }
+
+  override fun definition() = ModuleDefinition {
+    Name("Umeng")
+
+    // ---- Lifecycle: drive Umeng session start/end ----
+    OnActivityEntersForeground {
+      val ctx = appContext.reactContext ?: return@OnActivityEntersForeground
+      if (initialized) {
+        MobclickAgent.onResume(ctx)
+      }
+    }
+
+    OnActivityEntersBackground {
+      val ctx = appContext.reactContext ?: return@OnActivityEntersBackground
+      if (initialized) {
+        MobclickAgent.onPause(ctx)
+      }
+    }
+
+    // ---- Configuration / init ----
+    Function("setLogEnabled") { enabled: Boolean ->
+      UMConfigure.setLogEnabled(enabled)
+    }
+
+    Function("preInit") { appKey: String, channel: String ->
+      val ctx = appContext.reactContext
+        ?: throw IllegalStateException("Umeng.preInit: no React context")
+      try {
+        UMConfigure.preInit(ctx, appKey, channel)
+        Log.d(TAG, "preInit done (appKey=$appKey, channel=$channel)")
+      } catch (e: Throwable) {
+        Log.e(TAG, "preInit failed", e)
+        throw e
+      }
+    }
+
+    Function("init") { appKey: String, channel: String, deviceType: Int, pushSecret: String ->
+      val ctx = appContext.reactContext
+        ?: throw IllegalStateException("Umeng.init: no React context")
+      try {
+        UMConfigure.init(ctx, appKey, channel, deviceType, pushSecret)
+        initialized = true
+        // Once initialized, also start the current session immediately so the
+        // first foreground tick (already past) doesn't get lost.
+        MobclickAgent.onResume(ctx)
+        Log.d(TAG, "init done (appKey=$appKey, channel=$channel, deviceType=$deviceType)")
+      } catch (e: Throwable) {
+        Log.e(TAG, "init failed", e)
+        throw e
+      }
+    }
+
+    Function("isInitialized") { initialized }
+
+    // ---- Events ----
+    Function("onEvent") { eventId: String, properties: Map<String, String> ->
+      val ctx = appContext.reactContext ?: return@Function
+      if (!initialized) {
+        Log.w(TAG, "onEvent before init — dropped (eventId=$eventId)")
+        return@Function
+      }
+      val payload: MutableMap<String, Any> = HashMap(properties.size + 1)
+      payload.putAll(properties)
+      MobclickAgent.onEventObject(ctx, eventId, payload)
+    }
+
+    // ---- Profile ----
+    Function("onProfileSignIn") { userId: String, provider: String? ->
+      if (!initialized) return@Function
+      if (provider.isNullOrEmpty()) {
+        MobclickAgent.onProfileSignIn(userId)
+      } else {
+        MobclickAgent.onProfileSignIn(provider, userId)
+      }
+    }
+
+    Function("onProfileSignOff") {
+      if (initialized) MobclickAgent.onProfileSignOff()
+    }
+
+    // ---- Manual page tracking ----
+    Function("onPageStart") { pageName: String ->
+      if (initialized) MobclickAgent.onPageStart(pageName)
+    }
+
+    Function("onPageEnd") { pageName: String ->
+      if (initialized) MobclickAgent.onPageEnd(pageName)
+    }
+
+    // ---- Error reporting ----
+    Function("reportError") { message: String ->
+      val ctx = appContext.reactContext ?: return@Function
+      if (!initialized) return@Function
+      MobclickAgent.reportError(ctx, message)
+    }
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin/build/withUmeng').default;

package/build/UmengNativeModule.d.ts

@@ -0,0 +1,16 @@
+import { NativeModule } from 'expo-modules-core';
+export interface UmengNativeModuleType extends NativeModule {
+    setLogEnabled(enabled: boolean): void;
+    preInit(appKey: string, channel: string): void;
+    init(appKey: string, channel: string, deviceType: number, pushSecret: string): void;
+    isInitialized(): boolean;
+    onEvent(eventId: string, properties: Record<string, string>): void;
+    onProfileSignIn(userId: string, provider: string | null): void;
+    onProfileSignOff(): void;
+    onPageStart(pageName: string): void;
+    onPageEnd(pageName: string): void;
+    reportError(message: string): void;
+}
+declare const _default: UmengNativeModuleType;
+export default _default;
+//# sourceMappingURL=UmengNativeModule.d.ts.map

package/build/UmengNativeModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UmengNativeModule.d.ts","sourceRoot":"","sources":["../src/UmengNativeModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG9E,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,aAAa,IAAI,OAAO,CAAC;IACzB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACnE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,gBAAgB,IAAI,IAAI,CAAC;IACzB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;;AAuBD,wBAAkE"}

package/build/UmengNativeModule.js

@@ -0,0 +1,23 @@
+import { requireOptionalNativeModule } from 'expo-modules-core';
+import { Platform } from 'react-native';
+const stub = {
+    // expo-modules-core's NativeModule augments with addListener/removeListeners;
+    // we only declare the methods we actually expose.
+    addListener: () => { },
+    removeListeners: () => { },
+    setLogEnabled: () => { },
+    preInit: () => { },
+    init: () => { },
+    isInitialized: () => false,
+    onEvent: () => { },
+    onProfileSignIn: () => { },
+    onProfileSignOff: () => { },
+    onPageStart: () => { },
+    onPageEnd: () => { },
+    reportError: () => { },
+};
+const native = requireOptionalNativeModule('Umeng');
+// Native module is now available on both iOS and Android.
+// Fallback to stub only on web or if native autolinking failed.
+export default (Platform.OS === 'web' || !native) ? stub : native;
+//# sourceMappingURL=UmengNativeModule.js.map

package/build/UmengNativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UmengNativeModule.js","sourceRoot":"","sources":["../src/UmengNativeModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAgB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAexC,MAAM,IAAI,GAA0B;IAClC,8EAA8E;IAC9E,kDAAkD;IAClD,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;IACzB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;IAC1B,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,eAAe,EAAE,GAAG,EAAE,GAAE,CAAC;IACzB,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC1B,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;IACnB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;CACc,CAAC;AAEtC,MAAM,MAAM,GAAG,2BAA2B,CAAwB,OAAO,CAAC,CAAC;AAE3E,0DAA0D;AAC1D,gEAAgE;AAChE,eAAe,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC","sourcesContent":["import { requireOptionalNativeModule, NativeModule } from 'expo-modules-core';\nimport { Platform } from 'react-native';\n\nexport interface UmengNativeModuleType extends NativeModule {\n  setLogEnabled(enabled: boolean): void;\n  preInit(appKey: string, channel: string): void;\n  init(appKey: string, channel: string, deviceType: number, pushSecret: string): void;\n  isInitialized(): boolean;\n  onEvent(eventId: string, properties: Record<string, string>): void;\n  onProfileSignIn(userId: string, provider: string | null): void;\n  onProfileSignOff(): void;\n  onPageStart(pageName: string): void;\n  onPageEnd(pageName: string): void;\n  reportError(message: string): void;\n}\n\nconst stub: UmengNativeModuleType = {\n  // expo-modules-core's NativeModule augments with addListener/removeListeners;\n  // we only declare the methods we actually expose.\n  addListener: () => {},\n  removeListeners: () => {},\n  setLogEnabled: () => {},\n  preInit: () => {},\n  init: () => {},\n  isInitialized: () => false,\n  onEvent: () => {},\n  onProfileSignIn: () => {},\n  onProfileSignOff: () => {},\n  onPageStart: () => {},\n  onPageEnd: () => {},\n  reportError: () => {},\n} as unknown as UmengNativeModuleType;\n\nconst native = requireOptionalNativeModule<UmengNativeModuleType>('Umeng');\n\n// Native module is now available on both iOS and Android.\n// Fallback to stub only on web or if native autolinking failed.\nexport default (Platform.OS === 'web' || !native) ? stub : native;\n"]}

package/build/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Public API for the Umeng analytics wrapper.
+ *
+ * Two-stage initialization to satisfy China privacy-policy rules:
+ *   1. `preInit(appKey, channel)`  — call early; collects nothing personal.
+ *   2. `init(appKey, channel, opts)` — call after the user accepts your privacy policy.
+ *
+ * Session events (`onResume` / `onPause`) are wired automatically through the
+ * native `ReactActivityLifecycleListener`, so you only need to send custom
+ * events via `onEvent`.
+ *
+ * On iOS every method is a no-op (Umeng iOS is intentionally out of scope here).
+ */
+export type UmengDeviceType = 'phone' | 'box';
+export interface UmengInitOptions {
+    /** Push secret. Pass empty string when push is not used. */
+    pushSecret?: string;
+    /** `'phone'` (default) or `'box'`. */
+    deviceType?: UmengDeviceType;
+    /** Enable verbose Umeng SDK logs. Off by default. */
+    logEnabled?: boolean;
+}
+export interface UmengEventProperties {
+    [key: string]: string | number | boolean | null | undefined;
+}
+/** Turn the Umeng SDK's internal log on/off. Call before `init` to log init. */
+export declare function setLogEnabled(enabled: boolean): void;
+/**
+ * Pre-initialization. Safe to call before the user agrees to the privacy
+ * policy: only registers the app key and channel, does not collect or upload.
+ */
+export declare function preInit(appKey: string, channel?: string): void;
+/**
+ * Full initialization. Call after the user has accepted your privacy policy.
+ * Safe to call multiple times — the SDK guards against double-init.
+ */
+export declare function init(appKey: string, channel?: string, options?: UmengInitOptions): void;
+/** Returns true once `init()` has run successfully. */
+export declare function isInitialized(): boolean;
+/**
+ * Track a custom event.
+ *
+ * @param eventId  Umeng event id you configured in the Umeng dashboard.
+ * @param properties Optional key/value attributes (values are coerced to string).
+ */
+export declare function onEvent(eventId: string, properties?: UmengEventProperties): void;
+/** Tag the current session with an authenticated user id. */
+export declare function onProfileSignIn(userId: string, provider?: string): void;
+/** Drop the previously tagged user id from the session. */
+export declare function onProfileSignOff(): void;
+/**
+ * Manual page-tracking helpers. Only useful when you also call
+ * `setPageCollectionMode('manual')`. Most apps using RN won't need them.
+ */
+export declare function onPageStart(pageName: string): void;
+export declare function onPageEnd(pageName: string): void;
+/** Report a caught error message (Umeng surfaces these as custom errors). */
+export declare function reportError(message: string): void;
+declare const Umeng: {
+    setLogEnabled: typeof setLogEnabled;
+    preInit: typeof preInit;
+    init: typeof init;
+    isInitialized: typeof isInitialized;
+    onEvent: typeof onEvent;
+    onProfileSignIn: typeof onProfileSignIn;
+    onProfileSignOff: typeof onProfileSignOff;
+    onPageStart: typeof onPageStart;
+    onPageEnd: typeof onPageEnd;
+    reportError: typeof reportError;
+};
+export default Umeng;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAgB,GAAG,IAAI,CAGvE;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAgB,EACzB,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CASN;AAED,uDAAuD;AACvD,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,oBAAoB,GAChC,IAAI,CAWN;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGvE;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;CAWV,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/build/index.js

@@ -0,0 +1,93 @@
+import Native from './UmengNativeModule';
+/** Turn the Umeng SDK's internal log on/off. Call before `init` to log init. */
+export function setLogEnabled(enabled) {
+    Native.setLogEnabled(enabled);
+}
+/**
+ * Pre-initialization. Safe to call before the user agrees to the privacy
+ * policy: only registers the app key and channel, does not collect or upload.
+ */
+export function preInit(appKey, channel = 'Umeng') {
+    if (!appKey)
+        throw new Error('[Umeng] preInit: appKey is required');
+    Native.preInit(appKey, channel);
+}
+/**
+ * Full initialization. Call after the user has accepted your privacy policy.
+ * Safe to call multiple times — the SDK guards against double-init.
+ */
+export function init(appKey, channel = 'Umeng', options = {}) {
+    if (!appKey)
+        throw new Error('[Umeng] init: appKey is required');
+    if (options.logEnabled != null)
+        Native.setLogEnabled(!!options.logEnabled);
+    Native.init(appKey, channel, options.deviceType === 'box' ? 2 : 1, options.pushSecret ?? '');
+}
+/** Returns true once `init()` has run successfully. */
+export function isInitialized() {
+    return Native.isInitialized();
+}
+/**
+ * Track a custom event.
+ *
+ * @param eventId  Umeng event id you configured in the Umeng dashboard.
+ * @param properties Optional key/value attributes (values are coerced to string).
+ */
+export function onEvent(eventId, properties) {
+    if (!eventId)
+        throw new Error('[Umeng] onEvent: eventId is required');
+    const map = {};
+    if (properties) {
+        for (const k of Object.keys(properties)) {
+            const v = properties[k];
+            if (v == null)
+                continue;
+            map[k] = String(v);
+        }
+    }
+    Native.onEvent(eventId, map);
+}
+/** Tag the current session with an authenticated user id. */
+export function onProfileSignIn(userId, provider) {
+    if (!userId)
+        throw new Error('[Umeng] onProfileSignIn: userId is required');
+    Native.onProfileSignIn(userId, provider ?? null);
+}
+/** Drop the previously tagged user id from the session. */
+export function onProfileSignOff() {
+    Native.onProfileSignOff();
+}
+/**
+ * Manual page-tracking helpers. Only useful when you also call
+ * `setPageCollectionMode('manual')`. Most apps using RN won't need them.
+ */
+export function onPageStart(pageName) {
+    if (!pageName)
+        throw new Error('[Umeng] onPageStart: pageName is required');
+    Native.onPageStart(pageName);
+}
+export function onPageEnd(pageName) {
+    if (!pageName)
+        throw new Error('[Umeng] onPageEnd: pageName is required');
+    Native.onPageEnd(pageName);
+}
+/** Report a caught error message (Umeng surfaces these as custom errors). */
+export function reportError(message) {
+    if (!message)
+        return;
+    Native.reportError(message);
+}
+const Umeng = {
+    setLogEnabled,
+    preInit,
+    init,
+    isInitialized,
+    onEvent,
+    onProfileSignIn,
+    onProfileSignOff,
+    onPageStart,
+    onPageEnd,
+    reportError,
+};
+export default Umeng;
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import Native from './UmengNativeModule';\n\n/**\n * Public API for the Umeng analytics wrapper.\n *\n * Two-stage initialization to satisfy China privacy-policy rules:\n *   1. `preInit(appKey, channel)`  — call early; collects nothing personal.\n *   2. `init(appKey, channel, opts)` — call after the user accepts your privacy policy.\n *\n * Session events (`onResume` / `onPause`) are wired automatically through the\n * native `ReactActivityLifecycleListener`, so you only need to send custom\n * events via `onEvent`.\n *\n * On iOS every method is a no-op (Umeng iOS is intentionally out of scope here).\n */\n\nexport type UmengDeviceType = 'phone' | 'box';\n\nexport interface UmengInitOptions {\n  /** Push secret. Pass empty string when push is not used. */\n  pushSecret?: string;\n  /** `'phone'` (default) or `'box'`. */\n  deviceType?: UmengDeviceType;\n  /** Enable verbose Umeng SDK logs. Off by default. */\n  logEnabled?: boolean;\n}\n\nexport interface UmengEventProperties {\n  [key: string]: string | number | boolean | null | undefined;\n}\n\n/** Turn the Umeng SDK's internal log on/off. Call before `init` to log init. */\nexport function setLogEnabled(enabled: boolean): void {\n  Native.setLogEnabled(enabled);\n}\n\n/**\n * Pre-initialization. Safe to call before the user agrees to the privacy\n * policy: only registers the app key and channel, does not collect or upload.\n */\nexport function preInit(appKey: string, channel: string = 'Umeng'): void {\n  if (!appKey) throw new Error('[Umeng] preInit: appKey is required');\n  Native.preInit(appKey, channel);\n}\n\n/**\n * Full initialization. Call after the user has accepted your privacy policy.\n * Safe to call multiple times — the SDK guards against double-init.\n */\nexport function init(\n  appKey: string,\n  channel: string = 'Umeng',\n  options: UmengInitOptions = {},\n): void {\n  if (!appKey) throw new Error('[Umeng] init: appKey is required');\n  if (options.logEnabled != null) Native.setLogEnabled(!!options.logEnabled);\n  Native.init(\n    appKey,\n    channel,\n    options.deviceType === 'box' ? 2 : 1,\n    options.pushSecret ?? '',\n  );\n}\n\n/** Returns true once `init()` has run successfully. */\nexport function isInitialized(): boolean {\n  return Native.isInitialized();\n}\n\n/**\n * Track a custom event.\n *\n * @param eventId  Umeng event id you configured in the Umeng dashboard.\n * @param properties Optional key/value attributes (values are coerced to string).\n */\nexport function onEvent(\n  eventId: string,\n  properties?: UmengEventProperties,\n): void {\n  if (!eventId) throw new Error('[Umeng] onEvent: eventId is required');\n  const map: Record<string, string> = {};\n  if (properties) {\n    for (const k of Object.keys(properties)) {\n      const v = properties[k];\n      if (v == null) continue;\n      map[k] = String(v);\n    }\n  }\n  Native.onEvent(eventId, map);\n}\n\n/** Tag the current session with an authenticated user id. */\nexport function onProfileSignIn(userId: string, provider?: string): void {\n  if (!userId) throw new Error('[Umeng] onProfileSignIn: userId is required');\n  Native.onProfileSignIn(userId, provider ?? null);\n}\n\n/** Drop the previously tagged user id from the session. */\nexport function onProfileSignOff(): void {\n  Native.onProfileSignOff();\n}\n\n/**\n * Manual page-tracking helpers. Only useful when you also call\n * `setPageCollectionMode('manual')`. Most apps using RN won't need them.\n */\nexport function onPageStart(pageName: string): void {\n  if (!pageName) throw new Error('[Umeng] onPageStart: pageName is required');\n  Native.onPageStart(pageName);\n}\n\nexport function onPageEnd(pageName: string): void {\n  if (!pageName) throw new Error('[Umeng] onPageEnd: pageName is required');\n  Native.onPageEnd(pageName);\n}\n\n/** Report a caught error message (Umeng surfaces these as custom errors). */\nexport function reportError(message: string): void {\n  if (!message) return;\n  Native.reportError(message);\n}\n\nconst Umeng = {\n  setLogEnabled,\n  preInit,\n  init,\n  isInitialized,\n  onEvent,\n  onProfileSignIn,\n  onProfileSignOff,\n  onPageStart,\n  onPageEnd,\n  reportError,\n};\n\nexport default Umeng;\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["UmengModule"]
+  },
+  "android": {
+    "modules": ["com.minqian.umeng.UmengModule"]
+  }
+}

package/ios/ReactNativeUmeng.podspec

@@ -0,0 +1,29 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ReactNativeUmeng'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage'] || 'https://github.com/yinminqian/react-native-umeng'
+  s.platforms      = { :ios => '15.1' }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/yinminqian/react-native-umeng.git' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'UMCCommon', '~> 2.1.1'
+  s.dependency 'UMCAnalytics', '~> 6.0.5'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule',
+    'OTHER_LDFLAGS' => '$(inherited) -ObjC'
+  }
+
+  s.source_files = '**/*.{h,m,swift}'
+end

package/ios/UmengBridge.h

@@ -0,0 +1,28 @@
+//
+//  UmengBridge.h
+//  ReactNativeUmeng
+//
+//  Objective-C bridge that imports UMCommon and UMAnalytics frameworks
+//  and re-exposes their API to Swift through a plain ObjC interface.
+//  (Old 2019 Umeng frameworks don't have Swift module maps.)
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface UmengBridge : NSObject
+
++ (void)setLogEnabled:(BOOL)enabled;
++ (void)setupWithAppKey:(NSString *)appKey channel:(NSString *)channel;
++ (void)event:(NSString *)eventId;
++ (void)event:(NSString *)eventId attributes:(NSDictionary<NSString *, NSString *> *)attributes;
++ (void)profileSignInWithPUID:(NSString *)puid;
++ (void)profileSignInWithPUID:(NSString *)puid provider:(NSString *)provider;
++ (void)profileSignOff;
++ (void)beginLogPageView:(NSString *)pageName;
++ (void)endLogPageView:(NSString *)pageName;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/UmengBridge.m

@@ -0,0 +1,49 @@
+//
+//  UmengBridge.m
+//  ReactNativeUmeng
+//
+
+#import "UmengBridge.h"
+#import <UMCommon/UMConfigure.h>
+#import <UMCommon/UMCommon.h>
+#import <UMAnalytics/MobClick.h>
+
+@implementation UmengBridge
+
++ (void)setLogEnabled:(BOOL)enabled {
+    [UMConfigure setLogEnabled:enabled];
+}
+
++ (void)setupWithAppKey:(NSString *)appKey channel:(NSString *)channel {
+    [UMConfigure initWithAppkey:appKey channel:channel];
+}
+
++ (void)event:(NSString *)eventId {
+    [MobClick event:eventId];
+}
+
++ (void)event:(NSString *)eventId attributes:(NSDictionary<NSString *, NSString *> *)attributes {
+    [MobClick event:eventId attributes:attributes];
+}
+
++ (void)profileSignInWithPUID:(NSString *)puid {
+    [MobClick profileSignInWithPUID:puid];
+}
+
++ (void)profileSignInWithPUID:(NSString *)puid provider:(NSString *)provider {
+    [MobClick profileSignInWithPUID:puid provider:provider];
+}
+
++ (void)profileSignOff {
+    [MobClick profileSignOff];
+}
+
++ (void)beginLogPageView:(NSString *)pageName {
+    [MobClick beginLogPageView:pageName];
+}
+
++ (void)endLogPageView:(NSString *)pageName {
+    [MobClick endLogPageView:pageName];
+}
+
+@end

package/ios/UmengModule.swift

@@ -0,0 +1,63 @@
+import ExpoModulesCore
+
+// UMCommon and UMAnalytics are old Objective-C frameworks (2019) without
+// Swift module maps. We call them via UmengBridge (ObjC wrapper in this pod).
+
+public class UmengModule: Module {
+  private var initialized = false
+
+  public func definition() -> ModuleDefinition {
+    Name("Umeng")
+
+    Function("setLogEnabled") { (enabled: Bool) in
+      UmengBridge.setLogEnabled(enabled)
+    }
+
+    Function("preInit") { (_: String, _: String) in
+      // Umeng iOS has no separate preInit; this is a no-op.
+      // The Android privacy-policy two-stage pattern doesn't apply on iOS.
+    }
+
+    Function("init") { (appKey: String, channel: String, _: Int, _: String) in
+      UmengBridge.setup(withAppKey: appKey, channel: channel)
+      self.initialized = true
+    }
+
+    Function("isInitialized") { () -> Bool in
+      return self.initialized
+    }
+
+    Function("onEvent") { (eventId: String, properties: [String: String]) in
+      if properties.isEmpty {
+        UmengBridge.event(eventId)
+      } else {
+        UmengBridge.event(eventId, attributes: properties)
+      }
+    }
+
+    Function("onProfileSignIn") { (userId: String, provider: String?) in
+      if let p = provider, !p.isEmpty {
+        UmengBridge.profileSignIn(withPUID: userId, provider: p)
+      } else {
+        UmengBridge.profileSignIn(withPUID: userId)
+      }
+    }
+
+    Function("onProfileSignOff") {
+      UmengBridge.profileSignOff()
+    }
+
+    Function("onPageStart") { (pageName: String) in
+      UmengBridge.beginLogPageView(pageName)
+    }
+
+    Function("onPageEnd") { (pageName: String) in
+      UmengBridge.endLogPageView(pageName)
+    }
+
+    Function("reportError") { (message: String) in
+      // UMCAnalytics 6.0 has no stock error API; fall back to a custom event
+      UmengBridge.event("rn_reported_error", attributes: ["message": message])
+    }
+  }
+}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@minqian/react-native-umeng",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Umeng Analytics SDK wrapper for Expo / React Native — Android only, lazy init, privacy-policy friendly",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "files": [
+    "build",
+    "android",
+    "ios",
+    "src",
+    "plugin/build",
+    "app.plugin.js",
+    "expo-module.config.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "expo-module build",
+    "build:plugin": "tsc --project plugin/tsconfig.json",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "prepare": "expo-module prepare && npm run build:plugin",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "umeng",
+    "analytics",
+    "react-native-umeng"
+  ],
+  "author": "yinminqian",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yinminqian/react-native-umeng.git"
+  },
+  "homepage": "https://github.com/yinminqian/react-native-umeng#readme",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/react": "~19.1.1",
+    "expo": "^55.0.24",
+    "expo-module-scripts": "^55.0.2",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "dependencies": {
+    "@expo/config-plugins": "^55.0.9"
+  }
+}

package/plugin/build/withUmeng.d.ts

@@ -0,0 +1,11 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+export interface WithUmengProps {
+    /** The Umeng AppKey, also written as `UMENG_APPKEY` meta-data into AndroidManifest. */
+    appKey: string;
+    /** Channel name reported to Umeng. Defaults to `Umeng`. */
+    channel?: string;
+}
+declare const withUmeng: ConfigPlugin<WithUmengProps>;
+export { withUmeng };
+declare const _default: ConfigPlugin<WithUmengProps>;
+export default _default;

package/plugin/build/withUmeng.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withUmeng = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const PLUGIN_NAME = '@minqian/react-native-umeng';
+const PLUGIN_VERSION = '0.1.0';
+const ALIYUN_MAVEN = 'https://maven.aliyun.com/repository/public';
+function setMetaData(application, name, value) {
+    var _a;
+    application['meta-data'] = (_a = application['meta-data']) !== null && _a !== void 0 ? _a : [];
+    const existing = application['meta-data'].find((m) => m.$ && m.$['android:name'] === name);
+    if (existing) {
+        existing.$['android:value'] = value;
+    }
+    else {
+        application['meta-data'].push({
+            $: {
+                'android:name': name,
+                'android:value': value,
+            },
+        });
+    }
+}
+function withUmengAndroidManifest(config, props) {
+    return (0, config_plugins_1.withAndroidManifest)(config, (c) => {
+        var _a, _b;
+        const manifest = c.modResults.manifest;
+        manifest.application = (_a = manifest.application) !== null && _a !== void 0 ? _a : [{}];
+        const app = manifest.application[0];
+        setMetaData(app, 'UMENG_APPKEY', props.appKey);
+        setMetaData(app, 'UMENG_CHANNEL', (_b = props.channel) !== null && _b !== void 0 ? _b : 'Umeng');
+        return c;
+    });
+}
+/**
+ * Insert the aliyun Maven mirror at the top of `allprojects { repositories { } }`
+ * in the root `build.gradle` so the Umeng artifacts resolve in mainland China.
+ */
+function withUmengMavenRepo(config) {
+    return (0, config_plugins_1.withProjectBuildGradle)(config, (c) => {
+        if (c.modResults.language !== 'groovy') {
+            return c;
+        }
+        let contents = c.modResults.contents;
+        if (contents.includes(ALIYUN_MAVEN)) {
+            return c;
+        }
+        const repoBlock = `        maven { url '${ALIYUN_MAVEN}' }`;
+        // Try to inject into allprojects { repositories { ... } }
+        const allProjects = /allprojects\s*\{[\s\S]*?repositories\s*\{/m;
+        if (allProjects.test(contents)) {
+            contents = contents.replace(allProjects, (m) => `${m}\n${repoBlock}`);
+        }
+        else {
+            // No allprojects.repositories block? Append one.
+            contents += `\nallprojects {\n    repositories {\n${repoBlock}\n    }\n}\n`;
+        }
+        c.modResults.contents = contents;
+        return c;
+    });
+}
+/**
+ * UMCCommon and UMCAnalytics (Umeng legacy 2019 SDKs) ship device-only arm64 slices.
+ * They pre-date arm64 simulator support (Xcode 12+). Exclude arm64 from simulator
+ * builds on the main app target to avoid linker errors on Apple Silicon Macs.
+ * Also inject the fix into the Podfile post_install for the pod targets.
+ */
+function withUmengExcludedArchs(config) {
+    // 1. Main Xcode project: set "EXCLUDED_ARCHS[sdk=iphonesimulator*]" = arm64.
+    // The key must be wrapped in literal double quotes — CocoaPods' pbxproj parser
+    // rejects unquoted keys containing brackets, while Xcode itself accepts both.
+    const KEY = '"EXCLUDED_ARCHS[sdk=iphonesimulator*]"';
+    config = (0, config_plugins_1.withXcodeProject)(config, (c) => {
+        const project = c.modResults;
+        const targetName = c.modRequest.projectName;
+        const configurations = project.pbxXCBuildConfigurationSection();
+        for (const uuid in configurations) {
+            const conf = configurations[uuid];
+            if (conf.buildSettings &&
+                (conf.buildSettings.PRODUCT_NAME === targetName ||
+                    conf.buildSettings.PRODUCT_BUNDLE_IDENTIFIER)) {
+                // Strip any previous unquoted form to avoid duplicates
+                delete conf.buildSettings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'];
+                if (!conf.buildSettings[KEY]) {
+                    conf.buildSettings[KEY] = '"arm64"';
+                }
+            }
+        }
+        return c;
+    });
+    return config;
+}
+const withUmeng = (config, props) => {
+    if (!(props === null || props === void 0 ? void 0 : props.appKey)) {
+        throw new Error(`[${PLUGIN_NAME}] "appKey" prop is required`);
+    }
+    config = withUmengAndroidManifest(config, props);
+    config = withUmengMavenRepo(config);
+    config = withUmengExcludedArchs(config);
+    return config;
+};
+exports.withUmeng = withUmeng;
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withUmeng, PLUGIN_NAME, PLUGIN_VERSION);

package/src/UmengNativeModule.ts

@@ -0,0 +1,38 @@
+import { requireOptionalNativeModule, NativeModule } from 'expo-modules-core';
+import { Platform } from 'react-native';
+
+export interface UmengNativeModuleType extends NativeModule {
+  setLogEnabled(enabled: boolean): void;
+  preInit(appKey: string, channel: string): void;
+  init(appKey: string, channel: string, deviceType: number, pushSecret: string): void;
+  isInitialized(): boolean;
+  onEvent(eventId: string, properties: Record<string, string>): void;
+  onProfileSignIn(userId: string, provider: string | null): void;
+  onProfileSignOff(): void;
+  onPageStart(pageName: string): void;
+  onPageEnd(pageName: string): void;
+  reportError(message: string): void;
+}
+
+const stub: UmengNativeModuleType = {
+  // expo-modules-core's NativeModule augments with addListener/removeListeners;
+  // we only declare the methods we actually expose.
+  addListener: () => {},
+  removeListeners: () => {},
+  setLogEnabled: () => {},
+  preInit: () => {},
+  init: () => {},
+  isInitialized: () => false,
+  onEvent: () => {},
+  onProfileSignIn: () => {},
+  onProfileSignOff: () => {},
+  onPageStart: () => {},
+  onPageEnd: () => {},
+  reportError: () => {},
+} as unknown as UmengNativeModuleType;
+
+const native = requireOptionalNativeModule<UmengNativeModuleType>('Umeng');
+
+// Native module is now available on both iOS and Android.
+// Fallback to stub only on web or if native autolinking failed.
+export default (Platform.OS === 'web' || !native) ? stub : native;

package/src/index.ts

@@ -0,0 +1,136 @@
+import Native from './UmengNativeModule';
+
+/**
+ * Public API for the Umeng analytics wrapper.
+ *
+ * Two-stage initialization to satisfy China privacy-policy rules:
+ *   1. `preInit(appKey, channel)`  — call early; collects nothing personal.
+ *   2. `init(appKey, channel, opts)` — call after the user accepts your privacy policy.
+ *
+ * Session events (`onResume` / `onPause`) are wired automatically through the
+ * native `ReactActivityLifecycleListener`, so you only need to send custom
+ * events via `onEvent`.
+ *
+ * On iOS every method is a no-op (Umeng iOS is intentionally out of scope here).
+ */
+
+export type UmengDeviceType = 'phone' | 'box';
+
+export interface UmengInitOptions {
+  /** Push secret. Pass empty string when push is not used. */
+  pushSecret?: string;
+  /** `'phone'` (default) or `'box'`. */
+  deviceType?: UmengDeviceType;
+  /** Enable verbose Umeng SDK logs. Off by default. */
+  logEnabled?: boolean;
+}
+
+export interface UmengEventProperties {
+  [key: string]: string | number | boolean | null | undefined;
+}
+
+/** Turn the Umeng SDK's internal log on/off. Call before `init` to log init. */
+export function setLogEnabled(enabled: boolean): void {
+  Native.setLogEnabled(enabled);
+}
+
+/**
+ * Pre-initialization. Safe to call before the user agrees to the privacy
+ * policy: only registers the app key and channel, does not collect or upload.
+ */
+export function preInit(appKey: string, channel: string = 'Umeng'): void {
+  if (!appKey) throw new Error('[Umeng] preInit: appKey is required');
+  Native.preInit(appKey, channel);
+}
+
+/**
+ * Full initialization. Call after the user has accepted your privacy policy.
+ * Safe to call multiple times — the SDK guards against double-init.
+ */
+export function init(
+  appKey: string,
+  channel: string = 'Umeng',
+  options: UmengInitOptions = {},
+): void {
+  if (!appKey) throw new Error('[Umeng] init: appKey is required');
+  if (options.logEnabled != null) Native.setLogEnabled(!!options.logEnabled);
+  Native.init(
+    appKey,
+    channel,
+    options.deviceType === 'box' ? 2 : 1,
+    options.pushSecret ?? '',
+  );
+}
+
+/** Returns true once `init()` has run successfully. */
+export function isInitialized(): boolean {
+  return Native.isInitialized();
+}
+
+/**
+ * Track a custom event.
+ *
+ * @param eventId  Umeng event id you configured in the Umeng dashboard.
+ * @param properties Optional key/value attributes (values are coerced to string).
+ */
+export function onEvent(
+  eventId: string,
+  properties?: UmengEventProperties,
+): void {
+  if (!eventId) throw new Error('[Umeng] onEvent: eventId is required');
+  const map: Record<string, string> = {};
+  if (properties) {
+    for (const k of Object.keys(properties)) {
+      const v = properties[k];
+      if (v == null) continue;
+      map[k] = String(v);
+    }
+  }
+  Native.onEvent(eventId, map);
+}
+
+/** Tag the current session with an authenticated user id. */
+export function onProfileSignIn(userId: string, provider?: string): void {
+  if (!userId) throw new Error('[Umeng] onProfileSignIn: userId is required');
+  Native.onProfileSignIn(userId, provider ?? null);
+}
+
+/** Drop the previously tagged user id from the session. */
+export function onProfileSignOff(): void {
+  Native.onProfileSignOff();
+}
+
+/**
+ * Manual page-tracking helpers. Only useful when you also call
+ * `setPageCollectionMode('manual')`. Most apps using RN won't need them.
+ */
+export function onPageStart(pageName: string): void {
+  if (!pageName) throw new Error('[Umeng] onPageStart: pageName is required');
+  Native.onPageStart(pageName);
+}
+
+export function onPageEnd(pageName: string): void {
+  if (!pageName) throw new Error('[Umeng] onPageEnd: pageName is required');
+  Native.onPageEnd(pageName);
+}
+
+/** Report a caught error message (Umeng surfaces these as custom errors). */
+export function reportError(message: string): void {
+  if (!message) return;
+  Native.reportError(message);
+}
+
+const Umeng = {
+  setLogEnabled,
+  preInit,
+  init,
+  isInitialized,
+  onEvent,
+  onProfileSignIn,
+  onProfileSignOff,
+  onPageStart,
+  onPageEnd,
+  reportError,
+};
+
+export default Umeng;