RN 層只暴露一個統一的埋點方法，例如 trackEvent(eventName, params)，內部通過 NativeModule 調用 Android/iOS 的原生埋點 SDK。這樣 RN 層不用關心具體實現。

寫一個通用的示例：

---

1. RN 層封裝統一接口（JS 代碼）

// analytics.js
import { NativeModules, Platform } from 'react-native';const { AnalyticsModule } = NativeModules;const Analytics = {trackEvent(eventName, params = {}) {if (!AnalyticsModule) {console.warn("AnalyticsModule not linked");return;}AnalyticsModule.trackEvent(eventName, params);}
};export default Analytics;

RN 業務里用法：

import Analytics from './analytics';Analytics.trackEvent('button_click', { page: 'home', userId: '12345' });

---

2. Android 端原生模塊

在 android/app/src/main/java/com/yourapp/analytics/AnalyticsModule.java：

package com.yourapp.analytics;import android.util.Log;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.ReadableMap;import java.util.HashMap;
import java.util.Map;public class AnalyticsModule extends ReactContextBaseJavaModule {public AnalyticsModule(ReactApplicationContext reactContext) {super(reactContext);}@Overridepublic String getName() {return "AnalyticsModule"; // RN 里調用的名字}@ReactMethodpublic void trackEvent(String eventName, ReadableMap params) {Map<String, Object> map = params.toHashMap();// TODO: 這里替換成你們實際的埋點 SDK 調用Log.d("Analytics", "TrackEvent: " + eventName + " params: " + map.toString());}
}

注冊模塊 AnalyticsPackage.java：

package com.yourapp.analytics;import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.uimanager.ViewManager;import java.util.ArrayList;
import java.util.Collections;
import java.util.List;public class AnalyticsPackage implements ReactPackage {@Overridepublic List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {List<NativeModule> modules = new ArrayList<>();modules.add(new AnalyticsModule(reactContext));return modules;}@Overridepublic List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {return Collections.emptyList();}
}

在 MainApplication.java 里注冊：

@Override
protected List<ReactPackage> getPackages() {return Arrays.<ReactPackage>asList(new MainReactPackage(),new AnalyticsPackage()  // 注冊);
}

---

3. iOS 端原生模塊

在 ios/AnalyticsModule.m：

#import <React/RCTBridgeModule.h>@interface RCT_EXTERN_MODULE(AnalyticsModule, NSObject)RCT_EXTERN_METHOD(trackEvent:(NSString *)eventName params:(NSDictionary *)params)@end

在 ios/AnalyticsModule.swift（或 .m，我用 Swift 例子）：

import Foundation@objc(AnalyticsModule)
class AnalyticsModule: NSObject {@objcfunc trackEvent(_ eventName: String, params: [String: Any]) {// TODO: 替換為 iOS 的埋點 SDK 調用print("TrackEvent: \(eventName), params: \(params)")}
}

---

? 最終效果：
RN 調用 Analytics.trackEvent("xxx", {...})
👉 Android / iOS 走各自原生埋點 SDK。

這樣就實現了 RN 與原生端通用的埋點接口。