FoldRender / 指南 / 在折叠屏上读代码和文档:把阅读环境设好
FoldRender 指南

在折叠屏上读代码和文档:把阅读环境设好

折叠屏终于有了一块真正适合阅读的屏幕,可大多数应用还是把它当成一部高一点的手机。这是一份设置指南,不是宣传:怎么安装、把内容放到设备上的两种方式、应用遵循的布局规则、值得改一次的设置,以及如实列出哪些话我们还没资格说。

在 Google Play 上获取免费 看看 FoldRender 能做什么

分步操作

  1. 从 Google Play 安装

    FoldRender 在 Play 商店上的名字是 FoldRender: Git Repo Reader,包名 dev.foldrender.app,免费,面向全球发行。照常安装即可 —— 不会弹出要你打开「允许来自此来源的应用」的提示,更新也会自动送达。应用声明了 minSdk 30,所以需要 Android 11 或更新的版本;如果设备低于这个版本,Play 会直接告诉你,而不是让你装上一个跑不起来的版本。

  2. 在克隆和授权文件夹之间选一个

    有两种方式,而且它们不等价。在 Git 面板里 获取代码,会把仓库放进应用私有存储,并给你 git 的功能 —— 分支、状态、历史。打开文件夹通过 Android 文件夹选择器授权一个目录;授权在重启后依然有效,你会得到完整的文件树、类型标记、搜索和渲染,但完全没有 git,哪怕这个文件夹本身是一个 git 工作区。想要仓库状态就选克隆,内容已经在手机上就选文件夹。

  3. 把双栏设置好

    窗口确实够宽,或者设备报告自己处于半开状态时,会出现左右并排 —— 左边文件树,右边文档。窄的时候变成一栏,按返回就回到文件树;系统返回手势和导航栏的返回按钮都可以。Activity 声明了自己处理方向、屏幕尺寸、屏幕布局、最小宽度、键盘、密度和界面模式的变化,所以姿态改变时它不会被重建。

  4. 读长内容之前先把行宽调好

    在展开的 Fold 上,这是最要紧的设置,也是大多数应用不提供的那个。字号图标会打开阅读面板:行宽从 480 dp 到 1200 dp,字号从 80% 到 160%,主题有跟随系统 / 浅色 / 深色,还有一个正文用衬线字体开关。不把行收窄,正文会铺满整块内屏,读起来很难跟住。

  5. 弄懂两种搜索方式

    文档内查找是顶栏里的放大镜 —— 在文档中查找…,带实时匹配计数和上下箭头。整个工作区的 grep 是左栏的搜索标签页 —— 按字面或正则,path:line 结果带预览陆续出现,点一下就跳过去。前者回答「在这个文件的哪里」,后者回答「在哪个文件」。

  6. 把反复读的文件固定下来

    在文件树里长按一个文件,可以把它固定为收藏;打开过的文件会收集到快捷标签页。每个文档的滚动位置都会保存,所以重新打开一个长文件,会回到你上次读到的地方。

  7. 了解每种格式能给你什么

    Markdown 有大纲面板、callout、mermaid 和公式。源代码有高亮、行号和换行开关。JSON、YAML 和 TOML 是可折叠的树形,带可复制的路径。CSV 是表头冻结、可排序的表格。PDF 有页码计数和缩略图条。笔记本有执行计数和可收起的输出。Markdown 和笔记本还有「导出」面板。

FoldRender 是怎么做的

原生渲染,只有一处隔离的例外

文档以 Compose 渲染,而不是网页。应用里只有两处 WebView:公式和图表的隔离区,它的网络被封锁,只加载打包的资源;以及 HTML 文件查看器,它在禁用 JavaScript 的情况下运行,并把每一次跳转都交回给应用。

加一种格式不用动外壳

每种格式都是一个无状态的渲染器对象,根据文件名、MIME 类型和魔数给文件打分;得分最高的负责渲染。外壳通过一个统一的接口认识渲染器,渲染器通过一个宿主接口认识应用,所以文件树、搜索和布局在每种格式下的表现都完全一样。

免费,而且不是订阅

