ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocos2d-x.md

@@ -0,0 +1,311 @@
+---
+code: cocos2d-x_sdk_installation
+name: "Cocos2d-x"
+wikiToken: RZ1DwICXOiehIZkqI8hckoPbn0e
+parentWikiToken: BAU2w0eipiqGnckeUsIc0mYQnZc
+updateTime: 1770184507000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d-x_sdk_installation
+---
+# Cocos2d-x
+
+::: tip 提示
+
+ 在接入前, 请先阅读接入前准备。
+
+Cocos2d-x SDK 支持在iOS、Android、Mac、Windows平台运行，大小约为 6.8M
+
+ :::
+
+**最新版本:** v2.0.4
+
+**更新时间:** 2026-02-04
+
+**资源下载: **源码、SDK下载
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 Cocos2d-x 接入指南（V1），SDK下载（v1.3.5）
+
+::: 
+
+### 一、集成SDK
+
+1. 下载 Cocos2d-x SDK 资源文件，解压文件，把 ThinkingAnalytics 文件夹放入 Classes 文件夹
+1. `CMakeLists.txt` 添加如下配置
+```
+list(APPEND GAME_SOURCE
+     Classes/ThinkingAnalytics/Common/TDJSONObject.cpp
+     )
+list(APPEND GAME_HEADER
+     Classes/ThinkingAnalytics/Common/TDJSONObject.h
+     Classes/ThinkingAnalytics/Common/TDAnalytics.h
+     )
+if(ANDROID)
+    list(APPEND GAME_SOURCE
+         Classes/ThinkingAnalytics/Android/TDAnalytics.cpp
+         )
+elseif(WINDOWS)
+    list(APPEND GAME_HEADER
+         Classes/ThinkingAnalytics/Other/ThinkingSDKObject.h
+         )
+    list(APPEND GAME_SOURCE
+         Classes/ThinkingAnalytics/Other/TDAnalytics.cpp
+         )
+elseif(MACOSX)
+    list(APPEND GAME_HEADER
+        Classes/ThinkingAnalytics/Other/ThinkingSDKObject.h
+        )
+    list(APPEND GAME_SOURCE
+        Classes/ThinkingAnalytics/Other/TDAnalytics.cpp
+        )
+```
+
+1. 添加 Android 端配置
+- 在 proj.android 中的 app 目录下添加 libs 文件夹，把 TDAnalytics.aar、TDCore.aar、TDThirdparty.aar 拷贝到 libs 文件夹
+- 在 proj.android 中的 app/src 目录下逐级添加 cn/thinkingdata/analytics 文件夹，把 TDAnalyticsCocosAPI.java 拷贝到 cn/thinkingdata/analytics 文件夹
+- proj.android中app 目录下的 build.gradle 添加如下配置
+```
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
+}
+```
+
+1. 添加 iOS 端配置
+通过ios.toolchain.cmake工具来编译iOS工程
+
+- 在`CMakeLists.txt`中增加iOS相关配置
+```
+list(APPEND GAME_SOURCE
+     Classes/ThinkingAnalytics/Common/TDJSONObject.cpp
+     )
+list(APPEND GAME_HEADER
+     Classes/ThinkingAnalytics/Common/TDJSONObject.h
+     Classes/ThinkingAnalytics/Common/TDAnalytics.h
+     )
+if(ANDROID)
+    list(APPEND GAME_SOURCE
+         Classes/ThinkingAnalytics/Android/TDAnalytics.cpp
+         )
+elseif(WINDOWS)
+    list(APPEND GAME_HEADER
+         Classes/ThinkingAnalytics/Other/ThinkingSDKObject.h
+         )
+    list(APPEND GAME_SOURCE
+         Classes/ThinkingAnalytics/Other/TDAnalytics.cpp
+         )
+elseif(IOS)
+    //iOS配置
+    list(APPEND GAME_HEADER
+         Classes/ThinkingAnalytics/iOS/TDAnalyticsCocosAPI.h
+         )
+    list(APPEND GAME_SOURCE
+         Classes/ThinkingAnalytics/iOS/TDAnalytics.mm
+         Classes/ThinkingAnalytics/iOS/TDAnalyticsCocosAPI.m
+         )    
+elseif(MACOSX)
+    list(APPEND GAME_HEADER
+        Classes/ThinkingAnalytics/Other/ThinkingSDKObject.h
+        )
+    list(APPEND GAME_SOURCE
+        Classes/ThinkingAnalytics/Other/TDAnalytics.cpp
+        )
+        
+if(IOS)
+    //iOS配置
+    set(CMAKE_EXE_LINKER_FLAGS -ObjC)
+endif()       
+```
+
+- 使用Xcode打开iOS项目，直接拖拽 ThinkingAnalytics 下面的 iOS 文件夹下的`ThinkingSDK.framework` 和`TAThirdParty.framework`放到指定Xcode项目的Classes/ThinkingAnalytics/iOS 目录下，如下图所示
+- 配置完成，如果低于2.0.2的版本，需要手动修改一下Classes/ThinkingAnalytics/iOS/TDAnalyticsCocosAPI.m 的头文件引入
+```
+#import "ThinkingAnalyticsSDK.h"
+//改为下面的
+#import <ThinkingSDK/ThinkingSDK.h>
+```
+
+1. 直接打开proj.ios_mac中的Xcode工程
+- 使用 Xcode 打开 iOS 项目，直接拖拽 ThinkingAnalytics下面的Common和iOS文件夹放入Xcode工程的Classes目录下，如下图所示
+- `Build Setting` -> `Other Linker Flags` 中的添加 `-ObjC`
+- 在 `Build Setting` - `Framework Search Paths` 中添加
+"$(SRCROOT)/../Classes/ThinkingAnalytics/iOS"
+
+- `Build Phases` - `Link Binary With Libraries`
+WebKit.framework, GameController.framework, MediaPlayer.framework
+
+- 配置完成，如果低于2.0.2的版本，需要手动修改一下Classes/ThinkingAnalytics/iOS/TDAnalyticsCocosAPI.m 的头文件引入
+```
+#import "ThinkingAnalyticsSDK.h"
+//改为下面的
+#import <ThinkingSDK/ThinkingSDK.h>
+```
+
+### 二、初始化
+
+```
+#include "./ThinkingAnalytics/Common/TDAnalytics.h"
+using namespace thinkingdata::analytics;
+// 在主线程中初始化 SDK 
+//方式一
+TDAnalytics::init(TA_APP_ID, TA_SERVER_URL);
+//方式二
+TDConfig config(TA_APP_ID, TA_SERVER_URL);
+TDAnalytics::init(config);
+```
+
+参数说明:
+
+- `APPID`: 是您的项目的 APPID，可通过在 AE 后台项目管理页面获取
+- `SERVER_URL`: 为数据上传的 URL
+- 如果您对接的是云服务，填入: https://global-receiver-ta.thinkingdata.cn
+- 如果您使用私有化部署版本，请为数据采集地址绑定域名，并配置 HTTPS 证书：https://数据采集地址绑定域名
+<!-- unsupported block: 34 -->
+
+由于 Android 9.0+ 默认限制 HTTP 请求，因此请务必使用 HTTPS 协议
+
+### 三、常用功能
+
+在使用常用功能之前，建议你先了解用户识别规则；SDK 默认会生成随机数作为访客ID，并持久化存储访客ID在本地；用户未登录之前，会以访客ID作为身份识别ID。注意:访客 ID 在用户重新安装 App 以及更换设备时将会变更。
+
+#### 3.1 设置账号ID
+
+在用户进行登录时，可调用 `Login` 来设置用户的账号 ID， AE 平台将会以账号 ID 作为身份识别 ID，并且设置的账号 ID 将会在调用 `Logout` 之前一直保留。多次调用 `Login` 将覆盖先前的账号 ID 。
+
+```
+// 用户的登录唯一标识，此数据对应上报数据里的#account_id，此时#account_id的值为TA
+TDAnalytics::login("TA");
+```
+
+`Login` 可以多次调用，每次调用会判断传入的账号 ID 与先前保存的 ID 是否一致，一致则忽略调用，不一致则会覆盖先前的 ID。
+
+<!-- unsupported block: 34 -->
+
+**该方法不会上传登录事件**
+
+#### 3.2 设置公共事件属性
+
+公共事件属性指的就是每个事件都会带有的属性，您可以调用 `setSuperProperties` 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。对于一些重要的属性，譬如用户的会员等级、来源渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。
+
+```
+TDJSONObject superProperties;
+superProperties.setString("channel", "ta");//字符串
+superProperties.setNumber("age",1);//数字
+superProperties.setBool("isSuccess",true);//布尔
+superProperties.setDateTime("birthday","2020-01-02 10:52:52.290");//时间
+
+TDJSONObject object;
+object.setString("key", "value");
+superProperties.setJsonObject("object", object);// 对象
+
+TDJSONObject object1;
+object1.setString("key", "value");
+vector<TDJSONObject> arr;  
+arr.push_back(object1);
+superProperties.setList("object_arr", arr); // 对象组
+
+vector<string> arr1;
+arr1.push_back("value");
+superProperties.setList("arr",arr1);//数组
+
+TDAnalytics::setSuperProperties(superProperties);
+```
+
+公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果调用 `setSuperProperties` 上传了先前已设置过的公共事件属性，则会覆盖之前的属性。
+
+- 事件属性是 `TDJSONObject` 类型，其中每个元素代表一个属性
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感，AE 会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**事件属性、用户属性的要求与公共事件属性保持一致**
+
+#### 3.3 开启自动采集
+
+以下代码示例开启安装、启动、关闭事件，如果您想详细了解SDK的自动采集能力，可以查看自动采集功能详细介绍
+
+```
+// 开启自动采集
+TDAnalytics::enableAutoTrack();
+```
+
+#### 3.4 发送事件
+
+ 您可以调用 `Track` 来上传事件，建议您根据先前梳理的埋点文档来设置事件的属性以及发送信息的条件，此处以用户购买某商品作为范例：
+
+```
+TDJSONObject eventProperties;
+eventProperties.setString("product_name", "商品名");
+TDAnalytics::track("product_buy", eventProperties);
+```
+
+事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+
+#### 3.5 设置用户属性
+
+对于一般的用户属性，您可以调用 `userSet` 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+//此时username为TA
+TDJSONObject properties;
+properties.setString("username", "TA");
+TDAnalytics::userSet(properties);
+//此时userName为TE
+TDJSONObject newProperties;
+newProperties.setString("username", "TE");
+TDAnalytics::userSet(newProperties);
+```
+
+<!-- unsupported block: 34 -->
+
+属性格式要求与事件属性保持一致。
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+#include "./ThinkingAnalytics/Common/TDAnalytics.h"
+using namespace thinkingdata::analytics;
+
+if (授权隐私政策) {
+      //初始化SDK
+      TDAnalytics::init(TA_APP_ID, TA_SERVER_URL);
+      
+      //开启自动采集事件
+      TDAnalytics::enableAutoTrack();
+      //如果用户已登录，可以设置用户的账号ID作为身份唯一标识
+      TDAnalytics::login("TA");
+      
+      //设置公共事件属性以后，每个事件都会带有公共事件属性
+      TDJSONObject superProperties;
+      superProperties.setString("channel", "ta");//字符串
+      superProperties.setNumber("age",1);//数字
+      superProperties.setBool("isSuccess",true);//布尔
+      superProperties.setDateTime("birthday","2020-01-02 10:52:52.290");//时间
+
+      TDJSONObject object;
+      object.setString("key", "value");
+      superProperties.setJsonObject("object", object);// 对象
+
+      TDJSONObject object1;
+      object1.setString("key", "value");
+      vector<TDJSONObject> arr;  
+      arr.push_back(object1);
+      superProperties.setList("object_arr", arr); // 对象组
+
+      vector<string> arr1;
+      arr1.push_back("value");
+      superProperties.setList("arr",arr1);//数组
+      TDAnalytics::setSuperProperties(superProperties);
+      
+      //发送事件
+      TDJSONObject eventProperties;
+      eventProperties.setString("product_name", "商品名");
+      TDAnalytics::track("product_buy",eventProperties);
+      
+      //设置用户属性
+      TDJSONObject userProperties;
+      userProperties.setString("username", "TE");
+      TDAnalytics::userSet(userProperties);
+}
+```

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocoscreator//345/220/210/350/247/204/346/214/207/345/215/227.md

