Запуск Web Surface

Что нужно до начала

Команды ниже выполняются в подготовленной папке ~/Desktop/A4-API-first-run. Её вместе со скриптами a4-api-demo.mjs и start-web-demo.sh даёт Evaluation Kit — отдельный артефакт поставки (см. Состав поставки). В установщик A4 он не входит и с dl.plantype.ru не скачивается: его запрашивают у поставщика.

Если Evaluation Kit ещё не получен, установленного A4 достаточно, чтобы пройти тот же путь вручную: fastdoc-cli лежит внутри приложения (см. Установка и проверка), формат запросов описан в Объектах запросов и ответов, полный перечень команд — в справочнике. Пример полностью выписанного скрипта есть у F1: проверенный скрипт.

Surface — готовая локальная страница редактора поверх того же Rust-процессора. Это самый быстрый способ увидеть встраивание: запускаете локальный host и помещаете его URL в WebView или iframe.

Что поверхность умеет сегодня

Она объявляет ровно четыре возможности: открыть документ, изменить первый абзац, сохранить и отдавать события вашему приложению. Это проверяемая демонстрация пути «открыл → изменил → сохранил», а не полноценный редактор в браузере: произвольная правка, выделение и контекстное меню наружу пока не выведены.

Полный редактор в браузере — другой путь: там работает то же настольное приложение, а документ считает ядро на сервере.

Поверхность поднимается одной командой процессора. Путь к нему зависит от системы, остальные аргументы одинаковы: --doc — какой документ открыть, --save — куда сохранять (по умолчанию в тот же файл).

macOS

CLI="/Applications/A4.app/Contents/Resources/runtime/native/fastdoc-cli"
"$CLI" surface --doc ~/Desktop/A4-API-first-run/contract.docx \
  --save ~/Desktop/A4-API-first-run/api-demo-web-result.docx

Windows

$CLI = "C:\Program Files\A4\resources\runtime\native\fastdoc-cli.exe"
& $CLI surface --doc "$HOME\Desktop\A4-API-first-run\contract.docx" `
  --save "$HOME\Desktop\A4-API-first-run\api-demo-web-result.docx"

Linux

CLI="/opt/A4/resources/runtime/native/fastdoc-cli"
"$CLI" surface --doc ~/Desktop/A4-API-first-run/contract.docx \
  --save ~/Desktop/A4-API-first-run/api-demo-web-result.docx

В ответ процессор печатает строку JSON с готовым адресом — откройте его в браузере. Адрес содержит одноразовый пропуск, поэтому подставлять ничего не нужно.

В Evaluation Kit для того же есть готовый скрипт start-web-demo.sh; он запускает ту же команду с заранее заданными портом и пропуском.

1. Дождитесь загрузки документа.
2. Поставьте курсор в первый абзац и добавьте текст.
3. Нажмите кнопку Save DOCX — она подписана по-английски, как и в самой поверхности.
4. Проверьте файл, указанный в --save.
5. Остановите поверхность сочетанием Control+C в том же окне терминала.

Порт и пропуск свои при каждом запуске

Порт по умолчанию выбирает система, а пропуск создаётся заново при каждом запуске — поэтому адрес из чужого примера не подойдёт. Оба значения fastdoc-cli печатает при старте одной строкой JSON:

{"schema":"fastdoc.surface-host-bootstrap.v1","host":"127.0.0.1",
 "port":54321,"token":"…","url":"http://127.0.0.1:54321/?token=…",
 "document_path":"/absolute/input.docx",
 "save_path":"/absolute/output.docx","ready":true}

Берите готовый url из этой строки — он уже содержит нужный пропуск. Рядом приходят и оба пути: document_path — открытый документ, save_path — куда уйдёт сохранение. Ваше приложение может показать их пользователю, не запоминая то, что само же передало в командной строке.

Что дальше

Поверхность запущена и работает. Дальше:

• встроить её в свой продукт — Встраивание Surface;
• точные имена событий, схем и параметров — Интерфейс поверхности в браузере.