Game Distribution/APKTool
This method will assume the usage of APKTool. To distribute your game for Android using APKTool:
Note: APK is one of the few formats that allow you to distribute your game independently and is still supported by some of the smaller app stores. Google Play Store mandate Android Application Bundle since 2021, thus this method is not suitable if you're looking to distribute your app into Play Store |
1. Download APKTool and follow the installation instructions.
2. Download latest LÖVE APK from here and put it somewhere in folder.
3. In current folder (where you store the LÖVE APK), open Command Prompt/Terminal in the current directory and execute apktool d -s -o love_decoded love-11.5-android-embed.apk
and new folder love_decoded
will be created. You can use any folder name, just make sure to make it consistent in later operations.
4. In love_decoded
folder, create new folder named assets
and put your game.love
inside that folder. Your packaged game must be named exactly game.love
!
5. Change the APK icon by replacing the LÖVE icon in res/drawable-{mdpi,{x,{x,{x,}}}hdpi}
(mdpi, hdpi, xhdpi, xxhdpi, and xxxhdpi). Replace love.png
with your game icon in those folders. Make sure the image dimensions are same!
6. Modify AndroidManifest.xml
and use this template:
<?xml version="1.0" encoding="utf-8"?>
<manifest package="${GamePackageName}"
android:versionCode="${GameVersionCode}"
android:versionName="${GameVersionSemantic}"
android:installLocation="auto"
xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18" />
<!--Uncomment line below if your game uses microphone capabilities. !-->
<!--uses-permission android:name="android.permission.RECORD_AUDIO" /!-->
<!-- OpenGL ES 2.0 -->
<uses-feature android:glEsVersion="0x00020000" />
<!-- Touchscreen support -->
<uses-feature android:name="android.hardware.touchscreen" android:required="false" />
<!-- Game controller support -->
<uses-feature android:name="android.hardware.bluetooth" android:required="false" />
<uses-feature android:name="android.hardware.gamepad" android:required="false" />
<uses-feature android:name="android.hardware.usb.host" android:required="false" />
<!-- External mouse input events -->
<uses-feature android:name="android.hardware.type.pc" android:required="false" />
<!-- Low latency audio -->
<uses-feature android:name="android.hardware.audio.low_latency" android:required="false" />
<uses-feature android:name="android.hardware.audio.pro" android:required="false" />
<application
android:allowBackup="true"
android:icon="@drawable/love"
android:label="${GameName}"
android:usesCleartextTraffic="true" >
<activity
android:name="org.love2d.android.GameActivity"
android:exported="true"
android:configChanges="orientation|screenSize|smallestScreenSize|screenLayout|keyboard|keyboardHidden|navigation"
android:label="${GameName}"
android:launchMode="singleInstance"
android:screenOrientation="${ORIENTATION}"
android:resizeableActivity="false"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
<category android:name="tv.ouya.intent.category.GAME" />
</intent-filter>
<intent-filter>
<action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
</intent-filter>
</activity>
</application>
</manifest>
Here are the explanation of the variables. You just have to substitute them: *${GamePackageName}
is your game internal package name. *${GameVersionCode}
is the internal APK version code. *${GameVersionSemantic}
is the readable APK version string. Example: 2.1.0 *${GameName}
is your game name which is going to be displayed in home screen/launcher. Make sure to substitute those variables.
7. Back to folder where you put the LÖVE APK then execute apktool b -o your_game.apk love_decoded
. You can use any name, but again, make it consistent.
8. Sign the resulting APK!!! This page doesn't cover how to do that, because it can be too long. You can't install the APK if it's not signed!!!. Hint: https://github.com/patrickfav/uber-apk-signer
If you find something is wrong or having some problems, don't hesitate to edit or mention me in LOVE Discord: "auahdark".
Termux
Using Termux is not supported. Proceed at your own risk (YMMV)! |
You can also create APKs from your Android device directly with the help of Termux.
1. Install Termux from F-Droid.
2. Install termux-apktool.
3. Follow the instructions above as usual.
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info