@@ -0,0 +1,42 @@
+---
+code: cocoscreator_sdk_compliance
+name: "合规指南"
+wikiToken: DbV2w1aQYi8QlgkNONscfjQvnPh
+parentWikiToken: MLL7wtab3ivQNYk3TDJcbjJRnRd
+updateTime: 1763019508000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocoscreator_sdk_compliance
+---
+# 合规指南
+
+### 一. 隐私政策中填写 SDK 相关内容
+
+#### 1.1 收集和获取
+
+在《隐私政策》中收集和获得您的个人信息栏目中根据实际情况填写以下内容。
+
+当您在激活使用时，我们会通过TDAnalytics-SDK收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）用于统计分析您在 App 内的使用效果。
+
+#### 1.2 与授权合作伙伴共享
+
+在《隐私政策》中的与授权合作伙伴共享栏目中根据实际情况填写以下内容。
+
+TDAnalytics-SDK：收集您的设备信息（IDFV、AndroidID、操作系统、设备型号、设备制造商、系统版本、应用进程信息等）、联网信息用于数据分析，从而改进我们的产品和服务。
+
+### 二. SDK合规步骤
+
+TDAnalytics SDK 需要您确保用户在同意 《隐私政策》后初始化SDK
+
+```
+-- 根据隐私协议判断是否开启数据采集
+if (授权隐私政策) {
+  var config = {
+    appId: "YOUR_APPID",
+    serverUrl: "YOUR_SERVER_URL",
+    autoTrack: {
+      appShow: true,
+      appHide: true
+    }
+  };
+  TDAnalytics.init(config);
+}
+```

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocoscreator//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,184 @@
+---
+code: cocoscreator_sdk_release_note
+name: "更新日志"
+wikiToken: BZ4IwjVvjiI4C1kvC8hcSYGfnch
+parentWikiToken: MLL7wtab3ivQNYk3TDJcbjJRnRd
+updateTime: 1773027622000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocoscreator_sdk_release_note
+---
+# 更新日志
+
+### v3.5.0
+
+**更新时间:  2026/03/09 ****下载**
+
+**更新内容：**
+
+- native层支持时间戳校准和自动时间校准
+- android、iOS支持自定义时区
+- 鸿蒙兼容2.+和3.+版本
+- 已知问题修复
+### v3.4.2
+
+**更新时间:  2025/12/10 ****下载**
+
+**更新内容：**
+
+- 支持首个自动采集事件带上账号、访客、静态公共属性
+### v3.4.1
+
+**更新时间:  2025/11/20 ****下载**
+
+**更新内容：**
+
+- 升级Android、iOS SDK
+- 修复打包淘宝小游戏报错问题
+### v3.3.2
+
+**更新时间:  2025/08/13 ****下载**
+
+**更新内容：**
+
+- 支持淘宝小游戏平台
+### v3.3.0
+
+**更新时间:  2025/06/06 ****下载**
+
+**更新内容：**
+
+- 修复安卓平台不配置自动采集运行报错问题
+- 支持鸿蒙平台
+### v3.2.1
+
+**更新时间:  2025/05/21 ****下载**
+
+**更新内容：**
+
+- 已知问题修复
+### v3.0.3
+
+**更新时间:  2024/05/13 ****下载**
+
+**更新内容：**
+
+- 修复弱网条件数据丢失的问题
+- 支持自定义时区
+### v3.0.2
+
+**更新时间:  2024/02/09 ****下载**
+
+**更新内容：**
+
+- 重构batch模式发送数据
+### v3.0.1
+
+**更新时间:  2023/11/24 ****下载**
+
+**更新内容：**
+
+- 代码优化 
+### v3.0.0
+
+**更新时间:  2023/08/28 ****下载**
+
+**更新内容：**
+
+- 代码优化 
+### v2.2.4
+
+**更新时间:  2023/07/28 ****下载**
+
+**更新内容：**
+
+- 代码优化 
+### v2.2.0 
+
+**更新时间:  2022/08/15**
+
+**更新内容：**
+
+- 新增支持事件缓存 
+- 代码优化 
+### v2.1.0 
+
+**更新时间:  2022/06/28**
+
+**更新内容：**
+
+- 新增支持去重追加用户属性
+- Web平台支持ta_page_show/ta_page_hide事件
+- 新增支持数据加密上报
+- 代码优化
+### v2.0.3
+
+**更新时间:  2022/02/21**
+
+**更新内容：**
+
+- 自动采集事件支持自定义属性
+- 代码优化
+### v2.0.2
+
+**更新时间:  2021/12/31**
+
+**更新内容：**
+
+- 支持趣头条、Facebook、GooglePlay等小游戏
+- 代码优化
+### v2.0.1 
+
+**更新时间:  2021/11/15**
+
+**更新内容：**
+
+- 代码优化
+- 支持复杂数据类型
+### v2.0.0
+
+**更新时间:  2021/09/15**
+
+**更新内容：**
+
+- 支持 iOS/Android Native
+- 支持暂停/开始、停止/恢复数据上报
+- 支持事件黑名单
+- 代码优化
+### v1.8.2
+
+**更新时间:  2021/06/24**
+
+**更新内容：**
+
+- 支持预置属性获取
+- fix bug:原生/web平台运行时，断网重连导致的数据发送失败问题
+### v1.8.0
+
+**更新时间:  2020/11/20**
+
+**更新内容：**
+
+- 新增哔哩哔哩小游戏支持
+- 完善游戏引擎支持：支持 ts 项目接入
+- 完善游戏引擎支持：支持常见小游戏、快游戏平台(华为、小米、OPPO、VIVO)、H5 游戏
+- 其他代码细节层面的优化
+### v1.7.0
+
+**更新时间:  2020/08/24**
+
+**更新内容：**支持首次事件，可更新事件，可重写事件
+
+### v1.6.0
+
+**更新时间:  2020/06/10**
+
+**更新内容:**支持 debug 模式
+
+### v1.5.1
+
+**更新时间:  2020/03/21**
+
+**更新内容:**
+
+- 支持白鹭引擎小游戏平台：微信小游戏、百度小游戏、QQ 小游戏、VIVO 小游戏、OPPO 小游戏
+- 支持 LAYABOX 引擎小游戏平台：微信小游戏、百度小游戏、QQ 小游戏、VIVO 小游戏、OPPO 小游戏
+- 支持 CocosCreator 引擎小游戏平台：微信小游戏、百度小游戏、VIVO 小游戏、OPPO 小游戏

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk//346/270/270/346/210/217/345/274/225/346/223/216/cocoscreator//350/277/233/351/230/266/346/214/207/345/215/227/native/346/224/257/346/214/201.md

