# flutter_app

**Repository Path**: rrr729/flutter_app

## Basic Information

- **Project Name**: flutter_app
- **Description**: Flutter 双端（Android+iOS）模版，内置一套自研通用组件库（表单、选择器、日历、上传等，见 STRUCTURE.md）。
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-27
- **Last Updated**: 2026-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Flutter

## README

<!--
 * @Author: Mr_729
 * @FilePath: /flutter_app/README.md
 * @Date: 2025-12-10 17:21:07
 * @Description: 项目说明
-->
# flutter_app

## 运行环境

- Flutter 3.47.2
- Dart 3.13.2
- Xcode 15.4

> 注：pubspec.yaml 锁定了 `shared_preferences_foundation 2.5.3`（Xcode 15.4 编译不了其 2.6.x 的 Swift 6.1 语法），Xcode 升级到 16.3+ 后可移除该 override。

## 介绍

Flutter 双端（Android+iOS）模版，内置一套自研通用组件库（表单、选择器、日历、上传等，见 STRUCTURE.md）。

- 项目结构：[STRUCTURE.md](./STRUCTURE.md)

## 主要依赖

| 依赖 | 用途 |
| --- | --- |
| get | 状态管理 + 路由 |
| dio | 网络请求 |
| flutter_screenutil | 屏幕适配（设计稿 375 × 812） |
| shared_preferences | 本地缓存 |

## 使用

1. 安装依赖

   ```bash
   flutter pub get
   ```

2. 检查本机环境（Flutter SDK、Xcode、Android SDK 等）

   ```bash
   flutter doctor
   ```

3. 运行（`flutter devices` 查看设备，`-d` 指定设备）

   ```bash
   flutter run
   ```

## 打包

Android：

```bash
flutter build apk
# 产物：build/app/outputs/flutter-apk/app-release.apk
```

当前 release 使用 debug 签名（模版默认），正式发布前需在 `android/app/build.gradle.kts` 配置签名；上架 Google Play 使用 `flutter build appbundle`。

iOS：

```bash
flutter build ios
```

`flutter build ios` 仅编译验证；上架 App Store 需在 Xcode 中 Archive，或使用 `flutter build ipa`。

## 开发约定

- 设计稿尺寸 375 × 812，所有尺寸统一用 `.w` / `.sp`（flutter_screenutil），不要写裸数字，否则多端适配会失效。
- 通用组件放在 `lib/components/<组件名>/`，每个组件一个目录：`view.dart` 为主实现，`interface.dart` 放数据模型。
- 提交前跑 `flutter analyze`，保持 0 error。