更新记录

1.0.0（2026-11-10）

• 首次发布
• 基于腾讯 VasDolly com.tencent.vasdolly:helper:3.0.4 实现渠道号读取
• 提供同步 API getChannel(): string，v2 签名块优先、自动回退 v1 ZIP 注释区
• 读取异常统一兜底为空字符串，不影响宿主 App

平台兼容性

uni-app(4.72)

uni-app x(4.72)

zy-tencent-helper

读取腾讯 VasDolly 多渠道打包方案写入安装包的渠道号（Android）。

基于官方运行时库 com.tencent.vasdolly:helper:3.0.4，即文档中给出的：

String channel = ChannelReaderUtil.getChannel(getApplicationContext());

功能特性

• 同步返回渠道号，无需回调，可在 onLaunch 中直接取值上报
• v2 签名块（APK Signing Block 的 ID-Value）优先，读不到自动回退 v1（ZIP 注释区）
• 官方库自带内存缓存，重复调用不会重复读盘
• 读取异常（安装包路径异常、解析失败等）就地兜底，统一返回空字符串，不会让宿主 App 崩溃
• 无需任何权限
• 仅支持 Android

安装方式

在 HBuilderX 中，右键点击项目目录，选择「从插件市场安装插件」，搜索 zy-tencent-helper 并安装。

由于插件含原生 Kotlin 代码与 maven 依赖，需要自定义基座或云打包后才能运行，标准基座不可用。

使用方法

导入插件

import { getChannel } from '@/uni_modules/zy-tencent-helper'

读取渠道号

const channel = getChannel()
if (channel !== '') {
  console.log('当前渠道：', channel)
  // 上报渠道数据
} else {
  console.log('当前安装包未写入渠道信息')
}

建议：启动时读取一次并缓存

// App.vue
import { getChannel } from '@/uni_modules/zy-tencent-helper'

export default {
  onLaunch() {
    const channel = getChannel()
    uni.setStorageSync('app_channel', channel)
  }
}

API 说明

getChannel(): string

读取当前安装包的渠道号。

参数： 无

返回值：

注意：

• 只有在云打包 / 自定义基座且用 VasDolly 拆分过渠道的安装包上才能读到渠道号；直接在 HBuilderX 运行的调试包一定返回空字符串。
• 该方法为同步调用（内部读安装包文件），不要在 v-for、滚动回调等高频路径里反复调用；官方库虽有缓存，仍建议启动时取一次存起来。

渠道包是如何写入的

渠道信息由 VasDolly 的 Gradle 插件在打包后写入 APK 的签名块（v2）或 ZIP 注释区（v1），本插件只负责读取，不参与写入。

支持平台

依赖

• com.tencent.vasdolly:helper:3.0.4（Maven Central，自动带入 reader、common）

许可证

MIT