# Flutter app

**Repository Path**: pig-developers-alliance/flutter-app

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-28
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一个木头 - 插件化Flutter应用

一个基于插件架构的Flutter应用，支持Windows和Android平台。采用磁性贴网格布局，每个插件独立运行，易于扩展。

> **最新更新**: 插件系统已全面简化！查看 [更新说明](README_CHANGES.md) 了解详情。

## ✨ 特性

- 🔌 **插件化架构** - 每个功能都是独立插件，互不干扰
- 📱 **跨平台支持** - 完美支持Windows和Android
- 🎨 **磁性贴布局** - 简洁美观的网格展示
- 🔄 **下拉刷新** - 支持动态重新加载插件
- 💾 **数据持久化** - 跨平台数据存储方案
- 🎯 **易于扩展** - 只需实现接口即可添加新插件

## 📦 内置插件

1. **Demo计数器** - 简单的计数器示例
2. **待办事项** - 任务管理工具，支持数据持久化
3. **计算器** - 基础计算器功能
4. **信用卡分期计算器** - 计算信用卡分期的实际年化利率

## 🚀 快速开始

### 环境要求

- Flutter SDK >= 3.0.7
- Dart SDK >= 3.0.0
- Windows 10+ 或 Android 5.0+

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
# 查看可用设备
flutter devices

# Windows平台
flutter run -d windows

# Android设备
flutter run -d 632ea52d    # K30-Pro
flutter run -d 25f2133c    # One-Plus

# 或直接运行到连接的设备
flutter run
```

### 构建发布版本

```bash
# Windows
flutter build windows --release

# Android
flutter build apk --release
flutter build appbundle --release
```

## 📁 项目结构

```
项目根目录/
├── lib/
│   ├── main.dart                    # 应用入口
│   ├── core/                        # 核心框架
│   │   ├── plugin_loader.dart       # 插件加载器（自动扫描）
│   │   ├── plugin_interface.dart    # 插件接口
│   │   └── plugin_storage.dart      # 数据持久化
│   ├── plugins/                     # 插件目录
│   │   ├── plugin_registry.dart     # 插件注册中心
│   │   ├── demo_counter/            # 计数器插件
│   │   │   ├── plugin.json          # 插件配置（含 enabled）
│   │   │   ├── index.dart           # 插件主文件
│   │   │   ├── icon.png
│   │   │   ├── data/                # 数据目录
│   │   │   └── cache/               # 缓存目录
│   │   ├── todo_list/               # 待办事项插件
│   │   ├── calculator/              # 计算器插件
│   │   └── credit_rate_calculator/  # 信用卡分期计算器
│   └── ui/                          # 界面层
│       ├── home_page.dart           # 主页
│       ├── plugin_detail_page.dart  # 插件详情页
│       └── plugin_manager_page.dart # 插件管理页
├── tools/
│   └── create_plugin.dart           # 插件创建工具
└── create_plugin.bat                # Windows 插件创建脚本
```

## 🔧 开发新插件

### 快速创建（推荐）

使用命令行工具一键创建插件模板：

```bash
# Windows
create_plugin.bat my_plugin "我的插件" "插件描述"

# 其他平台
dart tools/create_plugin.dart my_plugin "我的插件" "插件描述"
```

工具会自动完成：
- ✅ 创建插件目录结构
- ✅ 生成 plugin.json 配置文件
- ✅ 生成 index.dart 模板代码
- ✅ 创建 data 和 cache 目录
- ✅ 复制默认图标
- ✅ **自动更新 pubspec.yaml**
- ✅ **自动生成插件注册代码**
- ✅ **自动运行 flutter pub get**

### 手动创建步骤

1. **创建插件目录**
   ```bash
   mkdir lib/plugins/my_plugin
   mkdir lib/plugins/my_plugin/data
   mkdir lib/plugins/my_plugin/cache
   ```

2. **创建 plugin.json**
   ```json
   {
     "id": "my_plugin",
     "title": "我的插件",
     "description": "插件描述",
     "version": "1.0.0",
     "entry": "index.dart",
     "icon": "icon.png",
     "enabled": true
   }
   ```

3. **创建 index.dart**
   
   实现 `PluginInterface` 接口，参考 [插件开发指南](PLUGIN_DEVELOPMENT_GUIDE.md)

4. **完成！**
   
   工具已自动完成所有配置，你只需：
   - 编辑 `lib/plugins/my_plugin/index.dart` 实现功能
   - 运行 `flutter run` 查看效果

### 启用/禁用插件

编辑插件的 `plugin.json`：
```json
{
  "enabled": true  // 或 false
}
```

## 📚 文档

### 快速入门
- [快速参考手册](QUICK_REFERENCE.md) - 常用命令和模板 ⭐
- [完全自动化流程](FULL_AUTOMATION.md) - 零配置插件开发 🆕⭐
- [使用说明](USAGE.md) - 快速上手指南
- [插件快速开始](PLUGIN_QUICK_START.md) - 插件开发快速入门

### 深入了解
- [插件自动注册机制](PLUGIN_REGISTRY_AUTO.md) - 自动注册原理
- [完整总结](FINAL_SUMMARY.md) - 系统完整介绍
- [改进总结](IMPROVEMENTS.md) - 效率提升详情
- [更新说明](README_CHANGES.md) - 最新更新内容

### 技术文档
- [架构设计文档](PLUGIN_ARCHITECTURE.md) - 详细的架构说明
- [插件开发指南](PLUGIN_DEVELOPMENT_GUIDE.md) - 完整的开发指南

## 🎯 架构优势

1. **高内聚低耦合** - 插件之间完全独立
2. **易于维护** - 每个插件可单独开发和测试
3. **灵活扩展** - 添加新功能无需修改核心代码
4. **跨平台一致** - 统一的API在所有平台上工作

## 🛠️ 技术栈

- Flutter 3.x
- Dart 3.x
- Material Design 3
- path_provider (数据持久化)

## 📝 常用命令

```bash
# 创建项目骨架
fvm flutter create

# 查看设备列表
flutter devices

# 热重载
r

# 热重启
R

# 清理构建缓存
flutter clean

# 分析代码
flutter analyze

# 格式化代码
dart format .
```

## 🤝 贡献

欢迎提交Issue和Pull Request！

## 📄 许可证

MIT License