# 轻阅屏

**Repository Path**: devode/lite_view

## Basic Information

- **Project Name**: 轻阅屏
- **Description**: 轻量 PDF 阅读器
- **Primary Language**: Dart
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 轻阅屏 (LiteView)

轻量级 PDF 阅读器，专为多平台优化的现代文档查看体验。

## 支持平台

- **Windows** - 完整支持 ✓
- **Android** - 完整支持 ✓

## 主要功能

### PDF 文件管理
- **PDF 列表界面** (`lib/screens/pdf_list_screen.dart`) - 浏览和管理已导入的 PDF 文档
- **PDF 文件扫描** (`lib/utils/pdf_file_scanner.dart`) - 扫描设备存储中的 PDF 文档
- **PDF 导入功能** (`lib/utils/import_pdf.dart`) - 导入外部 PDF 文件

### PDF 阅读体验
- **PDF 查看页面** (`lib/screens/pdf_view_page.dart`) - 核心阅读界面
- **绘制标注** (`lib/utils/pdf_aware_drawing_painter.dart`, `lib/widgets/current_path_painter.dart`) - 支持手绘标注和批注
- **路径绘制** - 记录和显示用户绘制的标注路径
- **路径优化** (`lib/utils/math_models.dart`) - 笔迹平滑处理（Douglas-Peucker 算法 + 二次贝塞尔曲线）

### 应用服务
- **自动更新检查** (`lib/services/update_service.dart`) - 从 Gitee 仓库自动检测新版本并提示用户更新
- **版本管理** - 支持跨平台版本检测（Windows .exe / Android .apk）

### 数据持久化
- **JSON 文件处理** (`lib/utils/json_file_handler.dart`) - 保存导入的 PDF 文档列表
- **数据类型定义** (`lib/data_types/data_types.dart`) - 统一的数据结构

## 项目架构

```
lib/
├── main.dart                    # 应用入口
├── icons/
│   └── my_icons.dart            # 自定义图标
├── l10n/
│   ├── app_zh.arb               # 中文语言包
│   ├── app_en.arb               # 英文语言包
│   └── app_localizations.dart   # 国际化支持
├── screens/
│   ├── pdf_list_screen.dart     # PDF 文件列表
│   └── pdf_view_page.dart       # PDF 阅读界面
├── services/
│   └── update_service.dart      # 应用更新服务
├── utils/
│   ├── import_pdf.dart          # PDF 导入工具
│   ├── json_file_handler.dart   # JSON 数据处理
│   ├── pdf_aware_drawing_painter.dart  # 标注绘制
│   ├── pdf_file_scanner.dart    # PDF 文件扫描
│   ├── pdf_file_list_handler.dart      # PDF 文件列表处理
│   └── math_models.dart         # 数学模型工具（路径优化）
└── widgets/
    └── current_path_painter.dart # 路径绘制组件
```

## 快速开始

### 环境要求

- Flutter SDK (3.0+)
- Dart SDK (3.0+)
- Android Studio / VS Code
- 各平台对应的开发环境

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
# 运行到 Windows
flutter run -d windows

# 运行到 Android
flutter run -d android
```

### 构建发布

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

# Android
flutter build apk --release
```

## 依赖配置

主要依赖项 (查看 [pubspec.yaml](pubspec.yaml) 完整列表):

- **Flutter SDK** - 跨平台 UI 框架
- **file_picker** - 文件选择器
- **path_provider** - 路径获取
- **pdfrx** - PDF 渲染引擎
- **flutter_colorpicker** - 颜色选择器
- **hive** - 轻量数据存储
- **flutter_localizations** - Flutter 国际化支持
- **flutter_localization** - 自定义国际化方案
- **window_manager** - 窗口管理（Windows）
- **url_launcher** - 外部链接打开
- **http** - HTTP 请求（更新检查）
- **pub_semver** - 语义化版本管理
- **package_info_plus** - 应用信息获取

## 界面特性

- **现代 UI 设计** - 采用 HarmonyOS Sans SC 字体
- **自定义图标** - 内置矢量图标集 (assets/fonts/MyIcons.ttf)
- **启动动画** - 平台原生启动体验
- **深色模式** - 支持系统深色主题

## 开发说明

### 代码规范

遵循 [analysis_options.yaml](analysis_options.yaml) 中的 Flutter 代码规范。

### 平台配置

- **Android** - Kotlin 开发，位于 `android/` 目录
- **Windows** - C++ 原生渲染，位于 `windows/` 目录
- **Win32 窗口管理** - 原生窗口支持 (`windows/runner/win32_window.cpp`)

## 许可证

本项目采用 **MIT 许可证**，详见 LICENSE 文件。

## 贡献指南

- 欢迎提交 Issue 和 Pull Request 来改进项目
- 欢迎在 Crowdin 上进行翻译，项目地址：https://crowdin.com/project/liteview/invite?h=c7c4a127f0073e43072e56171619aeea2689186

## 联系方式

- 项目地址: https://gitee.com/devode/lite_view
- 问题反馈: https://gitee.com/devode/lite_view/issues

---

*轻阅屏 - 让阅读更轻松*