在 Google Play 上免费安装。不用注册账号,没有遥测提示,也没有把哪种格式锁在后面的付费档。

FoldRender 做不到什么?

如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断,这个版本能不能做你要做的那件事。

在 Android 上读仓库还有哪些办法?FoldRender 和它们比怎么样?

大家真正会用的四个应用,以及把它们区分开的那一条:仓库最后在不在手机上,到了手机上有没有东西把它渲染出来。

工具下载价格从哪里获取克隆到设备上渲染 PDF / Jupyter 笔记本 / Markdown编辑器或 shell
FoldRenderUS$0Google Play,全球能 —— HTTPS,公开仓库可匿名能 —— 原生 Compose 渲染器没有,有意为之:它是阅读器,不是 IDE
GitHub MobileUS$0Google Play 和 App Store不能 —— 它读的是托管在 GitHub 上的仓库只有 GitHub 自己渲染的内容,需联网可在 PR 里编辑文件
Termux + gitUS$0F-Droid 或 GitHub能 —— 真正的 git 命令行不能 —— 只有终端文本有,完整的 shell,任何命令行编辑器都能用
MGit 1.7.0 (2023)US$0只在 F-Droid能 —— 克隆、拉取、推送,HTTPS 或 SSH 密钥不能没有 —— 它自己的页面写明不带文本编辑器

价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐;Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。

FoldRender 的这些数字从哪来?

这里的每个数字都是从正式发布的版本里读出来的,或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。

常见问题

FoldRender 具体哪里适合折叠屏?
它用展开后的宽度放双栏的文件树和文档视图,宽度不够时收成一栏阅读,Activity 也声明了自己处理配置变化,而不是被重建。阅读设置还直接提供了行宽,宽屏读起来舒不舒服,就看这个控制。
免费吗?
免费 —— 在 Google Play 上免费安装。没有账号,没有订阅,也没有收费的格式。
必须克隆仓库才能用吗?
不用。打开单个文档用「打开文件」,或者通过 Android 选择器授权一个文件夹,得到一个持久保存、可以浏览的工作区。想同时要 git 状态和文件时,才需要克隆。
折叠时的表现在真正的 Galaxy Z Fold 上测过吗?
没有在零售硬件上测过。布局在模拟器里跑过,清单文件也声明了 Activity 自己吸收的配置变化,所以折叠时它不会被重建。我们没有测过的流畅度,不会说成测过。
在普通手机或平板上能用吗?
能。只要窗口够宽就会出现双栏;在窄屏上是一栏,按返回键就回到文件树。需要 Android 11 或更新的版本。
它怎么决定用哪个渲染器?
每个渲染器都根据文件名、MIME 类型和开头几个字节给文件打分,得分最高的胜出。扩展名缺失或有误导性的文件,只要魔数能被认出来,照样会交给对的渲染器。
FoldRender 多少钱?
US$0。在 Google Play 上免费,面向全球发行,版本里没有计费库,没有订阅,也没有付费档。
FoldRender 支持哪些 Android 版本?
Android 11 及以上。应用声明的 minSdk 是 30,也就是 2020 年随 Android 11 发布的 API 级别;编译和目标版本都是 API 36。它在 2025 年发布的 Galaxy Z Fold 7 上开发和测试。
FoldRender 能离线用吗?
能,只要仓库已经在设备上。克隆和拉取需要联网;从克隆下来的仓库或选中的文件夹里阅读、搜索,以及渲染 Markdown、源代码、PDF 和 Jupyter 笔记本都不需要。登录 GitHub 是可选的,只和私有仓库有关。
它和 GitHub Mobile、Termux、MGit 有什么不同?
GitHub Mobile 读的是托管在 GitHub 上的仓库,不会克隆到手机上。Termux 和 MGit 都能克隆,但克隆之后怎么渲染就交给你了 —— Termux 给你一个 shell,MGit 连文本编辑器都没有。FoldRender 通过 HTTPS 克隆,并在内屏上把克隆下来的内容渲染出来。

这些说法去哪里核对?

上面这些数字背后的一手文档,任何一条你都可以自己核对,不必听我们说。

本页最后核对于 2026-08-27。

更多 FoldRender 指南