更新记录

0.1.0（2026-06-02） 下载此版本

• 新增猫玩 Android SDK 插件文档
• 补充 README 接口、依赖、接入步骤与示例说明

平台兼容性

uni-app x(5.06)

ad-maowan-sdk

猫玩 Android SDK 的 uni-app x UTS 封装插件。

插件当前支持 SDK 初始化、打开首页、打开任务详情以及状态查询，适合用于 uni-app x 的 Android 任务变现接入场景。

适用范围

• uni-app x
• Android
• 需要自定义基座或自定义打包环境

对外接口

MWInitOptions

type MWInitOptions = {
  appId : string
  appSecret : string
  fileProviderAuthorities : string
}

MWOpenHomeOptions

type MWOpenHomeOptions = {
  userId : number
  deviceId : string
  oaid : string
}

MWOpenAdDetailOptions

type MWOpenAdDetailOptions = {
  adId : number
  userId : number
  deviceId : string
  oaid : string
}

MWSDKStatus

type MWSDKStatus = {
  initialized : boolean
  hasCredentials : boolean
  message : string
}

导出方法

• init(options)
• openHomePage(options)
• openAdDetail(options)
• getStatus()

实现说明

插件通过 uts.sdk.modules.mwsdk 提供的原生管理器完成调用。

当前实现包含以下特点：

1. 启动时通过 MWSDKAppHookProxy 注入 Application
2. 若用户已同意隐私协议，会在应用启动时尝试恢复初始化状态
3. init(options) 需要传入 fileProviderAuthorities
4. 打开首页和任务详情时需要传入业务用户 ID 与设备标识

Android 依赖

当前声明的依赖包括：

• androidx.appcompat:appcompat:1.7.0
• com.google.code.gson:gson:2.8.9
• com.liulishuo.filedownloader:library:1.7.7
• com.squareup.okhttp3:okhttp:4.12.0

最低支持 Android 版本：24

使用前准备

1. 必须使用自定义基座

本插件依赖原生 AAR 和 Android 三方库，标准基座下不能保证可用。

2. 准备渠道参数

请先准备：

• appId
• appSecret
• fileProviderAuthorities

3. 准备设备标识

页面拉起时建议传入：

• deviceId
• oaid

基本用法

// #ifdef APP-ANDROID
import { init, openHomePage, openAdDetail } from '@/uni_modules/ad-maowan-sdk'
// #endif

function initMaowan() : boolean {
  // #ifdef APP-ANDROID
  return init({
    appId: '你的appId',
    appSecret: '你的appSecret',
    fileProviderAuthorities: '你的包名.fileProvider'
  })
  // #endif
  return false
}

function openMaowanHome(userId : number, deviceId : string, oaid : string) : boolean {
  // #ifdef APP-ANDROID
  return openHomePage({ userId, deviceId, oaid })
  // #endif
  return false
}

常见问题

1. 初始化失败

请优先检查：

• appId、appSecret 是否为空
• fileProviderAuthorities 是否正确配置

2. 页面打开失败

请检查：

• userId 是否大于 0
• deviceId 是否为空
• SDK 是否已经完成初始化

3. 自定义基座未更新

如果依赖或 AAR 未被正确打入，通常需要重新制作并安装最新自定义基座。

更新记录

0.1.0

• 提供猫玩 Android SDK 的 uni-app x UTS 封装
• 支持初始化、首页打开、任务详情和状态查询