# flutter_trip

**Repository Path**: AmisKwok/flutter_trip

## Basic Information

- **Project Name**: flutter_trip
- **Description**: No description available
- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-06
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter Trip - 旅行应用

一个基于 Flutter 开发的旅行应用，提供精美的旅行目的地展示和城市浏览功能。

## 🚀 功能特性

- **首页轮播图** - 展示高质量的旅行图片轮播
- **城市选择** - 内置100+国内外热门城市
- **响应式导航** - 智能滚动交互的顶部导航栏
- **多平台支持** - 支持 Android、iOS、Web、Windows
- **完整的路由管理** - 使用 Fluro 实现页面路由
- **设备信息检测** - 跨平台设备信息获取
- **日志系统** - 完整的应用日志记录

## 📸 应用截图

<div align="center">
  <img src="lib/assets/banner/Abstract.jpg" alt="首页截图" width="200"/>
  <img src="lib/assets/banner/Default.jpg" alt="城市列表" width="200"/>
</div>

## 📱 页面结构

- **首页** (`HomePage`) - 轮播图展示和城市列表
- **旅拍** (`TravelPage`) - 旅行照片展示页
- **搜索** (`SearchPage`) - 搜索功能页面
- **我的** (`MyPage`) - 用户个人中心

## 🛠️ 技术栈

- **Flutter 3.8+** - 跨平台移动端框架
- **Dart** - 编程语言
- **Fluro 2.0.5** - 路由管理
- **Logger** - 日志记录
- **Carousel Slider 5.1.1** - 轮播图组件
- **Device Info Plus 12.3.0** - 设备信息获取
- **HTTP** - 网络请求

## 📦 项目结构

```
lib/
├── assets/banner/          # 静态资源
├── components/             # 可复用组件
│   ├── carousel_indicator.dart
│   └── image_carousel.dart
├── data/                   # 数据层
│   └── cities.dart
├── navigator/              # 导航管理
│   └── tab_navigator.dart
├── pages/                  # 页面组件
│   ├── home_page.dart
│   ├── travel_page.dart
│   ├── search_page.dart
│   └── my_page.dart
├── router/                 # 路由管理
├── utils/                  # 工具类
│   ├── deviceInfoUtils/    # 设备信息工具
│   ├── app_logger.dart
│   └── nothing_exception_handler.dart
└── main.dart              # 应用入口
```

## 🚀 快速开始

### 环境要求

- Flutter 3.8.1 或更高版本
- Dart SDK ^3.8.1
- Android Studio / VS Code

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd flutter_trip
```

2. **安装依赖**
```bash
flutter pub get
```

3. **运行应用**
```bash
# Android
flutter run

# iOS
flutter run -d ios

# Web
flutter run -d chrome

# Windows
flutter run -d windows
```

## 🔧 构建发布

### Android APK 构建
```bash
flutter build apk --release
```

### iOS 构建
```bash
flutter build ios --release
```

### Web 部署
```bash
flutter build web --release
```

## 📱 设备兼容性

- **Android**: API 21+ (Android 5.0+)
- **iOS**: iOS 11.0+
- **Web**: 现代浏览器
- **Windows**: Windows 10+

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进这个项目！

### 开发流程

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

## 📄 许可证

本项目基于 MIT 许可证开源 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📞 联系信息

- 项目主页: [GitHub Repository]
- 问题反馈: [Issues]
- 邮箱: [your-email@example.com]

## 🙏 致谢

感谢以下开源项目的支持：
- [Flutter](https://flutter.dev) - 优秀的跨平台框架
- [Fluro](https://pub.dev/packages/fluro) - 强大的路由管理
- [Carousel Slider](https://pub.dev/packages/carousel_slider) - 灵活的轮播组件

---
⭐ 如果这个项目对你有帮助，请给个星标支持！