feat: Android V4.3.2 (#342)

* v4.3.2 * Update Introduce.md
growingio · Oct 29, 2024 · 0d34012 · 0d34012
1 parent 790acc3
commit 0d34012
Show file tree

Hide file tree

Showing 18 changed files with 88 additions and 42 deletions.
diff --git a/docs/android/Configuration.md b/docs/android/Configuration.md
@@ -42,6 +42,8 @@ import TabItem from '@theme/TabItem';
 | enableFragmentTag [#](#3-enablefragmenttag) |    _boolean_    |   否    | `false`     | 是否将Fragment的tag作为无埋点路径的记号 |    |
 | setPageRuleXml [#](#4-setpagerulexml)       |    _int_        |   否        | `xml id`     | 用于自动采集无埋点页面 |  4.2.0  |
 | setAutotrack [#](#5-setautotrack)           |    _boolean_    |   否        | `true`     | 用于控制是否打开无埋点功能 |  4.3.0  |
+| setCustomEventWithPath [#](#6-setcustomeventwithpath)  |    _boolean_    |   否        | `false`  | 所有自定义事件将携带上一个 Page 事件的path |  4.3.2  |
+| setAutoJsSdkInject [#](#7-setautojssdkinject) |    _boolean_    |   否        | `false`  | 自动为所有内部Webview注入GrwoingIO Web Js |  4.3.2  |
 
 ## 通用配置说明
 
@@ -264,6 +266,8 @@ val sConfiguration = AutotrackConfiguration("Your AccountId", "Your URLScheme")
 GrowingAutotracker.startWithConfiguration(this, sConfiguration)
 ```
 
+> 如果想要快速设置采集App内部全部页面，可调用 `addPageMatchRule(".*")` 即可。
+
 ### 5. setAutotrack
 若是不需要无埋点相关功能，客户可以通过在初始化时关闭无埋点来实现。请注意，关闭无埋点功能后，无埋点事件包括页面事件，自动点击事件，Imp曝光事件不再上报以及圈选功能都将一起关闭。
 
@@ -274,3 +278,26 @@ GrowingAutotracker.startWithConfiguration(this,
         .setAutotrack(false)
 );
 ```
+
+### 6. setCustomEventWithPath
+打开该接口将会为每一个自定义事件添加上一个页面事件的路径属性，(即 `CustomEvent` 中增加 `path`)。建议在需要统计每一个自定义埋点事件发送页面时打开，平常状态下请关闭此配置。
+
+```java
+GrowingAutotracker.startWithConfiguration(this,
+        new AutotrackConfiguration("accountId", "urlScheme")
+        // 携带上一个 Page 事件的path路径
+        .setCustomEventWithPath(true)
+);
+```
+
+
+### 7. setAutoJsSdkInject
+在无埋点SDK初始化中设置：`setAutoJsSdkInject(true)` 时将会自动将 webjs sdk 加载至所有的webview中。如同时开启`WebViewBridge`，即可将webview上的埋点事件通过App上报。
+
+```java
+GrowingAutotracker.startWithConfiguration(this,
+        new AutotrackConfiguration("accountId", "urlScheme")
+        // 打开 webjs sdk 自动加载
+        .setAutoJsSdkInject(true)
+);
+```
diff --git a/docs/android/Introduce.md b/docs/android/Introduce.md
@@ -97,7 +97,7 @@ apply plugin: 'com.android.application'
 
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   //GrowingIO 无埋点 SDK
   implementation 'com.growingio.android:autotracker'
@@ -112,7 +112,7 @@ dependencies {
 apply plugin: 'com.android.application'
 
 dependencies {
-    implementation 'com.growingio.android:autotracker:4.3.1'
+    implementation 'com.growingio.android:autotracker:4.3.2'
 }
 ```
 

diff --git a/docs/android/PlatformBom.md b/docs/android/PlatformBom.md
@@ -17,7 +17,7 @@ title: 依赖清单BoM
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:tracker'
   implementation 'com.growingio.android:autotracker'
@@ -34,9 +34,9 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
-  implementation 'com.growingio.android:autotracker:4.3.1'
+  implementation 'com.growingio.android:autotracker:4.3.2'
 }
 ```
 </details>
@@ -73,7 +73,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation 'com.growingio.android:autotracker-bom:4.3.1'
+  implementation 'com.growingio.android:autotracker-bom:4.3.2'
 
   implementation 'com.growingio.android:autotracker'
 }

diff --git a/docs/android/modules/abtest module.md b/docs/android/modules/abtest module.md
@@ -31,7 +31,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:abtest:4.3.1'
+	implementation 'com.growingio.android:abtest:4.3.2'
 }
 ```
 </TabItem>
@@ -41,7 +41,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:abtest'
 }

diff --git a/docs/android/modules/adapter module.md b/docs/android/modules/adapter module.md
@@ -49,7 +49,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:analytics-fa'
   implementation 'com.growingio.android:analytics-ga'

diff --git a/docs/android/modules/advert module.md b/docs/android/modules/advert module.md
@@ -135,7 +135,7 @@ keytool -list -v -keystore release.keystore
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:ads:4.3.1'
+	implementation 'com.growingio.android:ads:4.3.2'
 }
 ```
 </TabItem>
@@ -145,7 +145,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:ads'
 }

diff --git a/docs/android/modules/circler module.md b/docs/android/modules/circler module.md
@@ -36,7 +36,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:circler:4.3.1'
+	implementation 'com.growingio.android:circler:4.3.2'
 }
 ```
 </TabItem>
@@ -46,7 +46,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:circler'
 }

diff --git a/docs/android/modules/core module.md b/docs/android/modules/core module.md
@@ -9,10 +9,10 @@ title: 核心模块
 
 | 名称           |                                        说明                                         | 依赖                                           |
 | :------------- | :---------------------------------------------------------------------------------: | :--------------------------------------------- |
-| 埋点 Library   |                          埋点核心库，包含最基本的埋点逻辑                           | `com.growingio.android:tracker-core:4.3.1`     |
-| 无埋点 Library |                无埋点核心库，依赖于埋点核心库，包含无埋点的注入逻辑                 | `com.growingio.android:autotracker-core:4.3.1` |
-| 模块注解库     | 注解声明，通过注解可以自动生成 SDK 的初始化类来注册所有的模块和聚合模块内的配置类。 | `com.growingio.android:annotation:4.3.1`       |
-| 注解解析器     |                                 与上面注解配合使用                                  | `com.growingio.android:compiler:4.3.1`         |
+| 埋点 Library   |                          埋点核心库，包含最基本的埋点逻辑                           | `com.growingio.android:tracker-core:4.3.2`     |
+| 无埋点 Library |                无埋点核心库，依赖于埋点核心库，包含无埋点的注入逻辑                 | `com.growingio.android:autotracker-core:4.3.2` |
+| 模块注解库     | 注解声明，通过注解可以自动生成 SDK 的初始化类来注册所有的模块和聚合模块内的配置类。 | `com.growingio.android:annotation:4.3.2`       |
+| 注解解析器     |                                 与上面注解配合使用                                  | `com.growingio.android:compiler:4.3.2`         |
 
 --------
 import Tabs from '@theme/Tabs';
@@ -37,7 +37,7 @@ SDK 事件通过 `EventDatabase` 来传递到数据库并进行增删改查的
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:database:4.3.1'
+	implementation 'com.growingio.android:database:4.3.2'
 }
 ```
 </TabItem>
@@ -47,7 +47,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:database'
 }
@@ -77,9 +77,9 @@ SDK 事件通过 `EventUrl` 指定请求方式、服务器请求地址，再通
 ```groovy
 dependencies {
 	// 网络模块-okhttp3
-	implementation 'com.growingio.android:okhttp3:4.3.1'
+	implementation 'com.growingio.android:okhttp3:4.3.2'
 	// 可选网络模块-urlconnnection
-	implementation 'com.growingio.android:urlconnnection:4.3.1'
+	implementation 'com.growingio.android:urlconnnection:4.3.2'
 }
 ```
 </TabItem>
@@ -89,7 +89,7 @@ dependencies {
 ```groovy
 dependencies {
 	// Import the BoM for the GrowingIO platform
-	implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+	implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   // 网络模块-okhttp3
 	implementation 'com.growingio.android:okhttp3'
@@ -118,7 +118,7 @@ dependencies {
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:protobuf:4.3.1'
+	implementation 'com.growingio.android:protobuf:4.3.2'
 }
 ```
 </TabItem>
@@ -128,7 +128,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:protobuf'
 }

diff --git a/docs/android/modules/debugger module.md b/docs/android/modules/debugger module.md
@@ -36,7 +36,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:debugger:4.3.1'
+	implementation 'com.growingio.android:debugger:4.3.2'
 }
 ```
 </TabItem>
@@ -46,7 +46,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:debugger'
 }

diff --git a/docs/android/modules/encoder module.md b/docs/android/modules/encoder module.md
@@ -34,7 +34,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:encoder:4.3.1'
+	implementation 'com.growingio.android:encoder:4.3.2'
 }
 ```
 </TabItem>
@@ -44,7 +44,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:encoder'
 }

