更新记录

1.0.9（2025-12-16）

一、更新iOS 云打包报错问题

1.0.8（2025-12-16）

一、冷启动参数获取的问题处理 二、android 冲突问题处理

1.0.7（2025-12-16）

一，打包报错问题处理

平台兼容性

uni-app(4.66)

uni-app x(4.66)

umeng-analytics-uts

友盟统计 UTS 插件，支持 Android 平台，提供统计分析和事件上报功能。

UTS环境兼容性

功能特性

• ✅ 友盟统计 SDK 初始化
• ✅ 深度链接获取（当前链接和安装链接）
• ✅ 自动从 AndroidManifest 读取配置初始化

安装使用

1. 导入插件

将 umeng-analytics-uts 目录放入项目的 uni_modules 目录；App 端支持 Android（iOS 暂不支持）。

2. 平台要求

• Android: 最低 SDK 版本 21 (Android 5.0+)
• HBuilderX: 3.6+ (uni-app) / 3.9+ (uni-app x)

3. 快速使用

// #ifdef APP-PLUS
import { getUmengAnalyticsClient } from '@/uni_modules/umeng-analytics-uts'
const analytics = getUmengAnalyticsClient()

// 初始化 SDK（必须在使用前调用）
analytics.initialize({
  appKey: 'YOUR_APP_KEY',
  channel: 'default'  // 可选，默认为 "default"
})

// 获取深度链接
const linkData = analytics.getLinkPath()
console.log('当前链接:', linkData.linkPath)
console.log('链接参数:', linkData.linkParams)

// 获取安装时的深度链接
analytics.getInstallLinkPath((result) => {
  console.log('安装链接:', result.linkPath)
  console.log('安装链接参数:', result.linkParams)
})
// #endif

API 文档

初始化

initialize(config)

初始化友盟统计 SDK（必须在使用前调用）。

参数说明：

• config: UmengAnalyticsConfig
  • appKey: string - 友盟 AppKey（必填）
  • channel?: string - 渠道标识（可选，默认为 "default"）

示例：

analytics.initialize({
  appKey: 'YOUR_APP_KEY',
  channel: 'google_play'
})

注意：

• 如果已在 AndroidManifest.xml 中配置了 UMENG_APPKEY 和 UMENG_CHANNEL，插件会在应用启动时自动初始化，无需手动调用 initialize()
• 如果手动调用 initialize()，会覆盖 AndroidManifest 中的配置

### 深度链接

#### getLinkPath()

获取当前深度链接路径（同步方法）。

**返回值：**
- `LinkPathResult` - 包含 `linkPath` 和 `linkParams` 的对象
  - `linkPath`: `string | null` - 深度链接路径
  - `linkParams`: `UTSJSONObject | null` - 深度链接参数

**示例：**
```typescript
const data = analytics.getLinkPath()
console.log(data.linkPath)
console.log(data.linkParams)

注意：

• 如果当前没有深度链接，linkPath 和 linkParams 都为 null
• 该方法从当前 Activity 的 Intent 中获取深度链接信息

getInstallLinkPath(callback)

获取安装时的深度链接路径（异步方法）。

参数说明：

• callback: LinkPathCallback - 回调函数
  • result.linkPath: string | null - 安装时的深度链接路径
  • result.linkParams: UTSJSONObject | null - 安装时的深度链接参数

示例：

analytics.getInstallLinkPath((result) => {
  console.log(result.linkPath)
  console.log(result.linkParams)
})

注意：

• 该方法返回应用安装时通过深度链接启动的链接信息
• 如果应用不是通过深度链接安装的，linkPath 和 linkParams 都为 null
• 安装链接信息会在应用首次启动时自动保存

使用示例

平台支持

依赖库

• Android:
  • com.umeng.umsdk:common:9.6.8 - 友盟统计基础库

参考资源

• 友盟+ 官方文档
• 友盟+ 开发者中心