Files
PhoneViewer/README.md
T
2026-10-26 17:44:44 +08:00

37 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PhoneViewer / 万能看图
手机 / 平板上的本地 DWG、PDF、EPUB、FB2、XPS/OXPS、CBZ 和图片浏览器。
- DWG 解析:`@node-projects/acad-ts`(MIT),支持模型空间、块、布局、代理图形数据、图层、文字、填充、样条、尺寸等常见 2D 实体。
- 文档渲染:MuPDF.js。
- 前端:Vite + TypeScript + Canvas 2D,解析在 Web Worker 中执行。
- Android:Kotlin WebView 壳,离线内置全部前端资源,支持文件关联、返回键和 PNG 保存。
- 默认显示第三方代理对象,可在左侧立方体按钮中关闭;DWG 中代理数据本身没有图形时不会产生可见图元。
## 开发
```bash
npm install
npm run dev
npm run typecheck
npm run build
```
## 构建 Android APK
需要 JDK 17、Android SDK 34 和 Gradle 的 Kotlin 编译器(脚本位于 `E:\AiCodeGitea\ven\AndroidDev`,可在 `scripts/build-apk.mjs` 中调整路径)。
签名信息不写入仓库。构建前设置:
```bash
PHONEVIEWER_KEYSTORE_PASS=your-keystore-password
PHONEVIEWER_KEY_PASS=your-key-password
npm run apk
```
`android/keystore/`、测试 DWG、APK、`dist/`、`node_modules/` 均已加入 `.gitignore`。图纸不会上传,解析完全在本地进行。
## 许可
本项目以 AGPL-3.0-or-later 发布。第三方组件许可见应用内“关于 → 开源组件与许可”。