# flutter-hello

**Repository Path**: nojsja/flutter-hello

## Basic Information

- **Project Name**: flutter-hello
- **Description**: flutter hello world demo.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-21
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_hello

Flutter学习和演示项目，展示Flutter应用的基础架构、状态管理、网络请求、国际化等核心功能的实现。

## 项目架构

项目采用清晰的分层架构，遵循关注点分离原则：

```
lib/
├── controllers/    # GetX控制器，负责全局状态管理
├── l10n/           # 国际化相关文件
├── main.dart       # 应用入口
├── models/         # 数据模型
├── pages/          # 页面组件
│   ├── detail/     # 详情页面
│   └── home/       # 首页
├── routes/         # 路由配置
├── theme/          # 主题配置
├── utils/          # 工具类
└── widgets/        # 通用组件
```

## 技术栈

- **框架**: Flutter 3.x
- **状态管理**: GetX
- **网络请求**: Dio, http
- **本地存储**: shared_preferences
- **路由管理**: GetX 路由 + go_router
- **国际化**: flutter_localizations, intl
- **UI组件库**: tdesign_flutter
- **屏幕适配**: flutter_screenutil
- **提示组件**: flash (SnackBar)

## 功能特性

- 多语言支持（中文/英文）
- 响应式UI设计
- 状态管理演示
- 网络请求封装
- 页面路由导航
- 错误处理机制

## 启动命令

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
# 在Android设备/模拟器上运行
flutter run -d android

# 在iOS设备/模拟器上运行
flutter run -d ios

# 在Chrome浏览器中运行
flutter run -d chrome

# 在所有可用设备上运行
flutter run
```

### 构建项目

```bash
# 构建Android发布版本
flutter build apk

# 构建iOS发布版本
flutter build ios

# 构建Web版本
flutter build web
```

## 开发指南

### 代码规范

遵循Dart官方推荐的代码规范，使用`flutter_lints`进行代码检查：

```bash
flutter analyze
```

### 添加新页面

1. 在`lib/pages/`下创建新的页面目录
2. 在`lib/routes/app_routes.dart`中注册路由
3. 使用GetX进行页面导航

### 添加国际化文本

1. 在`lib/l10n/app_localizations.dart`中添加新的文本键值对
2. 在UI组件中使用`context.l10n.xxx`访问本地化文本