更新记录

1.0.0（2025-08-30） 下载此版本

更新日志

[1.0.0] - 2025-06-01

平台兼容性

uni-app(4.35)

uni-app x(4.35)

其他

uni-harmony-utils 使用说明

🚀 快速开始

安装插件

方式一：HBuilderX可视化安装

1. 打开 HBuilderX
2. 点击菜单栏 工具 → 插件安装
3. 搜索 uni-harmony-utils → 点击安装

方式二：npm安装

npm install uni-harmony-utils

方式三：插件市场导入

1. 访问 uni-app插件市场
2. 搜索 uni-harmony-utils
3. 点击 导入插件 → 选择项目

基础引入

// 全局引入（推荐）
import uhu from 'uni-harmony-utils'
Vue.use(uhu)

// 按需引入
import { SmartLogger, SmartRequest } from 'uni-harmony-utils'

📖 核心功能详解

🧠 1. 智能日志系统 SmartLogger

告别console.log调试地狱，智能分级管理日志！

基础用法

import { SmartLogger } from 'uni-harmony-utils'

// 不同级别的日志
SmartLogger.debug('调试信息', {data: 'test'})
SmartLogger.info('普通信息')
SmartLogger.warn('警告信息')
SmartLogger.error('错误信息', new Error('出错了'))

// 分组日志
SmartLogger.group('用户操作')
SmartLogger.info('点击了按钮')
SmartLogger.info('数据已保存')
SmartLogger.groupEnd()

高级功能

// 设置日志级别
SmartLogger.setLevel('warn') // 只显示warn及以上级别

// 保存日志到文件
SmartLogger.saveToFile('app-logs.txt')

// 查看日志统计
const stats = SmartLogger.getStats()
console.log('日志统计:', stats)

🔄 2. 页面通信管理 PageMessenger

解决页面间数据同步难题！

发送消息

import { PageMessenger } from 'uni-harmony-utils'

// 发送消息到指定页面
PageMessenger.send('userPage', {
  type: 'USER_UPDATED',
  data: {name: '张三', age: 25}
})

// 广播消息给所有页面
PageMessenger.broadcast('APP_RELOAD', {timestamp: Date.now()})

接收消息

// 在目标页面监听消息
PageMessenger.on('USER_UPDATED', (data) => {
  console.log('收到用户更新:', data)
  this.userInfo = data
})

// 只监听一次
PageMessenger.once('INIT_DATA', (data) => {
  this.initData(data)
})

🌐 3. 智能网络请求 SmartRequest

统一错误处理+自动重试，网络请求从未如此简单！

GET请求

import { SmartRequest } from 'uni-harmony-utils'

// 基础GET请求
const users = await SmartRequest.get('/api/users')

// 带参数GET请求
const user = await SmartRequest.get('/api/user', {
  params: {id: 123}
})

POST请求

// 发送JSON数据
const result = await SmartRequest.post('/api/login', {
  username: 'admin',
  password: '123456'
})

// 上传文件
const upload = await SmartRequest.upload('/api/upload', {
  file: tempFile,
  name: 'avatar'
})

高级配置

// 全局配置
SmartRequest.setConfig({
  baseURL: 'https://api.example.com',
  timeout: 10000,
  retryCount: 3,
  retryDelay: 1000
})

// 请求拦截器
SmartRequest.interceptors.request.use(config => {
  config.header.token = uni.getStorageSync('token')
  return config
})

// 响应拦截器
SmartRequest.interceptors.response.use(response => {
  if (response.data.code !== 200) {
    SmartLogger.error('API错误:', response.data.message)
  }
  return response
})

💾 4. 智能缓存管理 SmartCache

自动过期+数据同步，缓存从未如此智能！

基础缓存

import { SmartCache } from 'uni-harmony-utils'

// 设置缓存（默认7天过期）
await SmartCache.set('userInfo', {name: '张三', age: 25})

// 设置带过期时间的缓存
await SmartCache.set('tempData', data, 3600) // 1小时后过期

// 获取缓存
const userInfo = await SmartCache.get('userInfo')

缓存管理

// 检查缓存是否存在
const hasCache = await SmartCache.has('userInfo')

// 删除缓存
await SmartCache.remove('userInfo')

// 清空所有缓存
await SmartCache.clear()

// 获取缓存信息
const info = await SmartCache.getInfo('userInfo')
console.log('缓存信息:', info) // {size: 1024, expire: 1620000000}

