更新记录

1.0.1（2026-01-05）

一、文档更新

1.0.0（2026-01-05）

一、首次提交

平台兼容性

uni-app(4.57)

hl-autojs-uts

基于 AutoJs6 的脚本运行 UTS 插件，为 uni-app / uni-app x 应用提供完整的自动化脚本能力。

⚠️ 仅支持 Android 平台

功能特性

• ✅ 脚本执行 - 支持文件、项目、代码字符串三种方式
• ✅ 参数传递 - 向脚本传递 JSON 参数
• ✅ 权限管理 - 自动检测与引导授权（无障碍/悬浮窗/存储）

环境要求

快速开始

1. 导入与初始化

import { getHlAutojsClient } from '@/uni_modules/hl-autojs-uts'

const client = getHlAutojsClient()

// 注册状态回调
client.onUpdateCallback((res) => {
    console.log('AutoJs 状态:', res.code, res.data)
})

2. 运行脚本

// 方式一：运行脚本文件
client.runScriptFile('/sdcard/autojs/demo.js', (res) => {
    console.log(res.code === 1 ? '成功' : '失败', res.data)
})

API 文档

完整方法列表

初始化与生命周期

脚本执行

脚本控制

权限管理

状态码说明

权限配置

必需权限

应用需要以下 Android 权限：

1. 无障碍服务 - 用于控件查找、点击等 UI 操作
2. 悬浮窗权限 - 用于 floaty 悬浮窗功能
3. 存储权限 - 用于读取脚本文件

检查与请求权限

// 检查环境权限
client.checkEnv((res) => {
    const { accessibilityEnabled, overlayEnabled, storageGranted } = res.data
    console.log('无障碍:', accessibilityEnabled)
    console.log('悬浮窗:', overlayEnabled)
    console.log('存储:', storageGranted)
})

// 请求特定权限（自动跳转设置页）
client.requestPermission('accessibility', (res) => {
    console.log(res.data.msg)
})

// 获取所有权限状态
client.requestPermission('all', (res) => {
    console.log('权限状态:', res.data)
})

使用示例

完整的脚本执行流程

import { getHlAutojsClient } from '@/uni_modules/hl-autojs-uts'

const client = getHlAutojsClient()

// 1. 注册回调
client.onUpdateCallback((res) => {
    if (res.code === 100) {
        console.log('初始化成功')
        runMyScript()
    }
})

// 2. 初始化
client.infinity()

// 3. 运行脚本
function runMyScript() {
    const scriptPath = plus.io.convertLocalFileSystemURL('_www/static/scripts/main.js')

    client.runScriptFile(scriptPath, (res) => {
        if (res.code === 1) {
            console.log('脚本启动成功')
        } else {
            console.error('启动失败:', res.data.msg)
        }
    })
}

// 4. 停止脚本
function stopScript() {
    client.stopCurrent()
}

查询执行历史

client.getHistory((res) => {
    const list = res.data.list || []
    list.forEach(item => {
        console.log(`${item.scriptName} - ${item.success ? '成功' : '失败'} - ${item.message}`)
    })
})

注意事项

1. 仅支持 Android - iOS 及其他平台不支持
2. 需要权限 - 无障碍服务和悬浮窗权限必须手动授予
3. 脚本路径 - 使用 plus.io.convertLocalFileSystemURL() 转换应用内路径
4. 参数文件 - runScriptFileWithParams 会在脚本目录创建 __autojs_params__.json
5. 前台通知 - 保活服务会在通知栏显示，无法关闭