GrowingIO uni-app x Autotracker Demo

介绍

本仓库是 gio-uniappx-autotracker 的 demo 工程，仓库根目录就是可以直接用 HBuilderX 打开的 uni-app x 示例项目。

SDK 本体不放在仓库根目录，而是以 uni_modules 集成包形态内置在：

uni_modules/gio-uniappx-autotracker

这样的目录结构是为了方便开发、调试和验证 SDK：你可以直接运行根目录 demo，观察 SDK 在 Web、Android App、iOS App、HarmonyOS App 和微信小程序上的初始化、生命周期采集、事件上报、用户身份、ABTest 和分享采集效果。业务工程正式接入时，只需要使用 uni_modules/gio-uniappx-autotracker 这个 SDK 包。

SDK 文档

SDK 的接入方式、初始化参数、API 和插件说明请看包内文档，根 README 不重复展开 SDK 细节：

文档	说明
SDK 使用指南	SDK 能力概览、平台范围和文档导航
集成与初始化配置	如何把 SDK 放进业务工程、如何初始化和验证
数据采集 API	自定义事件、用户身份、用户属性、动态开关、地理位置
无埋点	无埋点的接入、标记和采集边界
ABTest	ABTest 的注册、变量读取和缓存行为
功能插件总览	全部插件及微信小程序分享采集

SDK 包入口 README：

• uni_modules/gio-uniappx-autotracker/README.md

Demo 工程

根目录 demo 主要用于 SDK 开发和联调，包含最小初始化、常用 API 页面、ABTest 页面和微信小程序分享采集示例。无埋点相关用例统一收在 pages/autotrack/autotrack：可在同一页连续验证点击/变更事件、element 字段、忽略规则、方法引用、官方值组件、list-view、image 与 navigator。

运行要求：

• SDK（包括无埋点）以及包含 uni-link-x 与 App picker 示例的根目录 demo，均需使用 HBuilderX / uni-app x 5.08 或更高版本打开和编译。
• SDK 发布包只包含 uni_modules/gio-uniappx-autotracker，不包含根目录 demo 和 uni-link-x / uts-openSchema 示例依赖；业务工程接入 SDK 时以 SDK 包内 package.json 声明的版本范围为准。

打开 demo：

npm run demo:open

这条命令等价于：

open -a HBuilderX .

打开后，在 HBuilderX 里选择目标平台运行或编译：

• web
• mp-weixin
• app-android
• app-ios
• app-harmony

demo 的初始化入口在 main.uts，页面示例在 pages。如果你只是想了解 SDK 如何集成到业务工程，请优先阅读上面的 SDK 文档，而不是从 demo 页面反推完整用法。

目录说明

.
├── App.uvue                         # demo 应用入口
├── main.uts                         # demo 初始化入口
├── pages/                           # demo 页面
├── uni_modules/
│   └── gio-uniappx-autotracker/     # SDK 集成包
├── scripts/
│   ├── check-demo.mjs               # demo 源码与平台目录检查
│   └── release-sdk.mjs              # SDK 发布包检查与打包脚本
└── docs/                            # SDK 设计和内部实现文档

docs/ 目录主要面向 SDK 维护者，用于记录设计、协议和实现细节。普通 SDK 使用者请从 uni_modules/gio-uniappx-autotracker/docs/README.md 开始阅读。

获取 SDK 包

业务工程接入时，使用完整的 SDK 包目录：

uni_modules/gio-uniappx-autotracker

你可以从 GitHub Release 下载发布包，或从本仓库复制该目录到业务工程的 uni_modules/ 下。

本地打包检查

维护 SDK 或准备发布前，可以在仓库根目录执行：

npm run demo:check
npm run sdk:check
npm run sdk:release

demo:check 会检查 demo 与 SDK 的关键平台目录；sdk:check 会检查 SDK 包结构和关键入口是否齐全。sdk:release 会生成发布包：

dist/release/gio-uniappx-autotracker-<version>.tgz

发布包只包含 uni_modules/gio-uniappx-autotracker，不会包含根目录 demo 工程。

发布

发布前先确认 uni_modules/gio-uniappx-autotracker/package.json 里的 version 已更新，并且本地检查通过：

npm run sdk:check
npm run sdk:release

推送 v<version> 格式的 tag 到 origin 后，GitHub Actions 会自动生成 SDK 发布包并上传到对应的 GitHub Release。事件中的 sdkVersion 会在初始化时直接读取 SDK package.json 的 version；sdk:check 会校验这条版本注入链路没有被破坏。tag 版本必须和 SDK package.json 版本一致，例如当前 1.0.0 对应：

git tag v1.0.0
git push origin v1.0.0

开源说明

GrowingIO uni-app x Autotracker Lite 用于演示和验证 uni-app x 场景下的基础采集 SDK 能力。请在接入前阅读 SDK 文档，并根据你的业务工程平台范围完成真实编译和上报验证。