更新记录

1.0.0（2026-06-04） 下载此版本

• 初始版本发布
• 集成 Pinia 状态管理
• 提供持久化存储功能
• 内置 App、User、Layout 三个 store 模块
• 支持兼容旧代码的对象式 API

平台兼容性

uni-app(3.7.8)

uni-app x(3.7.8)

kordar_store 状态管理插件

一个基于 Pinia 的 uni-app 状态管理插件，提供持久化存储功能和常用 store 模块。

功能特性

• 基于 Pinia 的状态管理
• 自动持久化存储到本地
• 包含常用 store 模块：App、User、Layout
• 提供兼容旧代码的对象式 API
• 支持 Vue2 和 Vue3

安装

在 HBuilderX 中导入本插件即可使用。

快速开始

在 main.js 中配置

import { createSSRApp } from 'vue'
import { createI18n } from 'vue-i18n'
import App from './App'
import i18n from '@/uni_modules/kordar_i18n/js_sdk/index.js'
import { pinia, Pinia } from '@/uni_modules/kordar_store/js_sdk/index.js'

i18n.init()

export function createApp() {
  const app = createSSRApp(App)
  app.use(pinia)

  const vue3I18n = createI18n(i18n.getI18nConfig())
  app.use(vue3I18n)

  return {
    app,
    Pinia
  }
}

使用 store

Composition API 风格

import { useAppStore, useUserStore, useLayoutStore } from '@/uni_modules/kordar_store/js_sdk/index.js'

export default {
  setup() {
    const appStore = useAppStore()
    const userStore = useUserStore()

    // 使用状态
    console.log(appStore.locale)
    console.log(userStore.token)

    // 调用 actions
    appStore.setLocale('en')
    userStore.setToken('your-token')

    return {
      appStore,
      userStore
    }
  }
}

兼容对象式 API

import { App, User, Layout } from '@/uni_modules/kordar_store/js_sdk/index.js'

// 获取状态
const locale = App.locale()
const token = User.token()

// 调用方法
App.setLocale('en')
User.setToken('your-token')

内置 Store 模块

App Store

应用配置模块，管理主题、语言、侧边栏等状态。

import { App, useAppStore } from '@/uni_modules/kordar_store/js_sdk/index.js'

// 状态
App.locale()           // 当前语言
App.theme()            // 当前主题
App.sidebarCollapsed() // 侧边栏是否折叠
App.historyLocation()  // 历史位置

// 方法
App.setLocale(locale, callback)
App.setAppTheme(theme)
App.setSidebarCollapsed(value)
App.saveHistoryLocation(location)
App.reset()

User Store

用户信息模块，管理用户登录状态、权限等。

import { User, useUserStore } from '@/uni_modules/kordar_store/js_sdk/index.js'

// 状态
User.token()           // Token
User.info()            // 用户信息
User.permissions()     // 权限
User.isGuest()         // 是否游客
User.isSuper()         // 是否超级管理员

// 方法
User.setToken(token)
User.setInfo(info)
User.loadPermissions(permissions)
User.can(permission)
User.orCan(permission1, permission2)
User.logout(callback)
User.reset()

Layout Store

布局模块，管理标签页、菜单等。

import { Layout, useLayoutStore } from '@/uni_modules/kordar_store/js_sdk/index.js'

// 状态
Layout.state()         // 完整状态
Layout.state().tabs    // 标签页列表
Layout.state().choices // 选项列表
Layout.state().choiceId // 当前选项ID

// 方法
Layout.clear()
Layout.reset()

工具函数

import { 
  cloneValue,
  createStorageModule,
  readStorageState,
  writeStorageState,
  resetStorageState,
  bindPersistedStore 
} from '@/uni_modules/kordar_store/js_sdk/index.js'

目录结构

uni_modules/kordar_store/
├── uniCloud/
├── components/
├── utssdk/
├── hybrid/
├── pages/
├── static/
├── wxcomponents/
├── js_sdk/
│   ├── index.js           # 入口文件
│   ├── pinia.js           # Pinia 实例
│   ├── create-storage.js  # 存储工具
│   ├── app.store.js       # App store
│   ├── user.store.js      # User store
│   └── layout.store.js    # Layout store
├── license.md
├── package.json
├── readme.md
└── changelog.md

兼容性

• HBuilderX 3.1.0+
• uni-app 4.1.0+
• uni-app x 4.2.0+

更新日志

见 changelog.md

许可证

见 license.md