Skip to content

Commit dd39f59

Browse files
committed
S5.1: план по шагам — пикер без копирования, потом чтение по дескриптору
Изучено, как обходят flutter/flutter#141002 (открыт с января 2024, P2). Шаг 1: fast_file_picker не читает файл при выборе — падение уходит у источника; книга переносится потоковым копированием saf_stream. Шаг 2: закреплённое разрешение, дескриптор через detachFd и PdfDocument.openCustom поверх FFI-pread — ноль копий, тот же приём, что у нативных просмотрщиков на PDFium. Запасной вариант записан заранее: если и по дескриптору выйдет плохо — переходим на доступ ко всем файлам и настоящие пути.
1 parent 3d7573f commit dd39f59

2 files changed

Lines changed: 43 additions & 19 deletions

File tree

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
| Локальная LLM | `flutter_gemma`; Gemma 3 1B int4 (~530 МБ), опционально Qwen 3 1.7B; **скачивается по запросу, не вшивается в сборку** |
3030
| Облачная LLM | Через свой прокси. Основной провайдер — **Groq** (бесплатный тир); резерв — платный Gemini 2.5 Flash-Lite и Llama 8B на DeepInfra. **Бесплатный тир Gemini запрещён**: Google обучается на содержимом запросов |
3131
| Прокси LLM | Cloudflare Worker (бесплатный тир): прячет ключ, лимитирует по устройству, роутит провайдеров |
32-
| Доступ к файлам | Книга **не копируется в приложение**. Android: системный диалог SAF, закреплённое разрешение на ссылку, чтение по файловому дескриптору; потоковое копирование маленьким буфером — только запасной путь для провайдеров, чья ссылка не годится для перескоков. Windows: обычный путь, `file_selector`. Копирование файла через память запрещено (решение владельца, 23.08.2026; вводится в S5.1) |
32+
| Доступ к файлам | Книга **не копируется в приложение**. Android: `fast_file_picker` (файл при выборе не читается), закреплённое разрешение на ссылку, чтение по дескриптору через `PdfDocument.openCustom` и FFI-`pread`; потоковое копирование (`saf_stream`) — запасной путь для провайдеров, чья ссылка не годится для перескоков. Windows: обычный путь, `file_selector`. Копирование файла через память запрещено. `MANAGE_EXTERNAL_STORAGE` — последний рубеж, только если чтение по дескриптору окажется плохим (решение владельца, 23.08.2026; вводится в S5.1) |
3333
| Синхронизация | **Google Drive appDataFolder самого пользователя**. Своей БД у проекта нет и не будет. В облако уходит **только прогресс чтения и то, что читатель создал сам** — цитаты, заметки, закладки |
3434
| Настройки отображения | Два уровня, **оба на устройстве**: мастер-настройки (какой открывается любая книга) и настройки книги (поправка к ним, предлагается сразу после открытия). Между устройствами переносятся по явной кнопке, а не сами. Светофильтр по умолчанию выбирается **сам, по времени суток**: утром светлый, днём сепия, вечером красный |
3535
| Авторизация | Вход через Google **браузерным потоком OAuth с PKCE, одинаково на обеих платформах**. Пакет `google_sign_in` и любые зависимости от Google Play Services запрещены |

‎PROGRESS.md‎

