Перейти к содержанию

Разработка Shopify плагина

Полезные ссылки

Поставка (деплой) Shopify

Поставка (деплой) Shopify-приложения (плагина) в магазин пользователя или в Shopify App Store включает несколько этапов: от разработки до публикации.

1. Варианты поставки приложения

В Shopify есть три основных способа доставки приложения: 1. Установка в development-магазин (для тестирования).
2. Публикация в Shopify App Store (официальный маркетплейс).
3. Custom-установка (через приватную ссылку, без публикации в App Store).

2. Установка в development-магазин

Перед публикацией приложение тестируется в development-режиме.

2.1. Создание development-магазина

  1. В Shopify Partners → Development stores → Create store.
  2. Выберите тип магазина (например, "Test store").

2.2. Установка приложения через CLI

  1. Запустите сервер разработки: 
    shopify app dev
  2. Введите команду для установки: 
    shopify app tunnel auth # если используете ngrok
shopify app open
  3. Shopify CLI сгенерирует установочную ссылку, которая откроет OAuth-поток.

2.3. Проверка установки

  • Приложение появится в админке магазина → Apps.
  • Можно тестировать функционал (например, вебхуки на заказы).

3. Публикация в Shopify App Store

Чтобы приложение стало доступно всем магазинам, его нужно опубликовать.

3.1. Подготовка к публикации

  1. Проверка требований:
  2. App Store Review Checklist
  3. Обязательно: Политика конфиденциальности, Support-контакты, иконка 120x120px.
  4. Настройка App Listing:
  5. В Partners Dashboard → App Setup → App Store listing.
  6. Нужно заполнить:
    • Название, описание, скриншоты.
    • Видео-демо (рекомендуется).
    • Цены (если приложение платное).

3.2. Сборка и деплой

  1. Сборка production-версии:
    shopify app build
  2. Загрузка в Shopify:
    shopify app deploy
    (или через GitHub Actions, см. ниже).

3.3. Отправка на модерацию

  1. В Partners Dashboard → App Overview → Submit for review.
  2. Shopify проверяет:
  3. Безопасность (нет ли уязвимостей).
  4. Соответствие политикам.
  5. Работоспособность (тестируют в реальном магазине).

Срок проверки: от 3 до 14 дней.

3.4. После одобрения

  • Приложение появится в Shopify App Store.
  • Магазины смогут устанавливать его через поиск.

4. Custom-установка (без App Store)

Если вы не хотите публиковать приложение в маркетплейсе, можно распространять его через приватную ссылку.

4.1. Генерация установочной ссылки

  1. В Partners Dashboard → App Setup → App URL.
  2. Скопируйте установочный URL вида:
    https://{your-app-url}/auth?shop={shop-name}.myshopify.com
  3. Отправьте его клиенту вручную.

4.2. Ограничения

  • Приложение не будет в Shopify App Store.
  • Нужно самостоятельно заниматься поддержкой и обновлениями.

5. Непрерывная поставка (CI/CD)

Чтобы автоматизировать деплой через GitHub Actions или аналоги.

5.1. Пример workflow для GitHub Actions (.github/workflows/deploy.yml)

name: Deploy Shopify App
on: push
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
      - run: npm ci
      - run: shopify app deploy --client-id=${{ secrets.SHOPIFY_API_KEY }} --client-secret=${{ secrets.SHOPIFY_API_SECRET }}

5.2. Настройка переменных в GitHub Secrets

  1. SHOPIFY_API_KEY – из Partners Dashboard.
  2. SHOPIFY_API_SECRET – из Partners Dashboard.

Теперь при push в main приложение будет автоматически деплоиться.

6. Обновление приложения

Если внесены изменения, нужно:
1. Увеличить версию в shopify.app.toml.
2. Задеплоить обновление:

shopify app deploy
3. Магазины получат уведомление о доступном обновлении.

Итог: схема поставки

  1. Development → Установка в тестовый магазин через shopify app dev.
  2. Production → Сборка (shopify app build) + деплой (shopify app deploy).
  3. App Store → Подача на модерацию.
  4. Custom-установка → Приватная ссылка для клиентов.