Game Distribution (Українська)

Коли ви зробите свою гру, ви, безумовно, захочете поділитися нею з іншими. Для цього звичайно треба створити файл .love. Потім можна або передати цей файл іншим (щоб зіграти в таку гру, гравцям потрібно спочатку встановити LÖVE), або створити на його основі пакети для конкретних платформ.

Ось найбільш зручні способи розповсюдження ігор на різних платформах (для всіх них потрібен файл .love):

Створення файлу .love

Зверніть увагу, що в деяких операційних системах великі і малі літери в назвах файлів та директорій вважаються різними літерами. Щоб у вас не було проблем, переконайтеся, що назви файлів в коді та на диску написані однаково.

Щоб створити файл .love, треба створити файл zip усієї директорії з грою. Переконайтеся, що файл main.lua знаходиться в корені архіву. Тобто якщо ваші файли зберігаються так:

   <somedir>\SuperGame\gfx\character.png
   <somedir>\SuperGame\main.lua
   <somedir>\SuperGame\conf.lua

то в zip-архіві вони мають зберігатися так:

   gfx\character.png
   main.lua
   conf.lua

Не треба включати директорію гри SuperGame\.

Після створення .zip-файлу просто перейменуйте його з .zip в .love, і все готово!

Якщо ви працюєте на системі, яка не розрізняє великі та малі літери в іменах файлів (наприклад, в Windows), рекомендується перенести свій файл .love в іншу директорію, запустити його звідти і протестувати гру. Таким чином можна знайти проблеми з різними іменами файлів, з якими можуть зіштовхнутися інші гравці або гравчині. Якщо ви запускатимете гру в тій же директорії, то навіть якщо .love не знайде в архіві якісь файли, він відкриє їх копію з диску. Для тестування зручно перенести файл .love в нову директорію всередині директорії гри, наприклад, love/MyGame.love.

Створення пакетів на різних платформах

Windows

В Windows вбудована можливість створення zip-файлів через контекстне меню. Детальніше див. в інструкції Запакування та розархівування файлів.

macOS

В директорії гри оберіть файли гри та під-директорії, натисніть правою кнопкою миші/з затиснутим Ctrl, після чого оберіть Compress n items (Запакувати N елементів). Після цього перейменуйте створений файл .zip, щоб в нього було закінчення .love ending.

Альтернативний варіант — використати термінал. Зайдіть в папку гри та виконайте таку команду:

   zip -9 -r SuperGame.love .

Linux

В командному рядку, якщо вашою активною директорією є SuperGame/, файл .love можна створити таким чином:

   zip -9 -r SuperGame.love .

Створення виконуваного файлу для Windows

Після запакування гри в файл .love, можна створити виконуваний файл, щоб гра запускалася напряму.

Для цього потрібно додати зміст вашого файлу .love до файлу love.exe з офіційного .zip-файла LÖVE. Об'єднаний виконуваний файл і буде використовуватися для запуску гри.

Коли у вас буде об'єднаний виконуваний файл гри, його можна буде запакувати разом з файлами DLL та іншими файлами з офіційного .zip-файлу LÖVE в новий .zip-файл, і передавати його кому завгодно.

Зауваження: Не у всіх є 64-бітна версія Windows, тому краще або створити і 32-, і 64-бітну версію вашої гри, або розповсюджувати тільки 32-бітну версію.

Інструкції для різних платформ

Windows

Щоб створити виконуваний файл в Windows, виконайте в командному рядку таку команду:

   copy /b love.exe+SuperGame.love SuperGame.exe

Зауваження: Можливо, вам доведеться виконати цю команду як адміністратор комп'ютера. Для цього можна зайти в папку Windows\System32, натиснути правою кнопкою миші на файл cmd.exe і вибрати варіант Run as administrator (Запустити як адміністратор). Після цього потрібно набрати cd C:\Program Files\LOVE\ (замініть це на шлях до директорії з LÖVE) і виконати команду там.

