Обеспечение совместимости библиотек
В основном стандарт рассчитан на тех, кто занимается разработкой своих библиотек, но ознакомиться с ним точно стоит с точки зрения понимания и БСП, как самого явного примера библиотек.
#std644
1. При разработке библиотек необходимо обеспечивать обратную совместимость
...
1.5. В целях обеспечения совместимости следует
- выделить программный интерфейс библиотеки, скрыв от потребителей все остальные детали ее реализации;
- и не изменять программный интерфейс и поведение. Его допустимо только расширять.
...
2.1. Для разделения программного интерфейса от служебных процедур и функций необходимо размещать их в разных разделах модуля или в разных общих модулях.
При размещении в разных общих модулях, к модулям со служебными процедурами и функциями может быть добавлен постфикс Служебный (англ. Internal).
Например:
- Общие модули ОбменСообщениями и ОбменСообщениямиКлиент – программный интерфейс подсистемы «Обмен сообщениями»
- Общий модуль ОбменСообщениямиСлужебный – служебные процедуры и функции подсистемы, которые не предназначены для использования в коде конфигурации-потребителя.
...
3.1. При необходимости переименовать (или удалить) экспортную функцию (процедуру) следует оставить прежнюю реализацию функции, пометив ее как устаревшую с помощью комментария
Лично не встречал на своей практике сторонние библиотеки в 1С, если не брать БСП, прям чтобы это называлась библиотекой, подсистемы - да, а библиотеки - нет.
Если вы писали или знаете примеры других библиотек для 1С, кроме БСП, покидайте ссылки на них в комментариях 💬)
P.S. Пункт 2.1. когда-то попался как вопрос на собеседовании "Зачем же используется префикс "Служебный"?")
P.S. Полное описание стандарта по ссылке в начале поста
#ЧёПоСтандартам #std644