Мобильный SDK для партнёров

Что умеет

Три комплекта, по одному на редактор, все версии 2026.4.5:

• A4 — документы .docx и .docm;
• A4 Таблица — книги .xlsx и .xlsm;
• A4 Презентация — презентации .pptx.

Каждый комплект:

• открывает, показывает и правит файл внутри вашего приложения;
• работает тем же ядром, что и настольный редактор; номер комплекта совпадает с номером выпуска, из которого он собран;
• полный редактор, а не лёгкий просмотрщик: у A4 Таблицы — лента, строка формул, ярлыки листов и диаграммы, у A4 Документа — разметка страницы, у A4 Презентации — слайды и фигуры;
• файл приходит из любого источника: образец из архива, файл, который человек выбрал или получил, «Открыть с помощью» на Android и «Открыть в…» на iOS;
• «Сохранить» пишет файл в каталог вашего приложения; открытие и сохранение через системные окна;
• язык интерфейса — язык устройства.

Сохранение отдаёт байты файла вашему коду — куда их положить, решает ваше приложение. О поддержке и лицензии на выпуск напишите нам.

Как работает

• Ядро на устройстве. Ядро редактора собрано под телефон: на Android — библиотека JNI, на iOS — статический xcframework. Книга считается на устройстве.
• Интерфейс в приложении. Сетку, диаграммы и ленту рисует страница редактора, которая лежит внутри вашего приложения и загружается из его ресурсов. Ни к какому серверу она не обращается.
• Мост. Небольшой мост на Kotlin или Swift соединяет страницу с ядром, файлами приложения, буфером обмена и системными окнами выбора файла.

Требования

Состав комплекта

Проверка целостности после получения:

shasum -a 256 -c SHA256SUMS

Как встроить

Пошаговая инструкция «Шаги 1-2-3» лежит в README.md внутри каждого архива — у каждого комплекта своя. Пример из каждого архива собирается в пустом проекте без других файлов.

Android

1. Скопируйте jniLibs/, assets/ и два файла моста в модуль приложения. Пакет файлов моста не меняйте: на нём держатся имена JNI.
2. Создайте WebView по образцу эталонной активити из архива.
3. Передайте книгу странице — из образца, из выбранного файла или из «Открыть с помощью».

iOS

1. Добавьте xcframework ядра в цель (Do Not Embed: фреймворк статический), мост на Swift и каталог страницы как folder reference.
2. Добавьте эталонный вид из архива. Самый быстрый путь — готовое описание проекта для xcodegen из того же архива.
3. Передайте книгу странице — из образца, из окна «Файлы» или через «Открыть в…».

Подпись и выпуск

В SDK нет наших подписей и идентификаторов приложения. Приложение целиком ваше.

Ключ партнёра

Редактор работает в приложении, на которое выдан ключ партнёра. Ключ привязан к идентификатору вашего приложения (applicationId на Android, bundle id на iOS) и проверяется прямо на устройстве, без сети. Без ключа или с ключом от другого приложения документ не откроется — редактор покажет понятное сообщение со ссылкой на эту страницу.

• Android: положите ключ в assets/sdk-key.jws.
• iOS: добавьте ключ ресурсом sdk-key.jws.

В архивах лежит тестовый ключ: он подходит только для приложения-примера из архива. Ключ на своё приложение запросите у нас — назовите идентификатор приложения.

• Android: задайте свой applicationId и подпишите сборку своим ключом (signingConfigs в Gradle или подпись магазина). Выкладывайте в RuStore, Google Play или свой магазин под своим именем.
• iOS: задайте свой PRODUCT_BUNDLE_IDENTIFIER и команду разработчика. Подпишите приложение своим сертификатом и профилем. xcframework статический, отдельно его подписывать не нужно.

Закрытые функции и своя подписка

Страница спрашивает у моста, есть ли право на закрытые функции — экспорт всех листов в CSV и ИИ-помощник. По умолчанию всё открыто. Если вы продаёте эти функции сами, передайте мосту свою проверку права и свой экран оплаты — раздел ProGate в README архива.

Платформы и размер

• Android — arm64-v8a. iOS — 16 и выше у A4 Документа и A4 Таблицы, 17 и выше у A4 Презентации; срезы arm64.
• Ядро и страница заметно прибавляют к размеру приложения: A4 Таблица — около 90 МБ в APK для arm64, на iOS примерно 50 МБ к собранному Release плюс 35 МБ страницы; A4 на iOS — около 130 МБ к Release плюс 25 МБ страницы. Выкладывайте App Bundle, тогда магазин отдаст устройству только часть arm64.
• Память и время первого открытия — как у настольного редактора: у больших книг несколько секунд.
• Книги .xlsm и документы .docm открываются и правятся, формулы пересчитываются.

Как получить

SDK можно бесплатно оценить и собрать на нём прототип встраивания. Лицензия на промышленное использование и поддержка — через форму связи.

Комплект скачивается ниже. Для лицензии на выпуск приложения оставьте заявку через форму связи — расскажите о своём приложении и платформах.