V8unpack Cf

v8unpack-cf — распаковка и сборка бинарных файлов 1С

Утилита saby v8unpack (Python) распаковывает CF/CFE/EPF файлы 1С в человекочитаемые исходники (JSON + BSL) с деревом метаданных — без платформы 1С.

Установка: pip install v8unpack (или dev-install из репозитория).

Команды

Распаковка (-E)

python -m v8unpack -E "<файл.cf>" "<папка_исходников>" --temp "<папка_temp>"

Сборка (-B)

python -m v8unpack -B "<папка_исходников>" "<файл.cf>"

Индексация (-I)

python -m v8unpack -I "<папка_исходников>" --index index.json --core core

Генерирует/обновляет index.json — файл оглавления для раскладки исходников по подпапкам.

Пакетные операции (-EA, -BA, -IA)

python -m v8unpack -EA products.json # распаковать все продукты
python -m v8unpack -BA products.json # собрать все продукты
python -m v8unpack -BA products.json --index KEY # собрать конкретный продукт

Файл products.json описывает несколько продуктов с индивидуальными параметрами сборки.

Python API

import v8unpack

v8unpack.extract('d:/sample.cf', 'd:/src')
v8unpack.extract('d:/sample.cf', 'd:/src', temp_dir='d:/temp',
 options={'descent': 4100200, 'auto_include': True})

v8unpack.build('d:/src', 'd:/repacked.cf')
v8unpack.build('d:/src', 'd:/repacked.cf', index='index.json',
 options={'descent': 4100200, 'version': '80306'})

Примеры использования

Распаковать конфигурацию

python -m v8unpack -E "<project>/1Cv8.cf" "<project>/src" --temp "<project>/temp"

Собрать обратно

python -m v8unpack -B "<project>/src" "<project>/1Cv8_new.cf"

Распаковать внешнюю обработку

python -m v8unpack -E "МояОбработка.epf" "src_epf"

Распаковать расширение

python -m v8unpack -E "МоёРасширение.cfe" "src_cfe" --descent 3000112

Собрать расширение

python -m v8unpack -B "src_cfe" "bin/ext.cfe" --index cmd/index.json --descent 3000112 --version 80316

Совместимость версий

Версия утилиты записывается в Configuration.json ("v8unpack": "1.2.6"). При сборке проверяется совпадение major.minor. Если версии не совпадают:

1. Собрать старой версией
2. Обновить утилиту
3. Распаковать новой версией
4. Закоммитить

Промежуточные стадии (--temp)

Ограничения

• Свойства объектов и разметка форм хранятся в header / raw как сырые массивы
• Файлы > 1 МБ (макеты, HTML) хранятся как .bin без декодирования
• Зашифрованные модули сохраняются в бинарном виде
• При --auto_include вложенные объекты сортируются по алфавиту