react-native-quicktracking-analytics-module 2.0.2 → 2.1.0

package/android/src/main/java/com/quicktrackinganalyticsmodule/utils/RNViewUtils.kt

@@ -0,0 +1,233 @@
+package com.quicktrackinganalyticsmodule.utils
+
+import android.app.Activity
+import android.view.View
+import android.view.ViewGroup
+import org.json.JSONObject
+import java.lang.ref.WeakReference
+import java.util.WeakHashMap
+import java.util.concurrent.locks.ReentrantReadWriteLock
+
+/**
+ * Utility class for managing React Native view operations and screen tracking.
+ */
+object RNViewUtils {
+    private val lock = ReentrantReadWriteLock()
+    private var mWeakCurrentActivityReference: WeakReference<Activity>? = null
+    private var currentTitle: String? = null
+    private var currentScreenName: String? = null
+    var isScreenVisible = false
+        private set
+    private var screenProperties: JSONObject? = null
+    private var onTouchViewReference: WeakReference<View>? = null
+    private val mScreenMap = WeakHashMap<Activity, JSONObject>()
+
+    /**
+     * Sets the current touch view for tracking.
+     * @param nativeTargetView The view that was touched
+     */
+    fun setOnTouchView(nativeTargetView: View) {
+        lock.writeLock().lock()
+        try {
+            onTouchViewReference = WeakReference(nativeTargetView)
+        } finally {
+            lock.writeLock().unlock()
+        }
+    }
+
+    /**
+     * Gets the current activity.
+     * @return The current activity or null if not available
+     */
+    fun getCurrentActivity(): Activity? {
+        lock.readLock().lock()
+        try {
+            return mWeakCurrentActivityReference?.get()
+        } finally {
+            lock.readLock().unlock()
+        }
+    }
+
+    /**
+     * Finds a view by its ID in the view hierarchy.
+     * @param viewId The ID of the view to find
+     * @param onTouchView The view where the touch occurred
+     * @return The found view or null if not found
+     */
+    private fun getClickView(viewId: Int, onTouchView: View): View? {
+        var currentView = onTouchView
+        while (currentView.id != viewId) {
+            val parent = currentView.parent
+            if (parent !is View) {
+                return null
+            }
+            currentView = parent
+        }
+        return currentView
+    }
+
+    /**
+     * Recursively searches for a view by its ID in a ViewGroup's children.
+     * @param viewId The ID of the view to find
+     * @param currentView The ViewGroup to search in
+     * @return The found view or null if not found
+     */
+    private fun getClickViewInChild(viewId: Int, currentView: ViewGroup): View? {
+        for (i in 0 until currentView.childCount) {
+            val childView = currentView.getChildAt(i) ?: continue
+            if (childView.id == viewId) {
+                return childView
+            }
+            if (childView is ViewGroup) {
+                getClickViewInChild(viewId, childView)?.let { return it }
+            }
+        }
+        return null
+    }
+
+    /**
+     * Gets the view that was touched by its tag.
+     * @param viewTag The tag of the view to find
+     * @return The found view or null if not found
+     */
+    fun getTouchViewByTag(viewTag: Int): View? {
+        lock.readLock().lock()
+        try {
+            val onTouchView = onTouchViewReference?.get() ?: return null
+            var clickView = getClickView(viewTag, onTouchView)
+            if (clickView == null && onTouchView is ViewGroup) {
+                clickView = getClickViewInChild(viewTag, onTouchView)
+            }
+            return clickView
+        } finally {
+            lock.readLock().unlock()
+        }
+    }
+
+    /**
+     * Gets a view by its tag, searching in both the current activity and touch view.
+     * @param viewTag The tag of the view to find
+     * @return The found view or null if not found
+     */
+    fun getViewByTag(viewTag: Int): View? {
+        return try {
+            var clickView: View? = null
+            val currentActivity = getCurrentActivity()
+            if (currentActivity != null) {
+                clickView = currentActivity.findViewById(viewTag)
+            }
+            clickView ?: getTouchViewByTag(viewTag)
+        } catch (e: Exception) {
+            QTLog.printStackTrace(e)
+            null
+        }
+    }
+
+    /**
+     * Gets the current screen title.
+     * @return The current title or null if not set
+     */
+    fun getTitle(): String? = currentTitle
+
+    /**
+     * Gets the current screen name.
+     * @return The current screen name or null if not set
+     */
+    fun getScreenName(): String? = currentScreenName
+
+    /**
+     * Sets the current activity and updates screen properties.
+     * @param currentActivity The activity to set as current
+     */
+    private fun setCurrentActivity(currentActivity: Activity) {
+        lock.writeLock().lock()
+        try {
+            clearCurrentActivityReference()
+            mWeakCurrentActivityReference = WeakReference(currentActivity)
+            val properties = mScreenMap[currentActivity]
+            if (properties != null && properties.has("\$screen_name")) {
+                saveScreenAndTitle(
+                    properties.optString("\$screen_name"),
+                    properties.optString("\$title")
+                )
+            } else {
+                currentScreenName = null
+                currentTitle = null
+                screenProperties = null
+            }
+        } finally {
+            lock.writeLock().unlock()
+        }
+    }
+
+    /**
+     * Saves the current screen name and title.
+     * @param screenName The name of the screen
+     * @param title The title of the screen
+     */
+    fun saveScreenAndTitle(screenName: String, title: String) {
+        lock.writeLock().lock()
+        try {
+            currentScreenName = screenName
+            currentTitle = title
+            try {
+                screenProperties = JSONObject().apply {
+                    put("\$title", title)
+                    put("\$screen_name", screenName)
+                    put("isSetRNViewTag", true)
+                }
+            } catch (e: Exception) {
+                QTLog.printStackTrace(e)
+            }
+            getCurrentActivity()?.let { currentActivity ->
+                screenProperties?.let { properties ->
+                    mScreenMap[currentActivity] = properties
+                }
+            }
+        } finally {
+            lock.writeLock().unlock()
+        }
+    }
+
+    /**
+     * Clears the current activity reference.
+     */
+    fun clearCurrentActivityReference() {
+        lock.writeLock().lock()
+        try {
+            mWeakCurrentActivityReference?.clear()
+            mWeakCurrentActivityReference = null
+        } finally {
+            lock.writeLock().unlock()
+        }
+    }
+
+    /**
+     * Sets the screen visibility.
+     * @param isVisiable Whether the screen is visible
+     */
+    fun setScreenVisiable(isVisiable: Boolean) {
+        lock.writeLock().lock()
+        try {
+            this.isScreenVisible = isVisiable
+        } finally {
+            lock.writeLock().unlock()
+        }
+    }
+
+    /**
+     * Called when an activity is resumed.
+     * @param currentActivity The activity that was resumed
+     */
+    fun onActivityResumed(currentActivity: Activity) {
+        setScreenVisiable(true)
+        setCurrentActivity(currentActivity)
+    }
+
+    /**
+     * Called when an activity is paused.
+     */
+    fun onActivityPaused() {
+        setScreenVisiable(false)
+    }
+}

