# flutter_app

**Repository Path**: hs-xhl/flutter_app

## Basic Information

- **Project Name**: flutter_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-11-07
- **Last Updated**: 2025-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter App

A new Flutter project.

## Getting Started

This project is a starting point for a Flutter application.

## Prerequisites

- Flutter SDK (>=3.0.0)
- Dart SDK (>=3.0.0)

> **📖 安装指南**: 如果还没有安装 Flutter，请查看 [INSTALL_GUIDE.md](./INSTALL_GUIDE.md) 获取详细的安装步骤。

## Running the App

1. Make sure Flutter is installed and added to your PATH
2. Get dependencies:
   ```bash
   flutter pub get
   ```
3. Run the app:
   ```bash
   flutter run
   ```

## Project Structure

- `lib/main.dart` - Main application entry point
- `pubspec.yaml` - Project dependencies and configuration

## 快速运行项目

### 方法一：命令行运行（推荐）

```bash
# 1. 进入项目目录（如果还没有）
cd flutter_app

# 2. 获取依赖（首次运行必须）
flutter pub get

# 3. 运行项目
flutter run
```

### 方法二：使用 IDE

- **VS Code**: 按 `F5` 或点击"运行和调试"
- **Android Studio**: 点击工具栏的运行按钮

> **📖 详细运行指南**: 查看 [RUN_GUIDE.md](./RUN_GUIDE.md) 获取完整的运行步骤和常见问题解决方案。

## 文档说明

### [INSTALL_GUIDE.md](./INSTALL_GUIDE.md)
详细的 Flutter 环境安装步骤（Windows）

### [RUN_GUIDE.md](./RUN_GUIDE.md)
项目运行完整指南，包含：
- 快速开始步骤
- 不同平台运行方法
- 热重载使用技巧
- 常见问题解决

### [COMMANDS.md](./COMMANDS.md)
Flutter 常用命令介绍，包含：
- 项目创建命令
- 依赖管理命令
- 运行和调试命令
- 构建命令
- 设备管理命令
- 代码质量命令

### [MAIN_DART_EXPLAINED.md](./MAIN_DART_EXPLAINED.md)
main.dart 文件详细解释，包含：
- 逐行代码解释
- Widget 树结构
- 状态管理机制
- 执行流程说明
- 关键概念总结

### [FLUTTER_BASICS.md](./FLUTTER_BASICS.md)
Flutter 基本常识详细解释，包含：
- Flutter 简介和特点
- 核心概念（Widget、State、Context）
- Widget 系统详解
- 状态管理方案
- 布局系统原理
- 生命周期管理
- 开发模式和性能优化
- 平台支持和最佳实践

### [FRONTEND_AI_TOOLS.md](./FRONTEND_AI_TOOLS.md)
前端开发 AI 工具大全，包含：
- 代码生成和补全工具（Copilot、Cursor、Tabnine 等）
- UI/UX 设计工具（v0.dev、Framer AI、Uizard 等）
- 代码审查和测试工具
- 调试和性能优化工具
- 工具对比和使用建议