更新记录

1.0.3（2026-01-27） 下载此版本

增加 mark 类型

1.0.2（2026-01-27） 下载此版本

增加了几个常量

1.0.1（2026-01-27） 下载此版本

增加了新的项目适配

平台兼容性

uni-app(4.64)

Joker Common 模块使用说明

概述

Joker Common 是一个通用的 uni-app 工具模块，提供统一的请求处理、常量管理等功能。

功能特性

• 统一的 API 请求处理
• 可配置的请求常量
• 自动签名计算
• 错误处理机制

常量配置

初始化配置

在 main.js 中初始化常量配置：

import { initializeJokerCommon } from './uni_modules/joker-common/index'

// 初始化 Joker Common 常量配置
initializeJokerCommon({
  baseUrl: 'https://your-api-domain.com/api',
  uploadUrl: '/system/v1/file/upload',
  timeout: 30000,
  appId: 'your-app-id',
  tenantId: 'your-tenant-id',
})

运行时配置

如果需要在运行时动态修改配置：

import { RequestConstants } from './uni_modules/joker-common/request/constants'

// 更新配置
RequestConstants.initialize({
  baseUrl: 'https://new-api-domain.com/api',
  appId: 'new-app-id',
  // ...
})

API 请求使用

import { httpClient } from './uni_modules/joker-common/index'

// GET 请求
const response = await httpClient.get('/api/users')

// POST 请求
const response = await httpClient.post('/api/users', { name: 'John' })

// 带配置的请求
const response = await httpClient.get('/api/data', {}, {
  showLoading: true,
  showSuccessMsg: true
})

向后兼容

为了向后兼容，仍然可以通过以下方式使用旧的常量定义：

import { RequestConstants } from '@/cst/constants'

// 获取单例实例
const constants = RequestConstants.getInstance()
console.log(constants.baseUrl)

注意：虽然这种方式仍然可用，但底层实际使用的已经是 joker-common 模块中的配置。