更新记录

1.0.2（2026-02-06）

新增功能

• 上传日志时可自定义文件后缀，避免服务不支持
• 新增鸿蒙版的支持

问题修复

• 无

功能优化

• 无

1.0.1（2026-01-07）

新增功能

• 无

问题修复

• 无

功能优化

• 优化了系统日志自主收集行为的日志记录

1.0.0（2025-11-09）

新增功能

• 新增了自动收集应用日志、设置用户、设置标签、设置一般日志、设置警告日志、设置错误日志、设置事件日志、设置系统日志、获取日志文件列表、清理过期日志、上传日志文件、压缩并上传日志文件方法
• 初始版本

问题修复

• 无

功能优化

• 无

平台兼容性

uni-app(4.76)

uni-app x(4.76)

其他

闪退崩溃日志上报,设置用户信息标签,用户操作日志,主动上报日志

闪退崩溃日志上报,设置用户信息标签,用户操作日志,主动上报日志是款主动+自动收集系统日志的UTS插件，支持自动收集应用日志、设置用户、设置标签、设置一般日志、设置警告日志、设置错误日志、设置事件日志、设置系统日志、获取日志文件列表、清理过期日志、上传日志文件、压缩并上传日志文件

需要权限

• 文件读取、文件写入

"android.permission.READ_EXTERNAL_STORAGE"
"android.permission.WRITE_EXTERNAL_STORAGE"

• 即：在manifest.json中的distribute.android.permissions加入

// 读取文件时需要
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
// 写入文件时需要（默认保存到沙盒缓存）
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

使用示例【此示例只实现了设置日志的逻辑】

• 新建一个test.vue的文件

<template>
    <view class="content">
        <!-- App -->
        <view class="content-title">设置日志</view>
        <view class="content-message">(App组件描述)</view>
        <view class="content-button ima-log" @click="logInfoClick">设置一般日志</view>
        <view class="content-button ima-log" @click="logWarnClick">设置警告日志</view>
        <view class="content-button ima-log" @click="logErrorClick">设置错误日志</view>
        <view class="content-button ima-log" @click="logUserClick">设置事件日志【自定义】</view>
        <view class="content-button ima-log" @click="logAppClick">设置系统日志【自定义】</view>
    </view>
</template>

<script lang="ts">
import {
    // 方法
    initLog,
    setUser,
    setTag,
    logInfo,
    logWarn,
    logError,
    logUser,
    logApp
} from '@/uni_modules/ima-log'
export default {
    data() {
        return {
        }
    },
    onLoad() {
        // 开启自动接听
        initLog()
            .then((res: any) => {
                console.log(res)
            })
            .catch((err: any) => {
                console.log(err)
            })
    },
    methods: {
        // 设置用户
        setUserClick() {
            setUser('码小趣')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置标签
        setTagClick() {
            setTag('标签')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置一般日志
        logInfoClick() {
            logInfo('一般日志')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置警告日志
        logWarnClick() {
            logWarn('警告日志')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置错误日志
        logErrorClick() {
            logError('错误日志')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置事件日志【自定义】
        logUserClick() {
            logUser('设置事件日志', 'logUser')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        },
        // 设置系统日志【自定义】
        logAppClick() {
            logApp('设置系统日志', 'logApp')
                .then((res: any) => {
                    console.log(res)
                })
                .catch((err: any) => {
                    console.log(err)
                })
        }
    }
}
</script>

<style lang="scss">
.content {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;

    &-title {
        margin-top: 10rpx;
        padding: 10rpx;
        font-size: 44rpx;
        font-weight: 800;
        color: #ff0000;
    }

    &-message {
        font-size: 28rpx;
        font-weight: 800;
        text-align: center;
        color: #ff6700;
    }

    &-button {
        height: 65rpx;
        width: 750rpx;
        padding: 20rpx;
        line-height: 65rpx;
        text-align: center;
        background: #00e0f1;
        margin-bottom: 25rpx;
    }
}
</style>

方法

IUpload 上传参数

type IUpload = {
    serverUrl : string                    // 上传接口【必传】
    headers ?: UTSJSONObject | null             // 请求头参数
    parameters ?: UTSJSONObject | null      // 附加的表单参数
    timeout ?: number                                           // 接口超时时间
    include ?: boolean                                      // 是否包含系统日志`log_apps.log`
    days ?: number                                              // 上传近几天的日志
}