Как опубликовать Electron-приложение в Mac App Store: Sandbox и ревью

Вы разработали десктоп-приложение на Electron, но пользователи с macOS не могут его установить — система блокирует неподписанные приложения. По статистике, 95% таких приложений отклоняются из-за неверной настройки sandbox. Mac App Store (MAS) решает эту проблему, но предъявляет жёсткие требования: sandbox, строгие entitlements и ревью Apple. Без правильной подготовки публикация может затянуться на недели. По нашим данным, MAS в 2 раза быстрее прямого распространения благодаря встроенным автообновлениям, а пользователи на 30% чаще доверяют приложениям из официального магазина. Мы поможем пройти этот путь быстро и с гарантией: более 20 опубликованных приложений, 5 лет опыта, 95% прохождение ревью с первой попытки. Получите консультацию по настройке sandbox и entitlements прямо сейчас.

Почему стоит публиковаться в Mac App Store?

Прямое распространение проще, но MAS даёт преимущества: автоматические обновления через App Store, доверие пользователей и интеграция с Sandbox. Однако sandbox накладывает серьёзные ограничения: запрещён прямой запуск shell-команд, доступ к произвольным путям файловой системы и авто-запуск без LaunchAgent entitlement. Для Electron-приложений эти ограничения требуют отдельной проработки. По нашим данным, публикация в MAS сокращает время на поддержку обновлений на 40% по сравнению с прямым распространением. Комиссия Apple составляет 30% от продаж, но это компенсируется отсутствием затрат на хостинг обновлений и встроенной нотаризацией (ревью Apple заменяет её).

Как избежать отказов в ревью?

80% отказов связаны с отсутствием com.apple.security.network.client — это блокирует сетевые запросы. Вызов child_process.exec приводит к крашу приложения из-за sandbox. Мы заранее проверяем эти моменты, чтобы избежать отказов. Наиболее частые причины отказа — забытые entitlements и использование запрещённых API. Например, многие разработчики забывают включить доступ к сети или файловой системе. Мы проводим полный аудит вашего кода перед отправкой.

Как настроить entitlements для Electron?

Entitlements определяют разрешения приложения. Для MAS обязателен App Sandbox. В Electron есть основной процесс и child-процессы. Для обоих нужны отдельные plist-файлы.

<!-- build/entitlements.mas.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>com.apple.security.app-sandbox</key><true/>
  <key>com.apple.security.network.client</key><true/>
  <key>com.apple.security.files.user-selected.read-write</key><true/>
</dict>
</plist>

<!-- build/entitlements.mas.inherit.plist — для child процессов Electron -->
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>com.apple.security.app-sandbox</key><true/>
  <key>com.apple.security.inherit</key><true/>
</dict>
</plist>

Как обойти ограничения sandbox?

Некоторые функции, например работа с файлами вне выбранной пользователем папки, требуют использования XPC Services. Это отдельные процессы с расширенными правами, которые вызываются из основного приложения. Мы настраиваем XPC-сервисы для задач, не поддерживаемых sandbox: взаимодействие с оборудованием, обновления через Sparkle (если не использовать App Store).

Процесс работы над публикацией

Наш процесс включает следующие этапы:

Каждый этап документируется, и вы получаете готовый CI/CD пайплайн для автоматических обновлений.

Пример конфигурации electron-builder

# electron-builder.yml
mac:
  target:
    - target: mas
    - target: mas-dev
  provisioningProfile: build/embedded.provisionprofile
  entitlements: build/entitlements.mas.plist
  entitlementsInherit: build/entitlements.mas.inherit.plist
  hardenedRuntime: false
  identity: "3rd Party Mac Developer Application: Company (TEAM_ID)"

Сборка и валидация

# Сборка MAS-пакета
npx electron-builder --mac mas

# Валидация перед отправкой
xcrun altool --validate-app \
  --file dist/mas/AppName.pkg \
  --type osx \
  --apiKey "YOUR_API_KEY" \
  --apiIssuer "YOUR_ISSUER_UUID"

# Отправка в App Store Connect
xcrun altool --upload-app \
  --file dist/mas/AppName.pkg \
  --type osx \
  --apiKey "YOUR_API_KEY" \
  --apiIssuer "YOUR_ISSUER_UUID"