@@ -0,0 +1,142 @@
+---
+code: cocoscreator_sdk_native
+name: "Native支持"
+wikiToken: YyDnwL9tZiX37ukCSxJcxdTVnHa
+parentWikiToken: RvASwF6gWieCFIkqqRlchH0xnUg
+updateTime: 1763019462000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocoscreator_sdk_native
+---
+# Native支持
+
+### 一、iOS Native 支持
+
+首次构建 iOS 项目会生成工程代码到 `./build/ios/` 和 `./native/engine/ios/` 两个目录，然后开始配置 iOS 工程。
+
+#### **1.1 手动配置**
+
+- 添加 iOS 工程依赖文件 
+- `CocosCreatorProxyApi.h`
+- `CocosCreatorProxyApi.mm`
+- `ThinkingSDK.framework` 
+- `ThinkingDataCore.framework`
+- Build Phases 设置 
+- `Link Binary With Libraries` 添加 `ThinkingSDK.framework`
+- Build Settings 设置 
+- Framework Search Paths 添加 `ThinkingSDK.framework`的引用路径，如`"$(SRCROOT)/../Classes"`
+- `Other Linker Flags` 添加 `-ObjC`
+#### **1.2 CMakeList 配置**
+
+::: tip 提示：
+
+ `CMakeList` 文件路径为 `./native/engine/ios/CMakeLists.txt`；
+
+首次构建 iOS 项目之后会生成 `CMakeList` 文件，配置好之后再次构建时生效；
+
+需要先把 iOS 资源文件拷贝到对应文件夹，如 `./native/engine/common/Classes/ThinkingAnalytics/ios/` ，配置 `CMakeList` 时填写对应路径即可。
+
+ :::
+
+- 添加 iOS 工程依赖文件
+```
+# 找到这行代码 
+set(PROJ_COMMON_SOURCES
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/Game.h
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/Game.cpp
+    # 添加以下代码
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/CocosCreatorProxyApi.h
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/CocosCreatorProxyApi.mm
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/ThinkingSDK.framework
+    ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/ThinkingDataCore.framework
+)
+```
+
+- Build Phases 设置
+```
+# 找到这行代码 
+target_link_libraries(${LIB_NAME} cocos2d)
+# 添加以下代码
+target_link_libraries(${LIB_NAME} ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/ThinkingSDK.framework)
+target_link_libraries(${LIB_NAME} ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/ThinkingAnalytics/ios/ThinkingDataCore.framework)
+```
+
+- Build Settings 设置
+```
+# 找到这行代码
+set(PRODUCT_NAME ${APP_NAME})
+# 添加以下代码
+set(CMAKE_EXE_LINKER_FLAGS -ObjC)
+```
+
+::: warning 注意
+
+Cocos Creator v2.x 的编辑器暂不支持 `CMake` 配置方式，需要手动配置。
+
+:::
+
+### 二、 Android Native 支持
+
+构建 Android 项目工程, 配置 Android 工程。
+
+- 在 Android 显示模式的 app 工程中，把依赖文件 `CocosCreatorProxyApi.java` 加入到 `com.cocos.game` 中，如下图 
+- 在项目的 app 文件夹中的 proguard-rules.pro 文件中，添加混淆
+```
+-keep public class com.cocos.game.CocosCreatorProxyApi {*;}
+```
+
+- 在项目的 app 文件夹中新建 libs 目录，将 `TDAnalytics.aar`、`TDCore.aar` 拷贝到其中 
+- 在 `Module` 下的 `build.gradle` 文件中添加依赖项
+```
+dependencies {
+    ...
+    implementation fileTree(dir: 'libs', include: [**'*.aar'**])
+}
+```
+
+### 三、 OpenHarmony Native 支持
+
+首先构建OpenHarmony工程
+
+- 将TDAnalytics.har和CocosCreatorProxyApi.ts放到下面的目录中
+- 在oh-packages.json5文件中引入SDK
+```
+"@thinkingdata/analytics": "file:./libs/TDAnalytics.har"
+```
+
+- 在build-profile.json5引入桥接文件
+```
+arkOptions: {
+  runtimeOnly: {
+    sources: [
+      './src/main/ets/CocosCreatorProxyApi.ts',
+    ],
+  },
+}
+```
+
+- 引入context
+目前CocosCreator支持鸿蒙的第一个版本，交互是在work线程，暂时没有官方的api获取context，后续等官方更新，目前可以通过自己手动添加
+
+上面的操作是将context传递到work线程中，然后在SDK初始化的时候需要用
+
+如果有其他的方式去获取context，也可以自己修改CocosCreatorProxyApi.ts文件中的initWithConfig方法
+
+### 四、 开启 Native 支持
+
+初始化 SDK 时，在 `config` 中加入 `enableNative: true`，即可开启 Native 支持。
+
+```
+// TA SDK 配置对象
+var config = {
+   appId: "YOUR_APPID", // 项目 APP ID
+   serverUrl: "YOUR_SERVER_URL", // 上报地址
+   enableNative: true,// 允许调用 Native 代码
+   autoTrack: {
+      appShow: true, // 自动采集 启动事件
+      appHide: true, // 自动采集 关闭事件
+      appCrash: true, // 自动采集 崩溃事件（仅 native 生效）
+      appInstall: true // 自动采集 安装事件（仅 native 生效）
+   }
+};
+// 初始化
+TDAnalytics.init(config);
+```