FoldRender / 指南 / 在 Galaxy Z Fold 7 上读 PDF，就在仓库旁边
FoldRender 指南

在 Galaxy Z Fold 7 上读 PDF，就在仓库旁边

PDF 是渲染在干净设备上验证过的四种格式之一：页数、翻页和缩略图都符合预期。本页讲怎么把一个 PDF 显示到屏幕上 —— 无论它来自「文件」应用、分享菜单，还是你克隆的仓库 —— 以及打开之后查看器能给你什么、不能给你什么。

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

分步操作

  1. 从 Google Play 安装

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

  2. 打开手机上已有的 PDF

    两条路。在 FoldRender 里：点顶栏的文件夹图标（或者空白界面上的打开文件），通过系统文档选择器选这个 PDF。从外面打开：在「文件」应用或 Drive 里点这个 PDF，在「打开方式」列表里选渲染 —— FoldRender 按 MIME 类型注册了 application/pdf，按扩展名注册了 .pdf，所以那些发送文件时内容类型写得含糊的应用也会列出它。

  3. 或者克隆 PDF 所在的仓库

    点分支图标打开 Git 面板，把 HTTPS 地址粘贴到 筛选，或输入 owner/repo，点 获取代码。公开仓库可以匿名克隆。克隆会作为工作区打开；在几千个文件的仓库上，第一次列出文件树要在一个光秃秃的转圈后面等很久，没有进度显示，所以给它一点时间。

  4. 在文件树里找到这个文件

    在文件标签页里，每一行都有类型标记；PDF 用红色的 PDF 标记，在一个全是源文件的文件夹里很容易挑出来。点这一行打开它。展开时，文件树留在左边，文档在右边渲染；合上时，文档占满整个屏幕，按返回键就回到文件树。

  5. 读它

    页面条上方那一行显示 N pages · page M（中文界面为「共 N 页 · 第 M 页」），M 会随着你滚动而更新 —— 这就是页码指示，而且是实时的。页面在一把互斥锁后面一次渲染一页，因为系统的 PDF 渲染器按约定是单线程的；渲染好的位图存在一个按页码和渲染宽度作键的 LRU 缓存里。还没滚到的页面会用占位块预留真实的宽高比，所以页面陆续出现时滚动条不会乱跳。

  6. 用缩略图条跳转

    文档旁边是一条横向的页面缩略图条；点一张缩略图，主列表就跳到那一页。缩略图条和主栏共用一个文档句柄和一个位图缓存，所以来回拖缩略图不会重新打开或重新解码文件。

  7. 按你正在用的屏幕调整

    字号图标会打开阅读面板 —— 主题（跟随系统 / 浅色 / 深色）、字号和行宽滑块，以及一个衬线字体开关。主题作用于文档周围的应用外壳。位图按页并且按宽度缓存，所以旋转或展开时，会按新的宽度重新渲染页面，而不是把旧位图放大。

FoldRender 是怎么做的

用系统自带的渲染器，而不是打包一个引擎

PDF 交给 Android 自带的 PdfRenderer 处理。这意味着 APK 里没有原生库，也不用为一种大多数人一周只打开几次的格式付出体积代价；也意味着页面的样子和系统其他地方渲染出来的一样。

仓库里所有东西，一个查看器

PDF 和它周围的 Markdown、源代码、笔记本在同一棵树里、同一个栏里打开。提交进仓库的规范 PDF、导出的报告和厂商的数据手册，不再是非得离开应用才能读的文件。

识别不依赖文件名

渲染器注册表同时根据文件名、MIME 类型和魔数（文件开头的特征字节）给每个候选打分。一个扩展名缺失或写错的文件，只要开头几个字节是 %PDF，照样会交给 PDF 渲染器。

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 能在折叠屏手机上打开 PDF 吗？
能，而且 PDF 是在干净设备上验证过的四种格式之一 —— 页数、滚动和缩略图都符合预期。它用 Android 自带的 PdfRenderer 渲染，和仓库里其他文件在同一个栏里显示。
能在 PDF 里搜索吗？
不能。查找栏只在以文字为主的渲染器里出现。PDF 可以用页码计数和缩略图条来导航。
需要另装一个 PDF 应用吗？
只是阅读的话不需要。FoldRender 注册了 application/pdf 和 .pdf 扩展名，所以它会以「渲染」这个名字出现在 Android 的「打开方式」列表里。要批注或签名，还是需要专门的 PDF 编辑器。
怎么跳到某一页？
滚动，或者点缩略图条里那一页的缩略图。上方那一行显示总页数和你当前所在的页，所以在长文档里你始终知道自己在哪儿。
打开一个大 PDF 会占很多内存吗？
渲染好的页面存在一个有上限、按页码和宽度作键的 LRU 缓存里，每次只栅格化一页。已经滚过去的页面会被移出缓存，而不是越积越多。
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 指南

在 Galaxy Z Fold 7 上读 Markdown在 Android 上 git clone：把仓库放到手机上，就在手机上读在手机上读代码，带真正的语法高亮在折叠屏上读 Jupyter 笔记本在手机上读整个 GitHub 仓库