yukon39/vanessa-bootstrap

Шаблон правильной разработки на 1С

Шаблон для работы правильного 1С разработчика

• содержит выработанную и обдуманную семантически структуру каталогов
• содержит необходимые команды для быстрого старта

Оглавление:

• Быстрое использование
• Использование шаблона
  • Порядок установки
  • Порядок обновления
  • Возможности доработки шаблона
• Первичная настройка
• Полезные команды
• Полезные ссылки

Быстрое использование

Самый простой и быстрый способ создания нового каталога проекта - это использования команды vanessa-runner

Запуск vrunner init-project в пустом каталоге создаст необходимую структуру проекта

Использование шаблона

Порядок установки

• переключитесь в пустой рабочий каталог своего продукта

cd название-вашего-продукта-1С

• склонируйте репозиторий

git clone https://github.com/vanessa-opensource/vanessa-bootstrap.git .

• важно: не потеряйте точку в конце строки команды

• подпишитесь на обновление шаблона

git remote add -f --no-tags -m --mirror bootstrap https://github.com/vanessa-opensource/vanessa-bootstrap.git
git remote remove origin

• подключите репозиторий к своему git серверу (GitHub, Bitbucket, GitLab, etc)

git remote add origin git://new.url.here

• получите изменения из своего репозитория

git pull origin ваша-ветка --allow-unrelated-histories

• исправьте полученные конфликты, если вы меняли те же файлы, что есть в шаблоне

теперь вы можете начинать разрабатывать по-правильному и быть подписанными на любые изменения.

Порядок обновления

Чтобы получить изменения каталога

git pull bootstrap ваша-текущая-ветка-разработки

Возможности доработки шаблона

• откройте issue - если вам не хватает какого-то каталога под ваши задачи
• войдите в чат Телеграм - чтобы задать дополнительные вопросы
• сделайте fork, внесите изменения и выполните pull request с предлагаемыми вами изменениями (fork и pull request - это кнопки на GitHub.)

Первичная настройка

• настройте файл env.json для выполнения команд
  • задайте версию платформы 1С - ключ --v8version
  • задайте строку соединения разработческой ИБ - ключ --ibconnection
  • задайте строку доступ к этой ИБ - ключи --db-user и --db-pwd
  • скорректируйте настройку локализации - ключи --locale и --language
  • задайте вид клиента - ключ --ordinaryapp - тонкий (-1) или толстый (1) клиент
• сделайте отдельные файлы для отдельных команд, например, tools/JSON/vrunner.json

Полезные команды

• Первичная настройка
  • prepare.cmd
    • в папке build создается cf из исходников
    • создается служебная ИБ в build/ib или той, что прописана в env.json
    • выполняется обновление в режиме 1С:Предприятие
• Обновление (сборка) из исходников
  • update.cmd
    • в папке build создается cf из исходников
    • в папке build также могут создаваться расширения и другие внешние файлы
    • полученный cf загружается в служебную ИБ
    • обновляется служебная ИБ
    • выполняется обновление в режиме 1С:Предприятие
• Подготовка артефактов из исходников
  • build.cmd
    • в папке build создается cf из исходников
    • в папке build также могут создаваться расширения и другие внешние файлы
• Быстрый прогон BDD-сценариев в служебной ИБ
  • test.cmd
• Быстро открыть служебную ИБ в режиме 1С:Предприятие
  • open.cmd
• Быстро открыть Конфигуратор служебной ИБ
  • designer.cmd

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