Инструмент для создания пакетов ресурсов resources_packer

Resources_packer — это простой и удобный инструмент для автоматического создания пакетов обновлений ресурсов игры.

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

Предположим, что нам нужно упаковать директорию testdir.

• testdir
  • test1.txt
  • test2.txt

Выполните следующую команду с действием check:

resources_packer -paths testdir -package-name TestPackage -artifact-dir testdirOutput -action check

В результате в директории testdirOutput, которая находится на одном уровне с testdir, будут созданы следующие файлы:

• testdirOutput
  • TestPackage.0.zip
  • TestPackage.0.zip.md5
  • TestPackage.resource_version.txt

Теперь мы имеем 0-ый пакет ресурсов. Добавим несколько различий: добавим новый файл test3.txt в директорию testdir.

Структура директории testdir изменится следующим образом:

• testdir
  • test1.txt
  • test2.txt
  • test3.txt

Выполните следующую команду с действием pack:

resources_packer -paths testdir -package-name TestPackage -artifact-dir testdirOutput -action pack

Теперь директория testdirOutput будет содержать следующие файлы:> - testdirOutput --> Выходная директория

• TestPackage.0.zip --> Полностью созданный 0-й пакет ресурсов, содержащий файлы test1.txt и test2.txt
• TestPackage.0.zip.md5 --> MD5-сумма для метода 0-го пакета ресурсов
• TestPackage.0-1.zip --> Разница между 0-м и 1-м пакетами ресурсов
• TestPackage.0-1.zip.md5 --> MD5-сумма для пакета 0-1
• TestPackage.1.zip --> Полностью созданный 1-й пакет ресурсов
• TestPackage.1.zip.md5 --> MD5-сумма для 1-го пакета ресурсов
• TestPackage.resource_version.txt --> Последняя версия пакета TestPackage (теперь значение равно 1)
  Хорошо, дифференциальный ресурсный пакет 0-1 был создан таким образом.Почему существует полный пакет и дифференциальный пакет одновременно? Потому что создание дифференциального пакета основано на сравнении двух полных пакетов друг с другом.

Какие особенности у сгенерированного zip-пакета?

• .manifest Записывает размер, MD5 и другие данные файлов (независимо от того, являются ли они различиями или нет, все директории и файлы)
• OTHER1
• OTHER2
• OTHER3/OTHER4.txt

Кратко говоря, в сгенерированном ресурсном zip-пакете файл .manifest в корневой директории создаётся ресурсами_пакером, а остальные файлы — это те ресурсы, которые вы установили.

Как получить помощь через командную строку?

Вы можете получить подробную помощь через командную строку следующими способами:

На Linux/Unix:

resources_packer --help

На Windows требуется предварительная установка Python-среды:

resources_packer.bat --help

или

python resources_packer --help

Режимы работы с пакетами

Утилита resources_packer имеет несколько различных режимов работы, чтобы адаптироваться к различным ситуациям.

Проверка или создание (check/init)

Часто используется. Проверяет наличие текущего версионного ресурсного пакета, если его нет, то создаёт новый. Если есть, то ничего не делает.

Если до этого момента ни одного ресурсного пакета ещё не было создано, будет создан пакет номер 0. Если же уже существует пакет номер 0, никаких действий не производится.### Дифференциальное упаковывание (pack) Основной. Создание дифференциального ресурсного пакета увеличивает версию ресурсов.

Если имеется пакет номер 0, выполнение действия pack приведёт к тому, что будут сравниваться файлы пакета номер 0 со всеми текущими ресурсами. Различия будут собраны в пакет номер 1.

Инициализация (init)

Принудительно перегенерирует текущую версию дифференциального пакета.

Если текущая версия ресурсов равна 10, после выполнения init будет перегенерирован пакет версии 10, который заменит предыдущий пакет версии 10.

Инициализацию обычно выполняют крайне редко, она используется тогда, когда вы хотите перегенерировать дифференциальные файлы, но при этом не хотите менять текущую версию ресурсов.

Очистка (clean)

Очищает старые версии zip-пакетов. Если текущая самая новая версия равна 3, фактически используются только пакеты 1-3, 2-3 и 0-3. Старые версии, такие как 0-2 и 1-2, больше не нужны. Выполнение clean приведёт к перемещению этих пакетов в каталог archives, однако они не будут удалены, чтобы обеспечить надёжность.