От сборки
до обновления.

Команда и первый проект

1. Открой доступ команде. Первый администратор создаёт аккаунт на главной странице Labs по приватному коду команды. После этого регистрация новых аккаунтов доступна по одноразовой ссылке из раздела «Команда».
2. Пригласи участников. Администратор выбирает роль, при необходимости закрепляет приглашение за email и передаёт ссылку. Участник работает с проектами и сборками; администратор также управляет приглашениями, ролями и доступом.
3. Создай проект. Укажи название, адрес проекта slug, описание и сайт. Например: название «Мой Герцена», адрес myherzen.

Адрес проекта используется в публичном API. После первой публикации его нельзя изменить. Аккаунты и база Labs отделены от Records.

Загрузка → черновик → публикация

Внутри проекта заполни форму «Загрузить сборку». Для каждого сочетания платформы, архитектуры и канала ведётся своя последовательность номеров.

Нажми «Загрузить черновик», проверь параметры и контрольную сумму, затем отдельно нажми «Опубликовать». Черновик не виден в публичном API и недоступен по публичной ссылке на скачивание.

Опубликованный выпуск нельзя изменить или удалить. Следующая публикация должна иметь больший номер сборки для того же сочетания платформы, архитектуры и канала. Для исправления выпуска подготовь новую сборку.

POST /projects/{projectId}/releases
Content-Type: multipart/form-data

file, version, buildNumber, platform,
architecture, channel, releaseNotes

POST /projects/{projectId}/releases/{releaseId}/publish

Что должно делать приложение

1. Запросить описание выпуска по HTTPS. Используй постоянную ссылку проекта с точными platform, channel и architecture. Авторизация для неё не нужна.
2. Проверить ответ. Обработай ошибки сети и отсутствие публикации. Проверь платформу, архитектуру, канал и статус published. Сравни целый buildNumber с номером установленной сборки, а не строки версий.
3. Предложить обновление. Если номер больше установленного, покажи версию и releaseNotes. Равный или меньший номер не должен запускать обновление или откат.
4. Скачать файл по downloadUrl. До установки проверь фактический размер против fileSize, SHA-256 против sha256, совместимость платформы и архитектуры, а также подлинность подписи пакета.
5. Передать файл штатному установщику. Используй механизм обновления конкретной ОС с необходимыми разрешениями и согласием пользователя. Labs не выполняет скрытую установку и не обходит ограничения системы.

Для сайта достаточно читать тот же JSON и подставлять downloadUrl в кнопку скачивания. В приложении загрузку, проверку подписи и установку нужно реализовать отдельно для каждой поддерживаемой платформы. SHA-256 проверяет целостность файла и не заменяет цифровую подпись пакета.

Собери ссылку своего проекта

Feed возвращает JSON последнего опубликованного выпуска с максимальным buildNumber для выбранных параметров. На странице можно подготовить адрес без запросов к API.

Параметр platform обязателен. Если не передать канал или архитектуру, используются stable и universal. Архитектура сопоставляется точно: запрос arm64 не подставляет сборку universal автоматически.

curl --fail-with-body --show-error --silent \
  'https://api.labs.moonbaystudio.ru/public/projects/myherzen/latest?platform=android&channel=stable&architecture=universal'

Пример с условными данными. Все поля ниже соответствуют ответу Labs; реальные значения выдаёт API.

{
  "id": 123,
  "projectId": 1,
  "version": "1.2.0",
  "buildNumber": 42,
  "platform": "android",
  "architecture": "universal",
  "channel": "stable",
  "releaseNotes": "Исправления и улучшения.",
  "fileName": "MyHerzen-1.2.0-42-release.apk",
  "fileSize": 67108864,
  "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "published",
  "createdAt": "2026-10-22T10:00:00Z",
  "publishedAt": "2026-10-22T10:05:00Z",
  "downloadUrl": "https://api.labs.moonbaystudio.ru/public/releases/123/download"
}

fileSize указан в байтах. Объект выпуска возвращается напрямую, без обёртки. Для скачивания используй полученный downloadUrl: это путь /public/releases/{id}/download. Не конструируй адрес по имени файла: у API нет алиаса latest.apk.

Для feed и файла используй метод GET. Метод HEAD на этих путях не поддерживается.

Feed может кэшироваться на 30 секунд. Ссылка на опубликованный файл постоянна; сам файл выдаётся как неизменяемый артефакт.

Проверка наличия новой версии

Этот JavaScript показывает только чтение feed и сравнение номера сборки. Он не скачивает файл и не запускает установку. В браузере действует ограничение CORS, описанное выше; в нативном приложении ту же проверку можно написать на языке его платформы.

// Пример появится после загрузки страницы.

После результата с новой версией покажи пользователю предложение обновиться. До установки отдельно проверь размер, SHA-256, пакет приложения и его подпись. Для загрузки и запуска установщика нужны платформенные API.

MyHerzen и особенности платформ

Для MyHerzen уже предусмотрен мост между Labs, сайтом скачивания и существующей проверкой обновления Android. Для новых продуктов такую интеграцию нужно добавить в их сайт и клиент.

Если выпуск не появился