# yxh_app

**Repository Path**: storecode/yxh_app

## Basic Information

- **Project Name**: yxh_app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-06
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# yxhui

A new Flutter project.

## Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)

<<<<<<< HEAD
For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
=======
## 🛠️ 快速开始

### 1. 克隆项目

```bash
git clone <repository-url>
cd yxhapp
```

### 2. 安装依赖

```bash
flutter pub get
```

### 3. 运行项目

```bash
# iOS
flutter run -d ios

# Android
flutter run -d android

# Web
flutter run -d chrome
```

## 📦 主要依赖

| 依赖包 | 版本 | 用途 |
|--------|------|------|
| provider | ^6.1.2 | 状态管理 |
| dio | ^5.8.0+1 | 网络请求 |
| shared_preferences | ^2.5.2 | 本地存储 |
| flutter_screenutil | ^5.9.3 | 屏幕适配 |
| webview_flutter | ^4.10.0 | Web视图 |
| permission_handler | ^12.0.1 | 权限管理 |
| qr_flutter | ^4.1.0 | 二维码生成 |

完整依赖列表请查看 [pubspec.yaml](pubspec.yaml)

## 🏗️ 项目结构

```
lib/
├── app.dart              # 应用入口
├── main.dart             # 主函数
├── common/               # 公共配置
│   └── log.dart         # 日志工具
├── data/                 # 数据定义和常量
├── model/                # 数据模型
├── provide/              # Provider状态管理
├── utils/                # 工具类
├── view/                 # 页面视图
│   ├── hotel/           # 酒店相关
│   ├── plane/           # 机票相关
│   ├── shop/            # 商城相关
│   ├── coupon/          # 优惠券相关
│   └── mine/            # 个人中心
└── widgets/              # 通用组件
```

## 🔧 开发工具

### 代码格式化

```bash
# 格式化所有Dart文件
flutter format .
```

### 代码分析

```bash
# 运行静态代码分析
flutter analyze
```

### 自动修复

```bash
# 自动修复部分代码问题
dart fix --apply
```

### 一键优化脚本

```bash
# 运行项目优化脚本（清理、格式化、分析）
./optimize.sh
```

## 📊 代码质量

- 遵循 [Flutter Style Guide](https://dart.dev/guides/language/effective-dart/style)
- 使用 `flutter_lints` 进行代码检查
- 详细配置见 [analysis_options.yaml](analysis_options.yaml)

## 🐛 调试技巧

### 启用详细日志

```bash
flutter run -v
```

### 使用 DevTools

```bash
flutter pub global activate devtools
flutter pub global run devtools
```

### 常见问题

1. **构建失败**：运行 `flutter clean` 后重试
2. **依赖冲突**：检查 `pubspec.yaml` 版本约束
3. **热重载失败**：尝试完全重启应用

## 📱 支付集成

项目集成了以下支付方式：

- 微信支付 (使用 fluwx)
- 支付宝支付 (使用 tobias)

配置详情请查看各平台文档。

## 🔐 权限说明

应用需要以下权限：

- 📍 位置权限：用于酒店距离计算
- 📷 相机权限：用于扫码功能
- 📁 存储权限：用于保存图片和文件
- 📞 电话权限：用于一键拨打客服

## 📈 性能优化

- ✅ 使用 const 构造函数
- ✅ 图片缓存和懒加载
- ✅ 列表使用 ListView.builder
- ✅ 避免不必要的重建

详细优化建议请查看 [OPTIMIZATION_REPORT.md](Doc/OPTIMIZATION_REPORT.md)

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📝 版本历史

当前版本: **65.0.0+1**

## 📄 许可证

本项目采用私有许可证。

## 📞 联系方式

如有问题或建议，请联系开发团队。

---

**注意**: 
- 首次运行前请确保已配置好相关API密钥和证书
- 生产环境部署前请修改 `lib/utils/http.dart` 中的API地址
- 详细配置说明请参考项目文档
>>>>>>> 8cc99d89fe1f579937603a120ef82e3570f717df