mirror of
https://github.com/love2d/love-android.git
synced 2026-08-12 08:31:04 +02:00
Miku AuahDark
229 lines
9.3 KiB
Markdown
229 lines
9.3 KiB
Markdown
Android Port of LÖVE, an awesome 2D game engine for Lua (http://love2d.org)
|
|
Copyright (c) 2006-2024 LOVE Development Team
|
|
|
|
|
|
|
|
Download:
|
|
---------
|
|
|
|
You can download pre-built Android packages from https://github.com/love2d/love/releases/latest that allow
|
|
you to run .love files by opening them using a file manager of your choice.
|
|
|
|
Important:
|
|
----------
|
|
|
|
If you want to build from source, make sure to clone the submodules too. Often errors include missing
|
|
liblove.so and "Missing LÖVE" error when building. A proper way to clone this repository is:
|
|
|
|
```
|
|
git clone --recurse-submodules https://github.com/love2d/love-android
|
|
```
|
|
|
|
Add `-b <branch/tag name>` and `--depth 1` if needed.
|
|
|
|
If you already cloned the repository but forgot to initialize the submodules, execute:
|
|
|
|
```
|
|
git submodule sync --recursive
|
|
git submodule update --init --force --recursive
|
|
```
|
|
|
|
In the repository directory. For the last command, add `--depth 1` if needed.
|
|
|
|
Instructions:
|
|
-------------
|
|
|
|
Detailed instructions can be viewed at https://github.com/love2d/love-android/wiki
|
|
|
|
Quick Start:
|
|
------------
|
|
|
|
Before you start, install JDK 17 (not later not earlier). If you intend to build from Android Studio, skip this step as
|
|
Android Studio bundles its own JDK 17.
|
|
|
|
Install CMake version 3.21 or later in your system. Install Android SDK with SDK API 34 (34.x.y) and Android NDK
|
|
26.1.10909125, set the environment variable `ANDROID_HOME` to your Android SDK as necessary then run.
|
|
|
|
```
|
|
$ ./gradlew assembleNormalRecord
|
|
```
|
|
|
|
in the root folder of this project. This should give you an .apk file in the `app/build/outputs/apk/normalRecord`
|
|
subdirectory that you can then sign and install on your phone. The `normalRecord` .apk variant is what you normally have
|
|
when downloading APK from https://love2d.org.
|
|
|
|
If you want to put your game inside the APK, you can either:
|
|
|
|
1. Put all your games in `app/src/embed/assets` such that your `main.lua` path is `app/src/embed/assets/main.lua`; or
|
|
2. Put your zipped \*.love in `app/src/embed/assets` with name `game.love`
|
|
|
|
And change the application id, application version string and codes, application display name, and the icons (see
|
|
[Game Packaging Wiki](https://github.com/love2d/love-android/wiki/Game-Packaging). Afterwards,
|
|
run either `gradlew assembleEmbedNoRecordRelease` (or `gradlew assembleEmbedRecordRelease` if your game uses microphone) to
|
|
generate APK which you can install or `gradlew bundleEmbedNoRecordRelease` (or `gradlew bundleEmbedRecordRelease`) to generate
|
|
AAB which you can upload to Play Store.
|
|
|
|
Alternatively, you can install Android Studio **2022.3.1** or later. After opening it for the first time, open its SDK Manager
|
|
and on the tab "SDK Tools", tick "Show Package Details" then select NDK (Side By Side) version 26.1.10909125. After that, open
|
|
the repository root.
|
|
|
|
Notice: Previously, the embed + APKTool method is preferred, but recent announcements by Google and recent changes in Android render that method obsolete.
|
|
|
|
Bugs:
|
|
-----
|
|
|
|
Bugs and/or feature requests should be reported to the issue tracker at:
|
|
* https://github.com/love2d/love-android/issues - LÖVE-Android-specific issues
|
|
* https://github.com/love2d/love/issues - for LÖVE in general
|
|
|
|
Note: If in doubt, fill an issue report to https://github.com/love2d/love/issues. We'll transfer the issue to this repository as needed.
|
|
|
|
Changelog:
|
|
----------
|
|
|
|
11.5:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [11.5](https://love2d.org/wiki/11.5).
|
|
* Fixed audio in Android still playing in the background in certain cases. ([love2d/love#1828](https://github.com/love2d/love/issues/1828))
|
|
|
|
|
|
11.4:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [11.4](https://love2d.org/wiki/11.4).
|
|
* Changed how LOVE looks for game due to Android restrictions.
|
|
* Fixed "pointer too large" and "bad lightuserdata" issue when compiling LOVE with recent Android SDK and running LOVE on Android 11 and later.
|
|
* For Developers: Added experimental support for 3rd-party Lua modules. Please refer to `love/src/jni/lua-modules` for more information.
|
|
* For Packaging: Added experimental fusing method. [See the FAQ for details](https://github.com/love2d/love-android/wiki/FAQ---Frequently-Asked-Questions#whats-experimental-fusing-method).
|
|
|
|
11.3:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [11.3](https://love2d.org/wiki/11.3).
|
|
* Added support for microphone recording on Android. **This is disabled in Play Store builds**.
|
|
* Added t.audio.mic (`false` by default). On Android, setting it to true requests microphone recording permission from the user.
|
|
* Fixed performance regression on Android devices with Adreno GPU.
|
|
* Fixed video playback support on Android devices with Adreno GPU.
|
|
|
|
11.2:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [11.2](https://love2d.org/wiki/11.2).
|
|
* Added support for ARM64 devices to comply with Play Store requirements.
|
|
* Fixed `love.system.openURL` crashing in some cases.
|
|
* Changed target SDK to 28 so it comply with Play Store requirements.
|
|
|
|
0.10.2:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [0.10.2](https://love2d.org/wiki/0.10.2).
|
|
* Upgrade of SDL2 to 2.0.5 (fixes an issue with the accelerometer)
|
|
|
|
0.10.1:
|
|
|
|
* Contains all relevant changes for desktop LÖVE [0.10.1](https://love2d.org/wiki/0.10.1).
|
|
* Added a new love.conf flag t.externalstorage, which determines whether files are saved in internal or external storage on Android devices.
|
|
* Fixed audio on Android to pause when the app is inactive, and resume when the app becomes active again.
|
|
* Fixed a driver bug on some Android devices which caused all objects to show up as black.
|
|
* Fixed love.graphics.clear(colortable) causing crashes on OpenGL ES 2 systems when a Canvas is active.
|
|
* New icons
|
|
|
|
0.10.0:
|
|
|
|
* first official release!
|
|
* Disabled JIT by default as it can cause performance problems. To enable JIT call jit.on()
|
|
|
|
0.10.0-alpha2:
|
|
|
|
* Update to the next love API 0.10.0 (not yet officially released)
|
|
* Added building of libtheora
|
|
* Updated LuaJIT from 2.0.1 to 2.1
|
|
* Fixed a compatibility issue with Android 2.3 devices
|
|
* Updated libogg from 1.3.2. to 1.3.5
|
|
* Updated OpenAL to 1.17.0
|
|
* Updated SDL2 to a dev version of 2.0.4
|
|
|
|
0.9.2a:
|
|
|
|
* Added bugfix for ParticleSystem:clone
|
|
|
|
0.9.2:
|
|
|
|
* updated API to match that of LÖVE 0.9.2
|
|
* love.window.setFullscreen can be used to switch between regular and immersive mode without status and navbar
|
|
* added loading of games by opening a main.lua file
|
|
* quitting LÖVE now conforms to the Android application lifecycle
|
|
* stop vibrator when app is paused
|
|
* fixed battery drain by properly pausing OpenAL device
|
|
* fixed printing of non-number and non-string values
|
|
* fixed compilation of Android NDK r10
|
|
* fixed compilation warnings concerning ```APP_PLATFORM```
|
|
* old instance is shut down when opening a new game (note: it may crash when opening games at a high frequency, e.g. more than 2 per second)
|
|
* updated OpenAL-Soft to version 1.16.0
|
|
* updated to newer SDL version (f9244b2a151)
|
|
|
|
0.9.1b:
|
|
|
|
* added love.system.vibrate(seconds)
|
|
* print statements are now redirected to logcat. Output is prefixed with "[LOVE] "
|
|
* removed DevIL, libpng, libjpeg, libmng, and libtiff
|
|
* pngs are loaded using lodepng and jpegs using libturbo-jpeg
|
|
* repeatedly fixed a bug which caused Release builds to crash
|
|
* update to latest mobile-common branch
|
|
|
|
0.9.1a:
|
|
|
|
* using latest SDL\_androidgl.c (fixes some random performance issues)
|
|
* using latest love-android @ changeset 8659be0e75a3 (adds support for
|
|
compressed textures)
|
|
|
|
0.9.1:
|
|
|
|
* uses 0.9.1 API
|
|
* fixed crash on Moto G (and possibly other devices). This was a nasty bug that would just show a blue screen without an error message. The bug was resolved using the help of headchant
|
|
* fixed loading of jpegs (it probably hasn't worked up to now)
|
|
* fixed issues with looping over active touches. This fix was sponsored by slime!
|
|
|
|
beta2:
|
|
|
|
* fixed bug with canvases
|
|
* fixed writing of files when no identity in conf.lua was set
|
|
* added file association (somewhat experimental)
|
|
|
|
beta1:
|
|
|
|
* fixed nasty crash on startup bug
|
|
* fixed love.filesystem.getDirectoryItems()
|
|
|
|
alpha9:
|
|
|
|
* Packaged games do not get duplicated for loading, instead are loaded from memory (!!!)
|
|
* Using inofficial physfs 2.1
|
|
* Removed love.android.getDisplayMetrics(), instead use love.window.getPixelScale()
|
|
* Properly link LGPL libraries dynamically. Everything else is linked statically
|
|
* Added an icon (design by @josefnpat)
|
|
* Fixed crash on startup on OUYA (and possibly other devices)
|
|
|
|
alpha8:
|
|
|
|
* Exposing DisplayMetrics in love.android.getDisplayMetrics())
|
|
* Accelerometer is now available as a joystick
|
|
* enabled armv6 compilation (larger files, better compatibility with Tegra2 devices)
|
|
* updated to latest mobile-common branch (including (very) basic multi-touch gesture tracking)
|
|
* updated OpenAL from 1.13 to 1.15.1
|
|
* updated jpeg library from 8c to 9a
|
|
* updated lcms from 2.2 to 2.5
|
|
* updated libogg from 1.3.0 to 1.3.1
|
|
* updated libvorbis from 1.3.2 to 1.3.4
|
|
* updated mpg123 from 1.13.4 to 1.17.0
|
|
|
|
alpha7:
|
|
|
|
* love.system.getOS() now returns "Android"
|
|
* hardware search key is reported as "search"
|
|
* switched to mobile-common branch
|
|
* using new love.touch module (love.touchpressed(id,x,y,p), love.touchmoved(id,x,y,p), love.touchmoved(id,x,y,p))
|
|
* added LOVE_ANDROID define
|
|
|
|
License:
|
|
--------
|
|
|
|
This project contains code from multiple projects using various licenses. Please look at LOVE
|
|
[license.txt](https://github.com/love2d/love/blob/master/license.txt) for the respective licenses.
|