package/ios/QuicktrackingAnalyticsModule.h

@@ -1,15 +1,12 @@
 #import <Foundation/Foundation.h>
 
+
 #if __has_include(<React/RCTBridgeModule.h>)
 #import <React/RCTBridgeModule.h>
 #else
 #import "RCTBridgeModule.h"
 #endif
 
-NS_ASSUME_NONNULL_BEGIN
-
 @interface QuicktrackingAnalyticsModule : NSObject <RCTBridgeModule>
 
 @end
-
-NS_ASSUME_NONNULL_END

package/ios/{QuicktrackingAnalyticsModule.m → QuicktrackingAnalyticsModule.mm}

@@ -1,24 +1,117 @@
-//#if __has_include(<QTCommon/MobClick.h>)
+#import "QuicktrackingAnalyticsModule.h"
+#import <React/RCTConvert.h>
+#import <React/RCTEventDispatcher.h>
+#import <React/RCTLog.h>
+#import "QTRNUtils.h"
+#import "QuickTrackingSDKManager.h"
+
+#if __has_include(<QTCommon/MobClick.h>)
 #import <QTCommon/MobClick.h>
 #import <QTCommon/UMConfigure.h>
 #import <QTCommon/UMSpm.h>
+#endif
 
-//#else
-//#import "MobClick.h"
-//#endif
+#if __has_include(<UMCommonLog/UMCommonLogHeaders.h>)
+#import <UMCommonLog/UMCommonLogHeaders.h>
+#endif
 