Современная альтернатива — xcrun notarytool и Transporter.app.

GitHub Actions для автоматизации

- name: Build MAS
  run: npx electron-builder --mac mas
  env:
    APPLE_ID: ${{ secrets.APPLE_ID }}
    APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
    CSC_LINK: ${{ secrets.MAS_CERTIFICATE }}
    CSC_KEY_PASSWORD: ${{ secrets.MAS_CERTIFICATE_PWD }}

- name: Upload to App Store Connect
  run: |
    xcrun altool --upload-app \
      --file "dist/mas/AppName.pkg" \
      --type osx \
      --apiKey "${{ secrets.ASC_API_KEY }}" \
      --apiIssuer "${{ secrets.ASC_ISSUER_ID }}"

Почему sandbox так строг?

Sandbox обеспечивает безопасность: приложение не может получить доступ к данным других приложений или системе без явного разрешения. Apple требует этого для всех приложений в MAS. Мы помогаем настроить entitlements так, чтобы ваше приложение работало корректно в этих рамках.

Сроки и что входит в работу

Первая публикация занимает от 4 до 7 рабочих дней, обновления — 1-2 дня. Членство в Apple Developer Program (ежегодная плата) окупается уже после нескольких обновлений за счёт автоматизации. В стоимость входит:

• Настройка App Sandbox и entitlements.
• Создание Provisioning Profile.
• Конфигурация CI/CD (GitHub Actions) для автоматической сборки.
• Отправка в App Store Connect и сопровождение ревью.
• Документация по дальнейшему обновлению.

Свяжитесь с нами для оценки вашего проекта. Закажите подготовку к публикации уже сегодня.

Документация Apple: App Sandbox

Мы регулярно сталкиваемся с ситуацией: «Сайт не открывается» в 3 часа ночи — и выясняется, что disk full на VPS, потому что логи nginx не ротировались полгода. Или сервер лёг под нагрузкой в день запуска рекламной кампании, потому что на shared хостинге стоял лимит в 50 одновременных соединений. Настройка хостинга и деплоя — это не про «где дешевле», это про то, что происходит в момент, когда что-то идёт не так. Наша команда помогает избежать таких инцидентов, проектируя инфраструктуру с учётом реальных паттернов нагрузки.

Когда выбирать Vercel и Netlify?

Vercel создан под Next.js — деплой в один push, preview deployments для каждого PR, автоматический CDN, Edge Functions, ISR без конфигурации. Для фронтенд-проектов и JAMstack это оптимальный выбор: нет операционной нагрузки, time-to-deploy измеряется минутами.

Ограничения реальные: Vercel Serverless Functions запускаются в us-east-1 по умолчанию (latency для Европы +80–100ms), Function timeout 300 секунд на Pro, Bandwidth 1TB/месяц на Pro. Для тяжёлого backend — нужны воркеры или отдельный сервер.

Netlify ближе к статике и Edge Functions на базе Deno Deploy. Build minutes — основное ограничение на бесплатном тарифе.

Почему Docker — основа предсказуемого деплоя?

«Работает на моей машине» — классика. Docker решает это через контейнеризацию окружения. Но плохой Dockerfile создаёт новые проблемы.

Типичная ошибка: копировать всё в образ без .dockerignore, получать 800MB образ вместо 80MB. node_modules внутри образа весит столько же. Правильно: multi-stage build.

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
CMD ["npm", "start"]

Итоговый образ: 180MB вместо 1.2GB. Время сборки CI сокращается из-за layer caching — если package.json не изменился, слой с npm ci берётся из кэша.

Docker Compose для локальной разработки и простых продакшен-сценариев: приложение + PostgreSQL + Redis в одной конфигурации. Для production на одном сервере — вполне рабочий вариант, если нет требований горизонтального масштабирования.

Подробнее о контейнеризации — Wikipedia: Docker.

Как настроить Nginx как reverse proxy?

Nginx перед приложением — стандарт для VPS и выделенных серверов. Основные функции: SSL termination, gzip, static files, rate limiting, upstream балансировка.

Конфигурация, которую часто делают неправильно: worker_processes auto — количество процессов равно числу CPU. worker_connections 1024 — это 1024 на каждый воркер-процесс. При 4 CPU и 1024 connections = 4096 одновременных соединений. Для высоконагруженного сайта нужно worker_connections 4096 и настройка keepalive_timeout 65.

