@appthen/utils

@appthen/utils

一个独立的工具函数库，从 appthen-react/src/utils 迁移而来，便于多项目复用。

特性

• 🚀 支持 ESM 和 CommonJS 两种模块格式
• 📦 采用 peerDependencies 模式，不打包外部依赖
• 🔧 完整的 TypeScript 类型支持
• 🌐 支持 Web 端使用（通过 @appthen/tarojs 模拟 Taro API）

安装

pnpm add @appthen/utils

主要功能

存储相关

• setItem - 设置存储项
• getItem - 获取存储项
• removeItem - 删除存储项
• getItemSync - 同步获取存储项
• $storage - 存储工具对象

数据预加载

• preload / $preload - 全局数据预加载

时间处理

• dayjs - dayjs 实例
• moment / $moment - dayjs 别名

数据源

• dataSource - 低代码数据源引擎

Taro API 重导出

• ENV_TYPE - 环境类型常量
• getEnv - 获取当前环境
• navigateTo - 页面跳转
• request - 网络请求
• 以及其他 Taro API...

使用示例

import { preload, setItem, getItem, dayjs } from '@appthen/utils';

// 数据预加载
preload('userInfo', { name: 'John', age: 30 });
const userInfo = preload('userInfo');

// 存储操作
await setItem('token', 'abc123');
const token = await getItem('token');

// 时间处理
const now = dayjs().format('YYYY-MM-DD');

依赖说明

本包使用 peerDependencies 模式，需要在主项目中安装以下依赖：

• @tarojs/taro - Taro 框架（或使用 @appthen/tarojs 模拟包）
• react - React 框架
• axios - HTTP 客户端
• dayjs - 时间处理库

构建

pnpm run build

迁移记录

详细的迁移过程和问题解决记录请参考 迁移与构建问题记录.md。