diff --git a/docs/android/modules/flutter module.md b/docs/android/modules/flutter module.md
@@ -28,7 +28,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:flutter:4.3.1'
+	implementation 'com.growingio.android:flutter:4.3.2'
 }
 ```
 </TabItem>
@@ -38,7 +38,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:flutter'
 }

diff --git a/docs/android/modules/hybrid module.md b/docs/android/modules/hybrid module.md
@@ -37,7 +37,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:hybrid:4.3.1'
+	implementation 'com.growingio.android:hybrid:4.3.2'
 }
 ```
 </TabItem>
@@ -47,7 +47,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:hybrid'
 }

diff --git a/docs/android/modules/json module.md b/docs/android/modules/json module.md
@@ -32,7 +32,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:json:4.3.1'
+	implementation 'com.growingio.android:json:4.3.2'
 }
 ```
 </TabItem>
@@ -42,7 +42,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:json'
 }

diff --git a/docs/android/modules/oaid module.md b/docs/android/modules/oaid module.md
@@ -37,7 +37,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:oaid:4.3.1'
+	implementation 'com.growingio.android:oaid:4.3.2'
 }
 ```
 </TabItem>
@@ -47,7 +47,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:oaid'
 }

diff --git a/docs/android/modules/platform module.md b/docs/android/modules/platform module.md
@@ -34,7 +34,7 @@ import TabItem from '@theme/TabItem';
 
 ```groovy
 dependencies {
-	implementation 'com.growingio.android:platform:4.3.1'
+	implementation 'com.growingio.android:platform:4.3.2'
 }
 ```
 </TabItem>
