Імпорт ігор

Spark підтримує кілька методів імпорту ігор Ren’Py на ваш iOS-пристрій.

• ZIP (.zip) — Найпоширеніший
• APK (.apk) — Пакети Android
• 7-Zip (.7z) — Високе стиснення
• RAR (.rar) — Підтримка застарілих форматів
• TAR (.tar) — Нестиснені архіви
• Gzip (.gz) — TAR-архіви, стиснені Gzip
• BZ2 (.bz2) — TAR-архіви, стиснені Bzip2
• IPA (.ipa) — Архіви додатків iOS
• APP (.app) — Пакети додатків

1. Відкрийте Spark і натисніть кнопку Імпорт у бібліотеці
2. Перейдіть до архіву гри за допомогою системного вибору файлів
3. Виберіть файл і дочекайтесь завершення розпакування

Spark перевіряє архів перед розпакуванням:

• Обчислює розмір без стиснення, щоб перевірити наявність достатнього вільного місця
• Визначає, чи архів захищений паролем, і запитує його при потребі
• Сканує вміст архіву для знаходження папки game/

Якщо в архіві знайдено кілька папок ігор, вам буде запропоновано вибрати, яку імпортувати.

Архів розпаковується у тимчасовий каталог. Spark контролює дисковий простір під час розпакування і зупиниться, якщо сховище стане критично малим. Папки артефактів macOS (__MACOSX) автоматично видаляються.

Для подвійно запакованих APK-файлів (ZIP, що містить APK всередині), Spark це виявляє і автоматично розпаковує обидва рівні.

Після розпакування Spark організовує файли в кінцевий каталог гри:

• Папка гри — Папка game/, що містить скрипти, ресурси та архіви, переміщується на остаточне місце
• Назва гри — Визначається з android.json (імпорт APK), файлу .py поруч із папкою гри або назви файлу архіву як запасний варіант
• Унікальне іменування — Якщо гра з такою ж назвою вже існує, додається числовий суфікс

Spark шукає серед розпакованих файлів вбудовану папку рушія Ren’Py (renpy/). Якщо знайдено:

• Рушій зберігається в каталозі advanced/renpy/ гри для використання з Advanced Mode
• Версія Ren’Py зчитується з файлів версій усередині папки рушія (наприклад, vc_version.py, __init__.py, script_version.txt або їх скомпільовані еквіваленти)
• Виявлена версія зберігається в метаданих гри для підбору рушія
• Для імпорту Android APK вбудований файл (private.mp3) розпаковується для відновлення рушія та визначення версії Python

• Користувацькі шрифти — Якщо вбудований рушій гри містить модифіковані шрифти (відмінні від стандартних Ren’Py), вони копіюються до папки гри для використання під час виконання
• Підтримка Live2D — Архів сканується на наявність бібліотек Live2D. Якщо знайдено, створюється маркер, щоб Spark завантажував фреймворк Live2D при запуску гри

• Записується файл info.json із назвою гри, визначеною версією рушія, оригінальною назвою архіву та міткою часу імпорту
• Тимчасові каталоги очищаються, а тимчасові файли видаляються
• Бібліотека ігор оновлюється, і нова гра з’являється у вашій бібліотеці

• Великі ігри (1 ГБ+) можуть розпаковуватися довго
• Деякі формати архівів, такі як 7z, можуть розпаковуватися надзвичайно довго, якщо архів містить тисячі окремих файлів. Ігри в ідеалі повинні бути запаковані за допомогою архівів .rpa або подібних консолідованих форматів. Деякі бібліотеки розпакування не оптимізовані для таких сценаріїв
• Якщо гра з’являється, але не запускається, спробуйте змінити версію рушія в Game Settings
• APK-файли можуть бути приховані фільтром файлів — вимкніть його в Settings > Game Library