Переход на новую версию 1С:EDT без потери проектов и настроек

Чтобы обновить 1С:EDT, не нужно удалять старую версию и не нужно «накатывать» обновление поверх. Новая версия ставится рядом через установщик 1C:EDT Start, затем вы открываете в ней копию рабочей области. Старая версия остаётся на диске и служит запасным вариантом.

Частое заблуждение — что обновление EDT сродни обновлению конфигурации: нажал кнопку, и всё. На деле EDT при первом открытии старой рабочей области может перевести проекты в новый формат. После этого прежняя версия их уже не всегда откроет. Поэтому порядок такой: подготовка, установка, проверка Java и памяти, и только потом перенос проектов.

1. Подготовка к обновлению EDT: версия, требования, резервная копия

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

Откройте в EDT меню Справка и пункт «О программе». В окне будет номер вида 2024.2.5 — год выпуска, номер ветки и номер исправления. Запишите его: он понадобится, если придётся откатываться.

Номер установленной версии виден и в установщике 1C:EDT Start — там отображается список всех версий, что стоят на компьютере.

Что проверить перед установкой

• 💻 Память. EDT держит модель конфигурации в оперативной памяти. Для «Бухгалтерии» на практике комфортно 16 ГБ RAM, для ERP и КА — 32 ГБ.
• 💾 Диск. Сама среда занимает пару гигабайт, но рабочая область с крупной конфигурацией легко вырастает до 10–20 ГБ. Лучше SSD.
• ☕ Java. Каждая ветка EDT требует определённую версию JDK. Свежие версии работают на Java 17, старые ветки — на Java 11. Точное требование смотрите в описании выпуска.
• 🧩 Платформа. Каждая версия EDT поддерживает ограниченный набор версий платформы 1С:Предприятие 8.3. Если проект ведётся под старую платформу, проверьте, что новая EDT её ещё поддерживает.

Резервная копия рабочей области

Рабочая область (workspace) — это папка, где лежат проекты и служебная папка .metadata с настройками среды. Перед обновлением:

1. Закоммитьте и отправьте в удалённый репозиторий все изменения проектов.
2. Закройте EDT.
3. Скопируйте папку рабочей области целиком, например D:\EDT\ws → D:\EDT\ws_2024.2_backup.

2. Где скачать новую версию 1С:EDT и какой дистрибутив выбрать

Дистрибутивы EDT публикуются на портале обновлений 1С, releases.1c.ru, в разделе 1C:Enterprise Development Tools. Нужна учётная запись портала. Вместе с дистрибутивом там лежит описание выпуска: в нём — список изменений, поддерживаемые версии платформы и требования к Java.

Обычно доступны два вида дистрибутива:

Дистрибутивы выпускаются для Windows, Linux и macOS. Скачивайте сборку под свою ОС и разрядность — EDT работает только в 64-битной системе.

3. Установка новой версии через 1C:EDT Start

Пошагово

1. Распакуйте архив и запустите установщик от имени пользователя с правами администратора.
2. В списке компонентов отметьте нужную версию EDT. Старую версию не удаляйте.
3. Дождитесь окончания установки. В Windows компоненты по умолчанию попадают в каталог C:\Program Files\1C\1CE\components\, каждая версия — в свою папку.
4. Запустите 1C:EDT Start. В нём появится новая версия рядом со старой.
5. Выберите новую версию и укажите рабочую область: новую пустую папку или копию старой.

Первый запуск

На первом запуске EDT пересобирает проекты: строит модель, индексирует код, выполняет проверки. Для типовой «Бухгалтерии» это может занять от нескольких минут до получаса, для ERP — дольше. Не прерывайте процесс: прогресс виден в правом нижнем углу окна и в представлении «Ход выполнения».

Если вы открываете старую рабочую область, EDT может спросить о конвертации проектов. Соглашайтесь только на копии — после конвертации предыдущая версия может не открыть проекты.

Привязка информационных баз

Список информационных баз EDT берёт из общего списка 1С:Предприятия, поэтому базы обычно видны сразу. Но связь «проект — база» хранится в рабочей области. В новой пустой области её придётся восстановить:

1. Откройте представление «Информационные базы».
2. Перетащите нужную базу на проект или выберите привязку в контекстном меню проекта.
3. При первой синхронизации EDT сравнит конфигурацию проекта и базы. Если в базе есть изменения, которых нет в проекте, среда предложит выбрать, что принять.

4. Java, переменные среды и параметры запуска EDT

Это самый частый источник проблем после обновления. Новая версия EDT может требовать более свежую Java, чем стояла раньше.

Какую Java ставить

Нужен 64-битный JDK нужной версии. Для EDT традиционно рекомендуют сборки Liberica JDK или Axiom JDK в полном варианте (Full JDK, с JavaFX). Свежие дистрибутивы EDT могут ставить JDK сами — после установки проверьте, какая Java на самом деле используется.

Файл 1cedt.ini

В папке каждой версии EDT лежит файл 1cedt.ini. Это обычный файл параметров запуска Eclipse. Два параметра в нём важны больше всего:

• -vm — путь к Java, на которой запускается среда;
• -Xmx — сколько памяти EDT может забрать под себя.

Пример фрагмента:

-vm
C:\Program Files\BellSoft\LibericaJDK-17-Full\bin\javaw.exe
-vmargs
-Xms2g
-Xmx8g

Строка -vm и путь — на разных строках, и обе стоят до -vmargs. Всё, что после -vmargs, передаётся уже самой Java.

После обновления проверьте, что -Xmx в новом 1cedt.ini такой же, как вы настраивали раньше. Настройка памяти в новую версию сама не переносится: у каждой версии свой файл.

Переменные среды

Если -vm в 1cedt.ini не задан, EDT ищет Java через переменные окружения. В Windows их задают так: Панель управления → Система → Дополнительные параметры системы → Переменные среды.

• JAVA_HOME — путь к корню JDK, например C:\Program Files\BellSoft\LibericaJDK-17-Full.
• PATH — добавьте %JAVA_HOME%\bin и поднимите эту строку выше других путей к Java.

Проверка в командной строке:

echo %JAVA_HOME%
java -version

Если java -version показывает старую версию, значит, раньше в PATH стоит другая Java. Явный -vm в 1cedt.ini снимает эту проблему для EDT, не трогая другие программы.

Нужен ли отдельный Eclipse

Нет. 1С:EDT уже построена на платформе Eclipse и ставится со своей сборкой. Отдельный Eclipse может понадобиться только для сторонних задач — например, если вы параллельно пишете на Java. Ставить в него EDT как набор плагинов не нужно.

Плагины после обновления

Плагины, установленные в старую версию, в новую не переезжают. Их ставят заново через меню Справка → Установить новое ПО, указав адрес сайта обновлений плагина или локальный архив.

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

5. Проверка после обновления и ошибки при запуске EDT

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

1. Проект собрался без новых ошибок в представлении «Ошибки конфигурации» (сравните счётчик со старой версией).
2. Запуск отладки в файловой базе проходит.
3. Синхронизация с базой работает в обе стороны.
4. Git видит репозиторий, история и ветки на месте.

Ошибки, которые чаще всего встречаются после обновления:

Версия платформы, под которую ведётся проект, записана в файле DT-INF/PROJECT.PMF в строке Runtime-Version. Менять её стоит осознанно: это влияет на режим совместимости и доступные возможности.

6. Как обновлять EDT в команде и корпоративной сети

Когда над одной конфигурацией работают несколько разработчиков, обновление EDT — решение команды, а не каждого.

• 🤝 Одна версия на команду. Разные версии EDT могут по-разному сохранять файлы проекта. Итог — лишние изменения в коммитах и конфликты слияния.
• 📅 Переход в один день. Договоритесь о дате, когда все переходят на новую версию. До неё никто не коммитит из новой EDT.
• 🧪 Пилот. Один человек обновляется первым, неделю работает и фиксирует проблемы. Остальные переходят после него.
• 🌐 Прокси. Онлайн-установщику и установке плагинов нужен выход в интернет. Если он идёт через прокси, задайте его в EDT: Окно → Параметры → Общие → Сетевые подключения. В закрытом контуре используйте офлайн-дистрибутив.
• 🛡 Антивирус. Добавьте папку рабочей области в исключения проверки «на лету». Пересборка проекта создаёт десятки тысяч мелких файлов, и антивирус заметно её тормозит.
• 📦 Локальное зеркало. Положите проверенный дистрибутив и плагины в общую сетевую папку, чтобы все ставили одно и то же.

7. Как откатиться на предыдущую версию EDT

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

1. Закройте новую EDT.
2. В 1C:EDT Start выберите прежнюю версию.
3. Укажите резервную копию рабочей области, а не ту, что открывали в новой версии.
4. Если копии нет — создайте пустую рабочую область и импортируйте проекты из Git.
5. Восстановите привязки к информационным базам.

Если удалённый репозиторий тоже успел получить коммиты из новой версии, проверьте их перед откатом. Изменения кода переносятся без проблем, а служебные файлы проекта, изменённые новой EDT, лучше откатить вместе с версией среды.

Удалять старую версию стоит только после пары недель спокойной работы в новой. Удаление делается тем же установщиком 1C:EDT Start.

8. Автоматизация обновления EDT

Для одного разработчика автоматизация избыточна. Она окупается, когда машин десяток или EDT работает на сервере сборки.

Тихая установка

В составе дистрибутива есть консольный вариант установщика — 1ce-installer-cli. Он позволяет ставить EDT без окон, из скрипта или системы управления конфигурациями. Список команд и ключей выводит встроенная справка утилиты: ключи меняются между выпусками, поэтому сверяйтесь со справкой той версии, которую ставите.

EDT на сервере сборки

Для CI используют утилиту командной строки 1cedtcli. Она умеет импортировать проекты, выгружать их в файлы конфигурации и выполнять проверки без графической среды.

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

1. Ставите новую версию рядом со старой.
2. Создаёте отдельный сборочный конвейер, который вызывает новую 1cedtcli.
3. Прогоняете его на копии ветки и сравниваете результат со старым.
4. Переключаете основной конвейер, когда результаты совпали.

Версию EDT в скриптах фиксируйте явно, путём к конкретной папке. Ссылка «на последнюю установленную» однажды сломает ночную сборку без предупреждения.

Частые вопросы об обновлении 1С:EDT