@@ -44,7 +44,7 @@ dependencies {
 ```groovy
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   implementation 'com.growingio.android:platform'
 }

diff --git a/docs/android/upgrade/index.md b/docs/android/upgrade/index.md
@@ -18,7 +18,7 @@ import TabItem from '@theme/TabItem';
 
 在4.0新版本，CDP私有部署将会和SaaS一起合并至SDK中，原有的集成逻辑会做相应的更改，如：
 
-* 引入SDK `implementation 'com.growingio.android:autotracker-cdp:4.3.1'` 变更为 `implementation 'com.growingio.android:autotracker:4.3.1'`；
+* 引入SDK `implementation 'com.growingio.android:autotracker-cdp:4.3.2'` 变更为 `implementation 'com.growingio.android:autotracker:4.3.2'`；
 * 初始化配置由 `CdpAutotrackConfiguration` 变更为 `AutotrackConfiguration`。
 
 ## 关于老SaaS(2.0版本)
@@ -44,7 +44,7 @@ apply plugin: 'com.android.application'
 
 dependencies {
   // Import the BoM for the GrowingIO platform
-  implementation platform('com.growingio.android:autotracker-bom:4.3.1')
+  implementation platform('com.growingio.android:autotracker-bom:4.3.2')
 
   //GrowingIO 无埋点 SDK 适配版
   implementation 'com.growingio.android:autotracker-saas'
@@ -59,7 +59,7 @@ dependencies {
 apply plugin: 'com.android.application'
 
 dependencies {
-    implementation 'com.growingio.android:autotracker-saas:4.3.1'
+    implementation 'com.growingio.android:autotracker-saas:4.3.2'
 }
 ```