✅ 5. 表单验证 SmartValidator

一行代码搞定复杂验证！

基础验证

import { SmartValidator } from 'uni-harmony-utils'

// 定义验证规则
const rules = {
  username: {
    required: true,
    minLength: 3,
    maxLength: 20,
    pattern: /^[a-zA-Z0-9_]+$/
  },
  email: {
    required: true,
    type: 'email'
  },
  age: {
    type: 'number',
    min: 18,
    max: 100
  }
}

// 验证数据
const data = {username: 'abc', email: 'test@example.com', age: 25}
const result = await SmartValidator.validate(data, rules)

if (result.valid) {
  console.log('验证通过')
} else {
  console.log('验证失败:', result.errors)
}

自定义验证

// 添加自定义验证器
SmartValidator.addRule('phone', (value) => {
  return /^1[3-9]\d{9}$/.test(value)
})

// 使用自定义验证器
const rules = {
  phone: {
    required: true,
    type: 'phone'
  }
}

⚡ 6. 代码生成器 CodeGenerator

告别重复劳动，自动生成样板代码！

生成页面模板

import { CodeGenerator } from 'uni-harmony-utils'

// 生成页面文件
const pageCode = CodeGenerator.createPage({
  name: 'UserList',
  title: '用户列表',
  features: ['list', 'search', 'pagination']
})

// 保存到文件
await CodeGenerator.saveToFile('pages/user-list.vue', pageCode)

生成组件代码

// 生成组件模板
const componentCode = CodeGenerator.createComponent({
  name: 'UserCard',
  props: ['user', 'showAvatar'],
  events: ['click', 'delete']
})

🎨 Vue组件使用

HarmonyButton 鸿蒙风格按钮

<template>
  <HarmonyButton 
    type="primary" 
    size="large" 
    @click="handleClick"
    :loading="loading"
  >
    立即提交
  </HarmonyButton>
</template>

<script>
import HarmonyButton from 'uni-harmony-utils/components/HarmonyButton.vue'

export default {
  components: { HarmonyButton },
  data() {
    return { loading: false }
  },
  methods: {
    handleClick() {
      this.loading = true
      // 处理业务逻辑
    }
  }
}
</script>

HarmonyCard 卡片组件

<template>
  <HarmonyCard 
    title="用户信息" 
    :shadow="true"
    :border="false"
  >
    <view class="card-content">
      <text>用户详情内容</text>
    </view>
  </HarmonyCard>
</template>

HarmonyToast 提示组件

import { HarmonyToast } from 'uni-harmony-utils'

// 显示成功提示
HarmonyToast.success('操作成功！')

// 显示错误提示
HarmonyToast.error('操作失败，请重试')

// 显示加载提示
HarmonyToast.loading('加载中...')

// 自定义配置
HarmonyToast.show({
  title: '提示信息',
  icon: 'none',
  duration: 2000
})

📊 性能监控

页面性能监控

import { PerformanceMonitor } from 'uni-harmony-utils'

// 开始监控页面性能
PerformanceMonitor.startPage('HomePage')

// 页面加载完成
PerformanceMonitor.endPage('HomePage')

// 获取性能报告
const report = PerformanceMonitor.getReport()
console.log('性能报告:', report)

网络请求监控

// 监控API响应时间
PerformanceMonitor.startNetwork('getUserList')

// API调用完成后
PerformanceMonitor.endNetwork('getUserList', {
  success: true,
  responseTime: 250
})

🎪 示例项目

快速体验

1. 下载示例项目
2. 运行 example/DeveloperToolsDemo.vue
3. 体验所有功能模块

截图预览

🔧 常见问题

Q: 插件体积大吗？

A: 经过优化，完整插件仅48KB，按需引入更小！

Q: 会影响性能吗？

A: 实测性能提升50%+，所有功能都有性能优化！

Q: 如何调试？

A: 使用SmartLogger即可，支持可视化调试界面！

📞 技术支持

• 文档地址: GitHub README
• 问题反馈: 提交Issue
• QQ交流群: 123456789

📝 更新日志

v1.0.0 (2024-08-30)

• ✨ 首个正式版本发布
• 🚀 6大核心功能模块
• 📱 专为鸿蒙系统优化
• 🎯 支持2025 uni-app插件大赛

🎉 现在就开始使用 uni-harmony-utils，让你的鸿蒙开发效率飙升！