Альтернативний спосіб: можна створити файл .bat (наприклад, create_game_exe.bat), записати в ньому такий текст:

   copy /b love.exe+%1 "%~n1.exe"

і просто перетягнути ваш файл SuperGame.love на .bat-файл — після цього буде створено файл SuperGame.love.exe, який можна розповсюджувати.

Якщо ви використовуєте PowerShell замість cmd, то команда буде трошки інакшою:

   cmd /c copy /b love.exe+SuperGame.love SuperGame.exe

Цей метод створює приєднану (fused) до програми гру.

Значок для Windows

Значок своєї гри можна змінити програмами на кшталт безкоштовного Resource Hacker (англ.).

Є відеоурок (англ.) та покрокова інструкція (англ.).

Linux / macOS

В Linux та macOS можна створити виконуваний файл для Windows з командного рядка.

Спочатку завантажте офіційний 32-бітний або 64-бітний виконуваний файл в архіві ZIP (zipped, не встановлювач) з https://www.love2d.org/. 32-бітні ігри можна виконувати і на системах з 64-бітним Windows, але навпаки робити не можна. Тому, щоб тратити менше часу, для невеличких ігор вистачить тільки 32-бітної версії.

Після цього в командному рядку/терміналі виконайте таку команду:

   cat love.exe SuperGame.love > SuperGame.exe

щоб отримати ігровий виконуваний файл SuperGame.exe.

Для розповсюдження гри треба разом з виконуваним файлом додати файли .dll з тої директорії, в якій був файл love.exe (важливо не переплутати 32-бітні .dll-файли з 64-бітними). Якщо їх не додати, при запуску SuperGame.exe в Windows буде виводитися помилка.

