Установка React Gantt

React Gantt доступен в двух дистрибутивах:

1. Версия для оценки общедоступна на npm, включает водяной знак для оценки и может дополнительно сопровождаться бесплатным периодом оценки, который предоставляет доступ к технической поддержке.
2. Профессиональная (коммерческая) версия доступна из приватного npm-репозитория DHTMLX и предназначена для использования в продакшне.

Обе упаковки содержат один и тот же API.

Установка Оценочной версии (публичный npm)

Оценочная сборка доступна в npm как @dhtmlx/trial-react-gantt:

npm install @dhtmlx/trial-react-gantt

Или с Yarn:

yarn add @dhtmlx/trial-react-gantt

Эта сборка полностью функциональна, но отображает сообщение о том, что библиотека работает в режиме оценки.

Опционально: начать полный период оценки (рекомендуется)

Хотя пакет для пробной версии устанавливается без ограничений, вы также можете начать официальную оценку через сайт по адресу https://dhtmlx.com/docs/products/dhtmlxGantt-for-React/download.shtml.

Начало формальной оценки предоставляет вам бесплатную техническую поддержку в течение пробного периода.

Загрузка офлайн-примеров (zip)

Форма оценки также включает ZIP-файл с примерами, готовыми к офлайн-использованию.

Вы также можете изучить дополнительные примеры и демо-проекты на официальном GitHub, просмотрев Демо React Gantt на GitHub.

Профессиональная версия (частный npm)

Профессиональная версия предназначена для использования в продукционных приложениях и включает коммерческую лицензию и полный доступ к технической поддержке.

После получения коммерческой лицензии вы можете сгенерировать учетные данные для приватного npm в вашей Клиентской зоне.

После генерации логина/пароля настройте npm:

npm config set @dhx:registry=https://npm.dhtmlx.com
npm login --registry=https://npm.dhtmlx.com --scope=@dhx

Затем установите пакет Professional:

npm install @dhx/react-gantt

Или, с Yarn:

yarn add @dhx/react-gantt

Переход от пробной версии к коммерческой

Большинство проектов начинают с пробной версии и затем переключаются, после утверждения прототипа и наличия коммерческой лицензии. Оба пакета имеют один и тот же API, поэтому переход в основном механический: поменять имя пакета, поменять импорт CSS и переустановить.

После настройки приватного реестра, как показано выше, обновите каждый импорт в коде:

// до
import Gantt from "@dhtmlx/trial-react-gantt";
import "@dhtmlx/trial-react-gantt/dist/react-gantt.css";

// после
import Gantt from "@dhx/react-gantt";
import "@dhx/react-gantt/dist/react-gantt.css";

Поиск по проекту любых оставшихся упоминаний @dhtmlx/trial-react-gantt, включая путь импорта CSS - его легко забыть. Замените зависимость в package.json, затем npm install и запустите приложение. Если водяной знак исчезнет и остальная часть интерфейса будет вести себя идентично, переход выполнен.

Использование реестра из CI или общих сред сборки

npm login нормально работает на рабочей машине разработчика, но CI-раннеры и другие общие среды сборки обычно не поддерживают интерактивный вход в систему. Для таких случаев сгенерируйте неинтерактивный токен доступа на машине с входом в систему:

npm token create --registry=https://npm.dhtmlx.com

Токен будет напечатан один раз в выводе терминала — сохраните его перед закрытием сессии, так как позже его нельзя будет получить. Затем разместите его через файл .npmrc, который сборка сможет прочитать:

registry=https://npm.dhtmlx.com
//npm.dhtmlx.com/:_authToken=${DHTMLX_NPM_TOKEN}

Установите переменную DHTMLX_NPM_TOKEN в секрете вашего CI-провайдера (GitHub Actions, GitLab и т. п.), чтобы токен никогда не попал в репозиторий. Та же схема работает и для сборок в Docker — инжектируйте токен во время сборки, а не закладывайте его в образ. Если npm install терпит неудачу в CI с кодами 401 или 403 к npm.dhtmlx.com, секрет может быть отсутствующим, истёкшим или файл .npmrc размещён не там (наиболее надёжное место — корень проекта).

Конструкторы AI-приложений (Lovable и подобные)

Конструкторы AI-приложений, такие как Lovable, запускают свои собственные окружения сборки, и как только вы переключитесь на @dhx/react-gantt, каждый запуск npm install должен проходить аутентификацию против https://npm.dhtmlx.com.

После смены пакета существует два разумных пути:

• Продолжать сборку в Lovable. Прикрепите учетные данные реестра DHTMLX к окружению сборки Lovable, обычно в виде секрета, который записывается в .npmrc во время установки, используя тот же шаблон ${DHTMLX_NPM_TOKEN}. Точный механизм хранения секретов сборки — задача платформы Lovable и может со временем меняться — смотрите текущую документацию Lovable при настройке.
• Перенести сборку в ваш собственный CI. Многие команды используют Lovable для прототипирования и выполняют продакшн-сборку на Vercel, Netlify, GitHub Actions или подобных платформах, которые поддерживают прикрепление npm-токена как секрета. В такой схеме замена пробной версии коммерческой чаще всего завершается по мере настройки конвейера развертывания, и Lovable не требует учетных данных, потому что он больше не выполняет установку.

Если сборка Lovable завершается с 40x на npm.dhtmlx.com и вы не можете корректно внедрить секрет, путь переноса в CI надёжнее.

Дальнейшие шаги

После установки продолжайте с:

• Quick Start
• Overview
• Basics
• Руководства по интеграциям фреймворков