Для статических ассетов с хешем в имени файла:

location ~* \.(js|css|woff2|png|webp)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

immutable сообщает браузеру: не проверяй этот файл даже при hard refresh. Правильно работает только с content-hashed именами файлов (что делает Vite/webpack по умолчанию). Документация — Wikipedia: Nginx.

AWS: гибкость и сложность

EC2 + Auto Scaling Group — классика для горизонтального масштабирования. AMI с предустановленным приложением, Launch Template, ASG с min/desired/max instances, Application Load Balancer. При CPU > 70% на 3 минуты — scale out, при CPU < 30% на 15 минут — scale in. Health check через ALB исключает нездоровые инстансы из ротации.

ECS Fargate — контейнеры без управления EC2. Деплой Docker-образа, задаёте CPU/память (512 CPU units = 0.5 vCPU, от 512MB памяти), Fargate запускает. Дороже Lambda, но нет cold start и нет timeout-ограничений. Подходит для long-running процессов, WebSocket-серверов, тяжёлых воркеров.

RDS для PostgreSQL с Multi-AZ: автоматический failover за 1–2 минуты при падении primary. Read Replicas для масштабирования чтения. RDS Proxy для connection pooling — Lambda-функции не умеют держать долгосрочные соединения, прокси буферизует это.

Kubernetes: когда это оправдано

K8s добавляет значительную операционную сложность. Оправдан, когда: несколько команд деплоят независимые сервисы, нужна тонкая настройка ресурсов на сервис, canary deployments и blue/green без простоя — требование.

AWS EKS, GKE или managed k8s от Hetzner (дешевле). Helm charts для стандартных сервисов. Horizontal Pod Autoscaler по CPU и custom metrics (RPS через Prometheus).

Для большинства стартапов и средних проектов — Kubernetes избыточен. ECS или Fly.io дают 80% возможностей при 20% операционной сложности.

Мониторинг и alerting

Сервер без мониторинга — это ожидание инцидента. Минимальный стек: Prometheus + Grafana (или Grafana Cloud для managed), alerting на disk > 80%, memory > 85%, CPU > 90% за 5 минут, error rate > 1%. Uptime через Better Uptime или Upptime (self-hosted).

Logs: Loki + Grafana или CloudWatch Logs Insights. Структурированные JSON-логи (winston, pino) — обязательно, иначе поиск по логам превращается в боль.

Что входит в настройку хостинга

• Аудит текущей инфраструктуры и профилирование нагрузки
• Выбор целевой архитектуры (VPS, AWS, serverless, Kubernetes)
• Настройка CI/CD pipeline (GitHub Actions, GitLab CI) с автоматическим деплоем
• IaC через Terraform или Pulumi (инфраструктура как код)
• Конфигурация Nginx, SSL-сертификаты, HTTP/2, brotli
• Мониторинг и алертинг (Prometheus + Grafana, PagerDuty)
• Документация runbooks и обучение команды

Дополнительно: пишите, если нужна миграция с текущего хостинга или интеграция с внешними сервисами.

Процесс работы

1. Аудит текущей инфраструктуры (2–5 дней)
2. Выбор целевой архитектуры с обоснованием по нагрузке и бюджету (1–3 дня)
3. Настройка CI/CD pipeline (GitHub Actions, GitLab CI) (2–5 дней)
4. IaC через Terraform или Pulumi (3–10 дней)
5. Настройка мониторинга и alerting (2–5 дней)
6. Документация runbooks и обучение команды (1–3 дня)

Наш опыт — 7 лет на рынке, более 50 проектов, гарантия работоспособности после деплоя.

Сроки

• Базовый деплой на VPS с Docker + Nginx + CI/CD: 1–2 недели.
• Настройка AWS инфраструктуры с Auto Scaling, RDS, CDN: 3–6 недель.
• Миграция на EKS с нуля: 6–12 недель.
• Настройка Vercel/Netlify для JAMstack: 3–5 дней.

Стоимость рассчитывается индивидуально в зависимости от сложности и объёма работ. Получите консультацию — оценим вашу архитектуру за один день.