Збірка та підписання десктоп-додатку для macOS

Ситуація: додаток зібрано, але на сучасних версіях macOS (14+) Gatekeeper блокує запуск. Користувачі повідомляють: «не може бути відкрито, оскільки Apple не може перевірити його». Корінь — відсутність підпису коду та нотаризації. Без них Gatekeeper блокує запуск, а обхід через «Системні налаштування» вимагає нестандартних дій, які більшість користувачів не виконають.

Вирішити це можна за 3–4 дні, якщо правильно налаштувати ланцюжок: сертифікат Developer ID → entitlements → підпис → нотаризація → stapling. Ми робимо це під ключ для Electron, Qt, SwiftUI та інших фреймворків. За 5+ років досвіду ми провели понад 50 релізів для macOS — жоден не було заблоковано. Apple Notarization Guide

Плата за вхід: сертифікат Developer ID Application можна отримати лише за наявності підписки Apple Developer Program (вартість $99/рік). Сама нотаризація для розробників безкоштовна.

Чому підпис коду критичний?

Підпис коду — це цифровий підпис розробника, що гарантує цілісність додатку. macOS перевіряє його при кожному запуску. Без нього Gatekeeper блокує додаток, користувач змушений вручну дозволяти запуск через «Системні налаштування» або термінал. Для корпоративних середовищ це неприйнятно: MDM-політики забороняють запуск непідписаних додатків. Нотаризація додає перевірку Apple на шкідливий код. Обидві процедури обов'язкові для поширення поза Mac App Store.

Як підписати та нотаризувати додаток для macOS?

Процес включає 2 обов'язкові етапи: Code Signing та Notarization. Спочатку отримуєте сертифікат Developer ID Application (потрібен Apple Developer Account). Потім конфігуруєте збірку з правильними entitlements. Нижче — мінімальний конфіг для Electron.

// electron-builder.yml
mac:
  target:
    - target: dmg
    - target: zip
  icon:      build/icon.icns
  category:  public.app-category.productivity
  hardenedRuntime:   true
  gatekeeperAssess:  false
  entitlements:          build/entitlements.mac.plist
  entitlementsInherit:   build/entitlements.mac.plist
  identity: "Developer ID Application: Company Name (TEAM_ID)"

<!-- build/entitlements.mac.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>com.apple.security.cs.allow-jit</key><true/>
  <key>com.apple.security.cs.allow-unsigned-executable-memory</key><true/>
  <key>com.apple.security.cs.allow-dyld-environment-variables</key><true/>
  <key>com.apple.security.network.client</key><true/>
</dict>
</plist>

Які entitlements потрібні для Electron-додатків?

Electron вимагає 4 ключі: allow-jit (для V8), allow-unsigned-executable-memory (для JIT-компіляції), allow-dyld-environment-variables (для Node.js) та network.client (для HTTP-запитів). Без них додаток вилетить при старті або не зможе виконувати мережеві запити. Порівняйте з entitlements для нативних SwiftUI-додатків: там зазвичай достатньо com.apple.security.app-sandbox та com.apple.security.files.user-selected.read-write.

Нотаризація та stapling

Після підпису надсилаємо .dmg на нотаризацію через notarytool. Apple сканує бінарники на віруси та шкідливий код. Результат — нотаризаційний квиток, який вбудовується у файл командою stapler.

# Через notarytool (Xcode 13+)
xcrun notarytool submit AppName.dmg \
  --apple-id     "[email protected]" \
  --password     "@keychain:AC_PASSWORD" \
  --team-id      "TEAM_ID" \
  --wait

# Stapling (вбудовування нотаризаційного квитка у файл)
xcrun stapler staple AppName.dmg

Notarytool працює в 3 рази швидше старого altool та має кращий рівень підтримки, оскільки активно розвивається Apple.

Покрокове налаштування підпису в CI/CD

1. Отримайте сертифікат Developer ID Application в Apple Developer Portal (сертифікат типу Developer ID Application, не Development).
2. Експортуйте сертифікат у .p12 та збережіть у секретах CI (наприклад, GitHub Secrets).
3. Налаштуйте electron-builder або аналог із потрібними entitlements (див. вище).
4. Додайте крок імпорту сертифіката в CI-пайплайн.
5. Налаштуйте етап нотаризації з notarytool та stapling.
6. Протестуйте збірку на локальній машині та в CI.

GitHub Actions для macOS

- uses: actions/checkout@v3
- name: Import Certificate
  run: |
    echo "$MACOS_CERTIFICATE" | base64 --decode > certificate.p12
    security import certificate.p12 -P "$MACOS_CERTIFICATE_PWD" \
      -A -t cert -f pkcs12 -k ~/Library/Keychains/login.keychain

- name: Build and Sign
  run: npm run build:mac
  env:
    APPLE_ID:          ${{ secrets.APPLE_ID }}
    APPLE_ID_PASS:     ${{ secrets.APPLE_ID_PASS }}
    APPLE_TEAM_ID:     ${{ secrets.APPLE_TEAM_ID }}
    CSC_LINK:          ${{ secrets.MACOS_CERTIFICATE }}
    CSC_KEY_PASSWORD:  ${{ secrets.MACOS_CERTIFICATE_PWD }}

Universal Binary (Intel + Apple Silicon)

Universal binary — це збірка, що містить обидві архітектури (x86_64 та arm64). Вона працює нативно на M1/M2/M3 без Rosetta 2. Це обов'язкова вимога для App Store та багатьох корпоративних середовищ. Економія продуктивності: без universal binary ви втрачаєте до 30% на Apple Silicon.

# electron-builder автоматично створює universal binary
npx electron-builder --mac --universal

Що входить у налаштування під ключ

Додатково: налаштування автоматичного оновлення (Sparkle, Electron auto-updater), white-label підпис, робота з Apple Developer Enterprise Program.

Типові помилки

• Використання сертифіката Apple Development замість Developer ID — підпис лише для налагодження.
• Пропуск hardenedRuntime: true — нотаризація не пройде.
• Неправильні entitlements для Electron — падіння при старті.
• Відсутність stapling — користувачі побачать попередження, якщо немає інтернету.
• Забули про universal binary — втрата продуктивності на Apple Silicon.
• Сертифікат Developer ID Application не підходить, якщо ви помилилися типом (потрібен саме Developer ID, а не Development).
• Нотаризація не проходить, якщо не включено hardenedRuntime.
• Додаток падає при старті — перевірте entitlements: для Electron обов'язкові allow-jit та allow-unsigned-executable-memory.
• Stapling не спрацьовує, якщо файл пошкоджений — виконайте stapler одразу після notarytool.

Спираючись на наш досвід, ми рекомендуємо тестувати нотаризацію на кожному релізі. Навіть заміна версії Electron може зламати entitlements.

Терміни та гарантія

Базове налаштування займає 3–4 робочих дні. Ми гарантуємо, що додаток пройде нотаризацію та буде запускатися на macOS 10.14 і новіше. Зв'яжіться з нами, щоб налаштувати підпис за 3-4 дні та уникнути блокувань Gatekeeper. Отримайте консультацію щодо вашого проєкту — ми допоможемо уникнути типових помилок та заощадити час.

Ми регулярно стикаємося з ситуацією: «Сайт не відкривається» о 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 днів.

Вартість розраховується індивідуально залежно від складності та обсягу робіт. Отримайте консультацію — оцінимо вашу архітектуру за один день.