Документация для разработчиков
Темная тема

Создание дистрибутива с решением

Создание дистрибутива с решением

Начиная с седьмой версии, дистрибутив «1С-Битрикс:Управление сайтом» представляет собой два мастера: мастер установки продукта и мастер установки демо-сайта. Первый устанавливает все модули в минимальной объеме (таблицы базы данных, агенты, события, файлы). Второй - пример сайта, демонстрирующего функциональность продукта.

Для запуска своего мастера создания сайта необходимо добавить в дистрибутив мастер с названием demo. Это мастер может находится как в собственном namespace'е (в подпапке директории /bitrix/wizards/, например, /bitrix/wizards/my_company/demo/) так и непосредственно в папке /bitrix/wizards/.


Для создания дистрибутива со своим решением необходимо выполнить следующее:
  1. Изготовить мастер создания сайта, который развернет решение на сайте клиента. Мастер должен иметь название demo. В мастере может находиться лицензия решения.
  2. Скачать демо версию или дистрибутив в исходных текстах нужной редакции с сайта «1С-Битрикс». Распаковать архив.
  3. В папку /bitrix/wizards/<опциональная подпапка> скопировать свой мастер.
  4. Если в решение включаются дополнительные модули, скопировать их в папку /bitrix/modules. Модули должны удовлетворять новым требованиям инсталлятора продукта.
  5. В корне дистрибутива создать файл install.config следующей структуры:
    <config> 
    	<productName>Название продукта</productName> 
    	<welcomeText>Текст приветствия мастера</welcomeText> 
    	<imageLogoSrc>Путь к логотипу компании относительно корня сайта</imageLogoSrc> 
    	<imageBoxSrc>Путь к изображению коробки продукта относительно корня сайта</imageBoxSrc> 
    	<copyrightText>Текст копирайта</copyrightText> 
    	<supportText>Ссылки на инструкцию по установке и техподдержку </supportText> 
    </config>
  6. Если в этом файле описываются imageLogoSrc и imageBoxSrc, то скопировать эти картинки в указанные папки (можно и на корень). Если текст приветствия включает картинки, их тоже нужно скопировать.
  7. Запаковать все файлы в архив нужного формата.
  8. Если требуется создать EXE, то:
    • Скачать bitrix_win_installer.zip
    • Распаковать в любую папку
    • Скопировать все файлы проекта в папку solution
    • Запустить run.cmd
    • Изменить все необходимые параметры (если файлы не были скопированы, то указать на папку где они находятся)
    • Нажать иконку Compile;
    • Готовый дистрибутив будет в папке output

Установка дистрибутива в кодировке UTF-8

Если пользователь устанавливает продукт в кодировке UTF-8, то файлы мастера с расширениями .php, .sql, .js, .snp, .csv конвертируются в кодировку UTF-8. По умолчанию считается, что файлы мастера находятся в кодировке windows-1251. Файлы должны располагаться в папке /ru данного мастера. Например: \bitrix\wizards\bitrix\demo\modules\blog\public\ru\. Если файлы мастера созданы в другой кодировке, то необходимо ее прописать в ключе СHARSET массива $arWizardDescription (см. Файл описания мастера создания сайта).



© «Битрикс», 2001-2024, «1С-Битрикс», 2024