玲珑应用商店 (Flutter 版本)

本仓库是玲珑应用商店从旧版 Tauri/React 迁移到 Flutter 的实现，目标是 UI 像素级一致 与 业务逻辑等价。

English Version | 中文文档

下载与安装

如果你只是想使用玲珑应用商店（而不是参与开发），直接下载预编译包即可，无需自行构建。

支持架构：amd64 / arm64 / loong64；包格式：deb / rpm / AppImage / bundle。

正式版（稳定）

推荐大多数用户使用。最新版本：

• 下载安装包：GitHub Releases（最新版）

• Arch Linux (AUR)：

  paru -S linglong-store-bin
  # 或 yay -S linglong-store-bin

Nightly 版（每日构建）

每天自动从 master 构建的尝鲜版本，包含最新功能，但可能不稳定。Nightly 与稳定版共用安装路径，二者不可并存（请先卸载稳定版再安装 Nightly）。

• 下载安装包：GitHub Releases（Nightly 预发布）

• Arch Linux (AUR)：

  paru -S linglong-store-nightly-bin
  # 或 yay -S linglong-store-nightly-bin

环境要求

• Flutter SDK (最新稳定版)
• Dart SDK
• Linux 桌面环境

快速开始

1. 安装依赖

flutter pub get

2. 生成代码文件

本项目使用 Freezed 和 Riverpod 等代码生成工具，运行前必须先生成代码文件：

dart run build_runner build --delete-conflicting-outputs

重要提示：如果缺少 .freezed.dart 或 .g.dart 文件，会导致编译错误。 每次修改带有 @freezed 或 @riverpod 注解的文件后，都需要重新执行此命令。

3. 运行应用 (开发模式)

flutter run -d linux

4. 构建发布版本

flutter build linux --release

常用命令

# 代码生成（Freezed/Retrofit/Riverpod）
dart run build_runner build --delete-conflicting-outputs

# 静态分析
flutter analyze

# 运行测试
flutter test

# 运行单个测试文件
flutter test test/unit/core/format_utils_test.dart

# Profile 性能验证
flutter run -d linux --profile

打包构建

# DEB 包
time ./build/package-deb.sh

# RPM 包
./build/package-rpm.sh

# AppImage 包
./build/package-appimage.sh

项目架构

整体为分层架构（依赖方向：Presentation → Application → Domain ← Data ← Platform）：

• Presentation：页面与通用组件
• Application：业务编排（Controllers/Services/Providers）
• Domain：纯模型与 Repository 接口
• Data：Repository 实现、API/CLI 数据源
• Platform：ll-cli 执行器、进程管理、窗口管理等

文档

详细的架构和开发指南请查看 AGENTS.md。

完整的技术文档位于 docs/ 目录：

• 架构设计 - 详细架构和目录结构
• UI 规范 - 设计系统基础
• 测试规范 - 测试覆盖和性能要求
• 迁移计划 - 与 Tauri/React 版本的对照

🤝 贡献指南

我们欢迎社区贡献！无论是 Bug 报告、功能建议、文档改进还是代码提交，我们都诚挚感谢。

详细贡献指南请查看 CONTRIBUTING.md，包括：

• 如何提交 Issue 和 Pull Request
• 开发环境搭建步骤
• 代码规范和提交规范（Conventional Commits）
• PR 审核流程
• 新手入门提示

快速贡献步骤

1. Fork & Clone 本仓库
2. 创建功能分支（feat/your-feature）
3. 遵循代码规范进行开发
4. 运行 flutter analyze 和 flutter test 验证
5. 提交 Pull Request 并清晰描述改动

💬 社区与支持

• 💬 社区讨论: bbs.deepin.org.cn - 深度社区论坛
• 🐛 问题反馈: GitHub Issues
• 📧 邮件联系: 通过 GitHub 联系项目维护者

📄 许可证

本项目基于 MIT 许可证 开源 - 详细内容请查看 LICENSE。