# uView Starter

一个基于 uView Next 4.1 和 UniApp X 构建的跨平台应用开发模板。

## 项目简介

uView Starter 是一个集成了 uView Next 4.1 UI 组件库的 UniApp X 项目模板，提供了最基础的项目结构和基础功能，帮助开发者快速搭建跨平台应用。

## 技术栈

- **UI 组件库**: [uView Next 4.1](https://ext.dcloud.net.cn/plugin?id=25603) （需要自行下载安装到uni_modules目录)
- **样式方案**: Unocss
- **开发语言**: UTS (TypeScript)
- **状态管理**: Vue 3 Composition API
- **HTTP 请求**: uView Next 请求封装
- 
## 项目结构

```
uview-starter/
├── api/                 # API 接口定义
│   ├── app.uts          # 应用配置接口
│   ├── index.uts        # API 入口
│   └── user.uts         # 用户相关接口
├── components/          # 自定义组件
│   └── tabbar/          # 底部导航栏组件
│       └── tabbar.uvue
├── pages/               # 页面
│   ├── index/           # 首页
│   │   └── index.uvue
│   ├── news/            # 新闻页
│   │   └── news.uvue
│   └── user/            # 用户页
│       └── user.uvue
├── static/              # 静态资源
│   └── images/          # 图片资源
├── stores/              # 状态管理
│   └── config.uts       # 配置管理
├── styles/              # 样式文件
│   ├── common.scss      # 通用样式
│   └── uno.css          # Unocss 样式
├── types/               # 类型定义
│   ├── config.uts       # 配置类型
│   └── http.uts         # HTTP 类型
├── uni_modules/         # 第三方模块
│   ├── unocss/          # Unocss 模块
│   ├── uview-unix/      # uView Next 4.0
│   └── z-paging-x/      # 分页组件
├── App.uvue             # 应用入口
├── main.uts             # 主入口文件
├── pages.json           # 页面配置
├── manifest.json        # 应用配置
└── tsconfig.json        # TypeScript 配置
```

## 快速开始

### 环境要求

- HBuilderX 4.85+

### 组件使用

使用 uView 组件：

```vue
<template>
    <un-button type="primary" @click="handleClick">按钮</un-button>
</template>

<script setup lang="uts">
import { http } from '@/uni_modules/uview-unix';

function handleClick() {
    // 处理点击事件
}
</script>
```

### API 开发

在 `api` 目录下定义接口：

```typescript
// user.uts
export function login(params: LoginParams) {
    return http.post<LoginResult>('/api/login', params);
}
```

## 主题定制

可以通过修改以下文件进行主题定制：

- `vite.config.ts` - Unocss 主题配置
- `styles/common.scss` - 通用样式
- `uni_modules/uview-unix/styles/variable.scss` - uView 主题变量

## 许可证

MIT License