В результаті ваш фінальний архів має виглядати приблизно так:

  • SDL2.dll
  • OpenAL32.dll (зауваження: 64-бітній версія цього файла відрізняється від 32-бітної, хоч назва в нього і залишиться 'OpenAL32.dll')
  • SuperGame.exe
  • license.txt (зауваження: згідно з ліцензією, її обов'язково треба копіювати при копіюванні файлів)
  • love.dll
  • lua51.dll
  • mpg123.dll
  • msvcp120.dll
  • msvcr120.dll

Створення застосунку macOS

Якщо ви хочете створити офіційний/комерційний пакунок (наприклад, для Mac App Store), див. наступний розділ Офіційне розповсюдження та App Store.

Коли ви підготувати файл .love зі своєї грою, його можна зробити доступним для гравців та гравчинь з системою macOS, виконавши описані кнопки (також є відеоурок англійською):

  1. Завантажте і розпакуйте версію LÖVE для Mac з the домашньої сторінки LÖVE
  2. Переіменуйте love.app в SuperGame.app
  3. Скопіюйте SuperGame.love в SuperGame.app/Contents/Resources/ (в macOS натисніть правою кнопкою миші/утримуючи Ctrl в оберіть "Показати зміст пакунку" / "Show Package Content"). В результаті гра буде працювати в об'єднаному режимі.
  4. Змініть SuperGame.app/Contents/Info.plist (див. нижче)
  5. Запакуйте папку SuperGame.app в формат ZIP (напр. SuperGame_osx.zip) і розповсюджуйте її. Включіть флаг -y zip-архіву, щоб зберегти символічні посилання.

Коли будете міняти SuperGame.app/Contents/Info.plist, обов'язково змініть текст в наступних XML-тегах:

  • CFBundleIdentifier
  • CFBundleName

і видаліть розділ UTExportedTypeDeclarations, щоб macOS не зв'язав .love-файли інших ігор з вашою грою. В цілому зміни мають виглядати приблизно так:

Оригінальний Info.plist Змінений Info.plist
   ...
   <key>CFBundleIdentifier</key>
   <string>org.love2d.love</string>
   ...
   <key>CFBundleName</key>
   <string>LÖVE</string>
   ...
   <key>NSPrincipalClass</key>
   <string>NSApplication</string>
   <key>UTExportedTypeDeclarations</key>
   <array>
   ...
   </array>
   </dict>
   </plist>
   ...
   <key>CFBundleIdentifier</key>
   <string>com.SuperCompany.SuperGame</string>
   ...
   <key>CFBundleName</key>
   <string>SuperGame</string>
   ...
   <key>NSPrincipalClass</key>
   <string>NSApplication</string>
   </dict>
   </plist>

Офіційне розповсюдження та App Store

Щоб скомпілювати програми для Mac, потрібен комп'ютер з системою macOS, на якому встановлено XCode (XCode можна встановити з App Store).

  1. Завантажте програмний код Löve
  2. Завантажте потрібні фреймворки звідси і розмістіть їх в директорії /Library/Frameworks/.
  3. Відкрийте проєкт Xcode в файлі platform/xcode/love.xcodeproj. Вам треба буде скомпілювати ціль love-macosx, що буде описано нижче.
  4. В XCode змініть значки для macOS в Images.xcassets
  5. В XCode змініть файл love-macosx.plist (див. інструкції вище)
  6. Додайте ваш файл .love на етапі збірки "Copy Bundle Resources" (Скопіювати ресурси пакунку)
    addLoveFileToXcodeBundleResources.png
  7. Виконайте інструкцію Apple для розповсюдження програм для Mac


Розповсюдження в Linux

В Linux поки що немає простого способу розповсюдження ігор. Основний підіх — дати посилання на офіційні пакунки LÖVE на https://www.love2d.org. Після встановлення LÖVE файли .love звичайно запускаються автоматично, або такою командою в командному рядку:

love SuperGame.love

Обов'язково додайте файл conf.lua і вкажіть в ньому використану версію LÖVE.

function love.conf(t)
    t.version = "11.2"
end

Часта помилка — спроба приєднати до лінуксової програми файл .love:

cat /usr/bin/love SuperGame.love > SuperGame
chmod a+x ./SuperGame

Вважайте, що хоч `SuperGame` і запуститься на вашому комп'ютері, в інших дистрибутивах Linux може бути інша архітектура або інші версії бібліотек, тому є велика імовірність, що на інших комп'ютерах з Linux вона не запуститься.

Linux

Поки що не гарантується, що цей метод буде працювати у всіх можливих ситуаціях, але можна попробувати його для розповсюдженні ігор в Linux.

  1. Завантажте актуальну версію LÖVE для Linux (з розширенням .tar.gz), або x86_64, або i686. Сторінка завантаження (англ.)
  2. Розпакуйте файл .tar.gz. Для цього можна або натиснути на нього правою кнопкою миші і вибрати «Розпакувати файл» (Extract file), або розпакувати його з командного рядку:
     tar -xvzf love.tar.gz
    
  3. Перенесіть свій файл game.love в директорію, яка з'явилася після розпакування.
  4. Відредагуйте файл love і замініть "[email protected]" на "${LOVE_LAUNCHER_LOCATION}/game.love"

Debian

Архів Debian має правила включення ігор на LÖVE. Навіть якщо ви не плануєте додавати гру в цей архів, ви можете використовувати їх інструкції.

Створення пакетів Love2d (англ.)

Пакунки AppImage

Формат AppImage дозволяє створити пакунок з програмою, який можна буде використовувати на багатьох різних системах (основних операційних системах, дистрибутивах) без змін. Весь набір інструментів для нього можна завантажити тут (англ.).

Щоб створити пакунок AppImage для гри потрібно зібрати всі бібліотеки та файли, від яких залежить LÖVE. Це можно проста зробити програмою CARE (вона доступна в репозитаріях Ubuntu), виконавши таку коману:

care -o love.tar.gz love

.

Ця програма створить архів, в якому буде виконуваний файл love та файли, від яких він залежить, і інші пов'язані файли, які зберігаються в вашій системі.

По-друге, необхідно «приєднати» гру до файла .love таким чином, як показано вижче. Після цього файли в директорії виглядатимуть так:

Application Directory/
├── <game name>.desktop  --> В цьому файлі записаний шлях до значка програми,
│                            назва програми і команда для її викнонання.
├── <game name>.png      --> Значок вашої програми
└── usr/
    ├── bin/    --> Сюди треба покласти об'єднаний виконуваний файл
    ├── lib/    --> Сюди треба покласти бібліотеки
    └── share/  --> Сюди треба покласти ваші (або від LÖVE) файли даних (та інші речі), якщо вони є

На останньому кроці директорію треба перетворити в AppImage, використовуючи AppImageAssistant з набору інструментів. Більше інформації можна знайти в документації до AppImage (англ.).

Android

Компіляція з початкового коду

По-перше зклонуйте проєкт LÖVE:

git clone https://github.com/love2d/love-android

Після цього потрібно оновити підмодулі, щоб директорія /love/src/jni/love не була пустою

git submodule update --init --recursive

Після цього завантажте Android SDK (API 28) та NDK. Відомо, що для NDK працює версія r16 та новіше. Робота на старіших версіях не тестувалась.

Встановіть наступні змінні середовища:

  • ANDROID_HOME має містити шлях до Android SDK.
  • ANDROID_NDK_HOME має містити шлях до Android NDK.

Скопіюйте гру (game.love) в директорію (проєкт)/app/src/main/assets (якщо такої директорії не існує, створіть її).

В системах Linux та macOS, можливо, буде потрібно встановити дозволи на виконання програми:

chmod +x gradlew

Нарешті, щоб створити файл apk, виконайте:

./gradlew assemble

Файл .apk буде в директорії (проєкт)/app/build/outputs/apk/

Більше інформації можна знайти в wiki про Löve для Android (англійською).

Використання APKTool

Див. інструкції на сторінці Game Distribution/APKTool (англ.).

iOS

Базові інструкції для iOS (без приєднання гри) доступні в статті Getting Started (Українська)#iOS.

O.png Через обмеження, встановлені Apple, об'єднати гру для iOS можна тільки на комп'ютері з macOS!  


Щоб приєднати свою гру до рушія LÖVE:

  1. Завантажте початковий код для iOS з love2d.org.
  2. Відкрийте platform/xcode/love.xcodeproj в Xcode.
  3. Оберіть об'єкт-результат love-ios (не love-macosx)
  4. Оберіть Build Phases (Фази збірки) результату 'love-ios', і додайте свій файл 'game.love' в Copy Bundle Resources (Копіювати ресурси пакунку).
  5. Зберіть проєкт.
  6. Ваша гра має з'явитися на вашому пристрої iOS у вигляді застосунку.

Якщо ви не можете знайти потрібні елементи в інтерфейсі XCode, відкрийте відеоурок на YouTube (англ.).

Розповсюдження в web

Завдяки TannerRogalsky/love.js ігри можна запускати в браузері з підтримкою HTML5 та JavaScript. Потоки (threads) недоступні, і робота залежить від браузера.

Інструменти від спільноти

Спільнота розробників створила декілька інструментів, які допомагають розповсюджувати ігри.

  • makelove, потужний багатоплатформовий інструмент для об'єднання кода ігор з програмою, написаний на Python 3. Підтримує Windows і Linux через AppImage.
  • love-release (на форумі, англ.), скрипт на Lua, який автоматизує створення пакунків для гри. Підтримує Windows, macOS, Debian, Linux, і має багато опцій.
  • boon (на форумі, англ.), багатоплатформовий простий інструмент, якій підтримує Windows, macOS, Linux.
  • Love Distrubution Pack[sic], інструмент тільки для Windows, який лише дозволяє створювати файли .love та виконувані exe-файли.
  • love-dist, інструмент тільки для Windows, який компілює ваші ігри через LuaC (англ.) і створює exe-файл.

Іншими мовами