Lines changed: 42 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -970,10 +970,15 @@ OAuth с PKCE без Google Play Services, а это не тот сценари
970970
выбранный файл целиком в память, а потом пишет копию в кэш; на 73 МБ
971971
он растит буфер до 146 МБ, держит оба разом и упирается в потолок
972972
кучи. Из Dart такое не перехватывается — чинить надо не обработку
973-
ошибки, а способ приёма файла. Решение владельца: книга не копируется,
974-
а читается по закреплённой ссылке через дескриптор; работа вынесена в
975-
отдельную сессию **S5.1**, подробности в `docs/strategy_pdf_reader.md`
976-
§7. Обходной путь до тех пор: открывать книги полегче.
973+
ошибки, а способ приёма файла. Это известная ошибка самого пакета —
974+
[flutter/flutter#141002](https://github.com/flutter/flutter/issues/141002),
975+
заведена в январе 2024 с тем же стектрейсом до строчки, приоритет P2,
976+
открыта до сих пор; ждать исправления бессмысленно. Решение владельца:
977+
уходим с `file_selector` на Android — сначала на пикер, который не
978+
читает файл при выборе, потом на чтение по закреплённой ссылке через
979+
дескриптор. Работа вынесена в отдельную сессию **S5.1**, подробности в
980+
`docs/strategy_pdf_reader.md` §7. Обходной путь до тех пор: открывать
981+
книги полегче.
977982
- **На Windows фильтр беднее.** Шейдерные фильтры требуют Impeller,
978983
а Windows-сборка идёт на Skia: гамма там приближённая, а инверсия
979984
простая — картинки станут негативами. Уйдёт само, когда Impeller на
@@ -1068,31 +1073,50 @@ OAuth с PKCE без Google Play Services, а это не тот сценари
10681073

10691074
## Что дальше
10701075

1071-
**S5.1 — приём файла без копирования.** Своя тонкая прослойка к
1072-
системному диалогу на Android вместо `file_selector`: `ACTION_OPEN_DOCUMENT`,
1073-
**закреплённое** разрешение на ссылку (книга открывается и через месяц,
1074-
и после перезагрузки) и чтение **по дескриптору** — для файла на самом
1075-
устройстве это обычный файловый дескриптор, PDFium читает по нему
1076-
произвольно, как по локальному файлу. Лишнего места ноль, импорт
1077-
мгновенный, размер файла перестаёт что-либо значить. Для провайдеров,
1078-
чья ссылка не годится для перескоков (облачные хранилища), остаётся
1079-
запасной путь — **потоковое** копирование маленьким буфером; через
1080-
память не копируем нигде и никогда. На Windows `file_selector` остаётся:
1076+
**S5.1 — приём файла без копирования.** Идёт двумя шагами, и первый
1077+
ценен сам по себе (решение владельца, 23.08.2026).
1078+
1079+
**Шаг 1 — убрать падение.** Пикер меняется на `fast_file_picker`: он
1080+
сделан поверх того же `file_selector`, но файл при выборе не читает
1081+
вовсе — отдаёт имя и ссылку. Падение исчезает у источника, на файлах
1082+
любого размера. Дальше книга переносится в приложение потоковым
1083+
копированием на нативной стороне (`saf_stream.copyToLocalFile`). Цена
1084+
шага — файл занимает место дважды; читать книги при этом уже можно.
1085+
1086+
**Шаг 2 — убрать и копирование.** Свой мини-плагин на Android:
1087+
закреплённое разрешение на ссылку (книга открывается и через месяц, и
1088+
после перезагрузки), `openFileDescriptor` и номер дескриптора в Dart
1089+
через `detachFd()`. Читает `PdfDocument.openCustom` из pdfrx — у него
1090+
честный произвольный доступ через колбэк `read(buffer, position, size)`,
1091+
а сам колбэк зовёт `pread` из libc напрямую через FFI, без переходов
1092+
через канал на каждое чтение. Тем же приёмом открывают `content://`
1093+
нативные просмотрщики на PDFium. Лишнего места ноль, импорт мгновенный.
1094+
Потоковая копия остаётся запасным путём для облачных провайдеров, чья
1095+
ссылка не годится для перескоков. На Windows `file_selector` остаётся:
10811096
там настоящий путь и посредники не нужны.
10821097

10831098
Потерянное разрешение (файл переименовали, унесли карту памяти,
10841099
очистили данные) — не падение, а понятное состояние «файл недоступен,
10851100
выберите заново»: позиция чтения, цитаты и заметки принадлежат книге, а
10861101
не пути, и перевыбор файла их не теряет.
10871102

1103+
**Запасной вариант, записанный заранее.** Если и по дескриптору выйдет
1104+
плохо — медленно на больших книгах или ненадёжно из-за теряющихся
1105+
ссылок, — проект переходит на «Доступ ко всем файлам»
1106+
(`MANAGE_EXTERNAL_STORAGE`) и настоящие пути, как читалки с полкой на
1107+
тысячи книг. Это последний рубеж, а не первый: приложение, которое
1108+
продаёт приватность, просит такой доступ только когда иначе нельзя.
1109+
10881110
Автотесты: выбор пути (дескриптор или копия) на подставном источнике,
10891111
потоковое копирование на файле заметно больше буфера, поведение при
1090-
отозванном разрешении, корпус-тест «книга открывается по дескриптору
1091-
так же, как по пути».
1112+
отозванном разрешении, корпус-тест «книга открывается через
1113+
`openCustom` так же, как по пути».
10921114

10931115
От владельца в конце S5.1 — 15 минут: открыть ту самую книгу на 73 МБ и
1094-
ещё пару крупных; убедиться, что импорт мгновенный; закрыть и открыть
1095-
приложение заново — книга должна открываться без повторного выбора файла.
1116+
ещё пару крупных; оценить, быстро ли листается; закрыть и открыть
1117+
приложение заново — книга должна открываться без повторного выбора
1118+
файла. Если листание тормозит — это ответ про шаг 2, и он важнее
1119+
всего остального.
10961120

10971121
**S5.2 — библиотека и обложки.** Рендер обложек в фоновом isolate с
10981122
кэшем, сетка книг с индикаторами прогресса и «толщиной корешка»,

0 commit comments

Comments
 (0)