-#import "QuicktrackingAnalyticsModule.h"
-#import "QTRNUtils.h"
-#import "QuickTrackingSDKManager.h"
+@implementation QuicktrackingAnalyticsModule
 
-#import <React/RCTConvert.h>
-#import <React/RCTEventDispatcher.h>
-#import <React/RCTLog.h>
+RCT_EXPORT_MODULE()
 
+//======================================全局属性相关===========================================//
+RCT_EXPORT_METHOD(registerGlobalProperty:(NSDictionary*)globalproperty)
+{
+    if (globalproperty == nil && [globalproperty isKindOfClass:[NSNull class]]) {
+        globalproperty = nil;
+    }
+    [QTMobClick registerGlobalProperty:globalproperty];
+}
 
-@implementation QuicktrackingAnalyticsModule
+RCT_EXPORT_METHOD(clearGlobalProperties)
+{
+    [QTMobClick clearGlobalProperties];
+}
+
+RCT_EXPORT_METHOD(getGlobalProperty:(NSString*)propertyName resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    if (propertyName == nil || [propertyName isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    @try {
+        NSString* property = [QTMobClick getGlobalProperty:propertyName];
+        resolve(property);
+    } @catch (NSException *exception) {
+        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
+    }
+}
+
+RCT_EXPORT_METHOD(unregisterGlobalProperty:(NSString*)propertyName)
+{
+    if (propertyName == nil && [propertyName isKindOfClass:[NSNull class]]) {
+        propertyName = nil;
+    }
+    [QTMobClick unregisterGlobalProperty:propertyName];
+}
+
+RCT_EXPORT_METHOD(getGlobalProperties:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject) {
+    @try {
+        NSDictionary* dict = [QTMobClick getGlobalProperties];
+        resolve(dict);
+    } @catch (NSException *exception) {
+        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
+    }
+}
+
+//======================================用户账号和用户属性相关===========================================//
+RCT_EXPORT_METHOD(profileSignIn:(NSString*)puid provider:(NSString*)provider)
+{
+    if (puid == nil || [puid isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    if (provider == nil || [provider isKindOfClass:[NSNull class]]) {
+        [QTMobClick profileSignInWithPUID:puid];
+    } else {
+        [QTMobClick profileSignInWithPUID:puid provider:provider];
+    }
+}
+
+RCT_EXPORT_METHOD(profileSignOff)
+{
+    [QTMobClick profileSignOff];
+}
+
+/**
+ * React Native 保存可点击控件列表信息
+ */
+RCT_EXPORT_METHOD(saveViewProperties:(NSInteger)reactTag
+                  clickable:(BOOL)clickable parameters:(NSDictionary *)paramters) {
+    @try {
+        [[QuickTrackingSDKManager sharedInstance] prepareView:@(reactTag) clickable:clickable paramters:paramters];
+    } @catch (NSException *exception) {
+        NSLog(@"[QuickTracking ReactNative] error: %@", exception);
+    }
+}
+
+/**
+ * React Native 保存可点击控件列表信息
+ *
+ * @param reactTag  当前控件唯一标识符
+ * @param clickable  当前控件可点击状态
+ * @param paramters  当前控件自定义参数
+ * @param rootTag  当前 RN 页面的唯一标识
+ *
+ */
+RCT_EXPORT_METHOD(saveRootViewProperties:(NSInteger)reactTag
+                  clickable:(BOOL)clickable
+                  parameters:(NSDictionary *)paramters
+                  rootTag:(NSInteger) rootTag) {
+    @try {
+        [[QuickTrackingSDKManager sharedInstance] prepareView:@(reactTag) clickable:clickable paramters:paramters rootTag:@(rootTag)];
+    } @catch (NSException *exception) {
+        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
+    }
+}
 
-RCT_EXPORT_MODULE(QuicktrackingAnalyticsModule)
 //======================================页面事件相关===========================================//
 //页面启动事件，在该页面展示时调用
 RCT_EXPORT_METHOD(onPageStart:(NSString *)pageName)
@@ -99,18 +192,6 @@ RCT_EXPORT_METHOD(onEvent:(NSString *)eventId)
   [QTMobClick event:eventId];
 }
 
-RCT_EXPORT_METHOD(onEventWithParamsAndCount:(NSString *)eventId parameters:(NSDictionary *)parameters eventNum:(int)eventNum)
-{
-  if (eventId == nil || [eventId isKindOfClass:[NSNull class]]) {
-      return;
-  }
-  if (parameters == nil && [parameters isKindOfClass:[NSNull class]]) {
-      parameters = nil;
-  }
-
-  [QTMobClick event:eventId attributes:parameters counter:eventNum];
-}
-
 RCT_EXPORT_METHOD(onEventForH5:(NSString*)eventId attributes:(NSDictionary *)attributes) {
 
   Class _MobClickEvent = NSClassFromString(@"QTMobClickEvent");
@@ -133,108 +214,61 @@ RCT_EXPORT_METHOD(onEventAutoCLK:(NSInteger)reactTag) {
   }
 }
 
-//======================================全局属性相关===========================================//
-RCT_EXPORT_METHOD(registerGlobalProperty:(NSDictionary*)globalproperty)
+//======================================初始化相关===========================================//
+// 设置收数域名
+RCT_EXPORT_METHOD(setTrackDomain:(NSString *)mainTrackDomain subTrackDomain:(NSString *)secondaryDomain)
 {
-    if (globalproperty == nil && [globalproperty isKindOfClass:[NSNull class]]) {
-        globalproperty = nil;
-    }
-    [QTMobClick registerGlobalProperty:globalproperty];
+    dispatch_async(dispatch_get_main_queue(), ^{
+        [QTConfigure setCustomDomain:mainTrackDomain standbyDomain:secondaryDomain];
+    });
 }
 
-RCT_EXPORT_METHOD(clearGlobalProperties)
+// !!! SDK 初始化方法，必须在其他方法调用之前调用，否则其他方法调用无效
+// 并且 1. 调用初始化方法之前必须调用 setTrackDomain 方法，设置SDK 收数域名
+// 2. 调用初始化方法必须要在应用主线程中完成
+// 3. 调用SDK初始化方法必须在主线程中调用，否则会报错
+// 4. 请在隐私授权同意后才能调用初始化方法
+RCT_EXPORT_METHOD(initWithAppkey:(NSString *)appKey channel:(NSString *)channel)
 {
-    [QTMobClick clearGlobalProperties];
+    dispatch_async(dispatch_get_main_queue(), ^{
+        [QTConfigure initWithAppkey:appKey channel:channel];
+    });
 }
 
-RCT_EXPORT_METHOD(getGlobalProperty:(NSString*)propertyName resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
-    if (propertyName == nil || [propertyName isKindOfClass:[NSNull class]]) {
-        return;
-    }
-    @try {
-        NSString* property = [QTMobClick getGlobalProperty:propertyName];
-        resolve(property);
-    } @catch (NSException *exception) {
-        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
-    }
-}
-
-RCT_EXPORT_METHOD(unregisterGlobalProperty:(NSString*)propertyName)
+//======================================其他方法===========================================//
+// 开启日志
+RCT_EXPORT_METHOD(enableLog:(BOOL)enable)
 {
-    if (propertyName == nil && [propertyName isKindOfClass:[NSNull class]]) {
-        propertyName = nil;
-    }
-    [QTMobClick unregisterGlobalProperty:propertyName];
-}
-
-RCT_EXPORT_METHOD(getGlobalProperties:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject) {
-    @try {
-        NSDictionary* dict = [QTMobClick getGlobalProperties];
-        resolve(dict);
-    } @catch (NSException *exception) {
-        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
-    }
+#if __has_include(<UMCommonLog/UMCommonLogHeaders.h>)
+    [UMCommonLogManager setUpUMCommonLogManager];
+#endif
+    [QTConfigure setLogEnabled:enable];
 }
-
-// RCT_EXPORT_METHOD(preInit:(NSString*)appKey)
-// {
-//     [QTMobClick preInit:appKey];
-// }
-
-RCT_EXPORT_METHOD(initWithAppkey:(NSString *)appKey channel:(NSString *)channel)
+// 设置应用版本号
+RCT_EXPORT_METHOD(setAppVersion:(NSString *)appVersion)
 {
-    [QTConfigure initWithAppkey:appKey channel:channel];
+    [QTConfigure setAppVersion:appVersion];
 }
-
-//======================================用户账号和用户属性相关===========================================//
-RCT_EXPORT_METHOD(profileSignIn:(NSString*)puid provider:(NSString*)provider)
+// 关闭SDK
+RCT_EXPORT_METHOD(disableSDK)
 {
-    if (puid == nil || [puid isKindOfClass:[NSNull class]]) {
-        return;
-    }
-    if (provider == nil || [provider isKindOfClass:[NSNull class]]) {
-        [QTMobClick profileSignInWithPUID:puid];
-    } else {
-        [QTMobClick profileSignInWithPUID:puid provider:provider];
-    }
+    [QTConfigure disableSDK];
 }
-
-RCT_EXPORT_METHOD(profileSignOff)
+// 开启SDK
+RCT_EXPORT_METHOD(enableSDK)
 {
-    [QTMobClick profileSignOff];
+    [QTConfigure enableSDK];
 }
 
-/**
- * React Native 保存可点击控件列表信息
- *
- */
-RCT_EXPORT_METHOD(saveViewProperties:(NSInteger)reactTag
-                  clickable:(BOOL)clickable parameters:(NSDictionary *)paramters) {
-    @try {
-        [[QuickTrackingSDKManager sharedInstance] prepareView:@(reactTag) clickable:clickable paramters:paramters];
-    } @catch (NSException *exception) {
-        NSLog(@"[QuickTracking ReactNative] error: %@", exception);
-    }
+// 设置自定义设备ID
+RCT_EXPORT_METHOD(setCustomDeviceId:(NSString *)deviceId)
+{
+    [QTConfigure setCustomDeviceId:deviceId];
 }
 
-/**
- * React Native 保存可点击控件列表信息
- *
- * @param reactTag  当前控件唯一标识符
- * @param clickable  当前控件可点击状态
- * @param paramters  当前控件自定义参数
- * @param rootTag  当前 RN 页面的唯一标识
- *
- */
-RCT_EXPORT_METHOD(saveRootViewProperties:(NSInteger)reactTag
-                  clickable:(BOOL)clickable
-                  parameters:(NSDictionary *)paramters
-                  rootTag:(NSInteger) rootTag) {
-    @try {
-        [[QuickTrackingSDKManager sharedInstance] prepareView:@(reactTag) clickable:clickable paramters:paramters rootTag:@(rootTag)];
-    } @catch (NSException *exception) {
-        NSLog(@"[QuickTracking ReactNative] error:%@",exception);
-    }
+// 获取设备ID
+RCT_EXPORT_METHOD(getDeviceId:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+{
+    resolve([QTConfigure umidString]);
 }
-
 @end