README.md

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

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

telegram

Оглавление:

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

Самый простой и быстрый способ создания нового каталога проекта - это использования команды 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 - если вам не хватает какого-то каталога под ваши задачи
  • войдите в чат Телеграм - чтобы задать дополнительные вопросы telegram
  • сделайте 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

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

Конвейеры
0 успешных
0 с ошибкой