更新记录

1.0.0（2026-06-05） 下载此版本

v1.0.0 发个版本大家有需要拿走即可

平台兼容性

uni-app x(5.06)

聚合赚

基于 uni-app x 开发的聚合任务变现应用，当前项目以 Android 端为主要落地平台，围绕“首页任务入口、福利签到、邀请收益、个人中心、提现与收益明细”等核心业务展开。

项目内已经接入多套广告/任务变现渠道插件，并统一通过 common 目录下的启动器进行封装，便于业务页面按统一方式拉起各渠道任务页。

项目特点

• 基于 uni-app x 与 uvue + UTS 开发
• 以 Android 端为主，集成多套原生变现 SDK
• 内置隐私授权弹窗与启动页隐私检查流程
• 支持 OAID / Android ID 设备标识采集与上报
• 支持首页任务聚合、福利签到、邀请收益、提现等业务能力
• 已适配自定义基座运行场景

主要业务模块

• pages/splash/splash：启动页与隐私授权检查
• pages/index/index：首页任务聚合入口
• pages/welfare/welfare：福利签到
• pages/invite/invite：邀请活动页
• pages/mine/mine：个人中心
• pages/mine/invitees：团队成员
• pages/mine/income-detail：收益明细
• pages/mine/withdraw：提现
• pages/mine/withdraw-record：提现记录
• pages/money-all/money-all：更多赚钱入口聚合

当前接入的广告 / 任务插件

项目已按统一命名整理为 uni_modules/ad-* 结构，当前包括：

• ad-youliang-sdk：亘元有量
• ad-ibx-sdk：爱变现
• ad-xiaowan-sdk：闲玩
• ad-quxuanshang-sdk：趣悬赏
• ad-maowan-sdk：猫玩
• ad-mogu-sdk：蘑菇星球
• ad-shanyou-sdk：闪游
• ad-duoliang-sdk：多量

这些插件统一通过 common 目录中的启动器封装后供页面使用：

• common/ad-youliang-sdk-launcher.uts
• common/ad-ibx-sdk-launcher.uts
• common/ad-xiaowan-sdk-launcher.uts
• common/ad-quxuanshang-sdk-launcher.uts
• common/ad-maowan-sdk-launcher.uts
• common/ad-mogu-sdk-launcher.uts
• common/ad-shanyou-sdk-launcher.uts
• common/ad-duoliang-sdk-launcher.uts

目录结构

juhe-app/
├─ common/                公共配置、设备信息、广告启动器
├─ components/            通用组件
├─ docs/                  项目文档
├─ hybrid/                H5 协议页等静态资源
├─ pages/                 业务页面
├─ static/                静态资源
├─ store/                 全局状态
├─ uni_modules/           UTS 插件与 uni_modules 模块
├─ App.uvue               应用入口
├─ main.uts               启动入口
├─ manifest.json          应用配置
├─ pages.json             页面与 tabBar 配置
└─ privacy.md             隐私相关说明

运行环境

建议环境：

• HBuilderX 5.07 或更高版本
• uni-app x
• Android 真机 / Android 自定义基座

项目当前包含多套原生 SDK，标准基座下无法完整验证所有变现插件能力，日常联调建议直接使用自定义基座。

开发与运行

1. 使用 HBuilderX 打开项目

直接使用 HBuilderX 打开项目根目录：

• juhe-app

2. 运行到 Android

推荐方式：

• 运行到 Android 自定义基座
• 或使用云端打自定义基座 / 自定义包

3. 调试重点

如果页面涉及广告 SDK、任务墙、下载、图片选择、微信能力、文件能力等原生依赖，请优先确认：

• 当前是否运行在自定义基座
• 对应 uni_modules/ad-* 依赖是否已被打入
• Android 控制台中是否存在类缺失或依赖未生效异常

隐私授权说明

项目已内置隐私授权启动流程：

• 启动页：pages/splash/splash
• 隐私弹窗页：pages/component/button/privacy

应用启动后会先检查隐私授权状态，未授权时会弹出隐私说明页。部分 SDK 在用户未同意隐私协议时不会初始化或不会拉起页面，因此涉及广告插件的功能联调前，请先确认隐私流程已通过。

设备标识说明

项目当前通过 yc-android-oaid 获取设备标识，并统一由以下文件对外提供：

• common/device-info.uts

设备标识使用优先级通常为：

1. OAID
2. Android ID
3. 本地设备 ID

多套广告插件都会依赖这些标识进行渠道归因或业务启动。

重要配置文件

• manifest.json
  • 应用名称、版本号、平台配置、自定义分发配置
• pages.json
  • 页面注册、tabBar、导航栏配置
• common/config.uts
  • 接口基础配置
• privacy.md
  • 隐私政策文本

自定义基座说明

由于项目集成了多套 Android 原生广告 / 任务插件，控制台中可能会出现类似提示：

uni_module [ad-xxx-sdk] (Android) 存在三方依赖或资源引用

这类提示通常不是源码错误，而是说明：

• 当前插件带有三方依赖或本地 AAR
• 需要通过自定义基座或自定义打包环境运行

插件文档

各广告插件都已补充独立说明文档，可直接查看：

• uni_modules/ad-youliang-sdk/readme.md
• uni_modules/ad-ibx-sdk/readme.md
• uni_modules/ad-xiaowan-sdk/readme.md
• uni_modules/ad-quxuanshang-sdk/readme.md
• uni_modules/ad-maowan-sdk/readme.md
• uni_modules/ad-mogu-sdk/readme.md
• uni_modules/ad-shanyou-sdk/readme.md
• uni_modules/ad-duoliang-sdk/readme.md

开发建议

• 优先通过 common/ad-*-sdk-launcher.uts 调用广告插件，不要在页面里重复直连模块
• 修改 uvue / uts 文件后，建议及时做 Android 语法或编译校验
• 涉及 SDK 依赖、AAR、config.json 修改后，重新制作并安装自定义基座
• 页面滚动区域在 App 端建议使用 scroll-view
• 使用 display: flex 时显式声明 flex-direction

已知说明

• 当前项目根 package.json 仍保留部分示例工程元数据，业务实际名称以 manifest.json 中的 聚合赚 为准
• Android 端是当前主要联调平台
• 部分渠道插件对最低 Android 版本有要求，联调前请查看各自 readme.md

后续维护建议

• 持续统一模块命名、日志前缀和启动器命名
• 发布插件市场前，完善各 uni_modules 的 package.json 声明信息
• 新增渠道插件时，优先沿用当前 ad-* 命名和 common/ad-*-sdk-launcher.uts 结构