Difference between revisions of "Android"

Latest revision as of 18:20, 10 November 2024

Android Port
Latest Released Version	2.8.1
Supported Audio Options	MP3, OGG, FLAC, Uncompressed
Additional Webpage(s)	Play Store
Maintainer(s)	Praetorian LePhilousophe (previous) fuzzie
Packager(s)	Praetorian (previous) fuzzie
Forum	Port Forum
Status	Maintained
First Official Version	1.2.0

About

ScummVM has been ported to the Android platform.

For more information, including how to install and use ScummVM on Android, see the Android user documentation.

Developer information

Daily Builds

To test newer development versions, the daily autogenerated builds from the buildbot can be found here.

To install a daily build:

Uninstall all currently installed ScummVM versions including all plug-ins, as you can not install a daily build alongside the stable release.
Manually install the APK package. Instructions for manual installation are found in the Android user documentation.

The daily builds are debug builds, which means that on some devices performance may be significantly slow for certain CPU intensive features and processes, such as video decoding and MT-32 emulation.

To build your own version from source, see the compilation instructions for Android.

Known issues

When quitting ScummVM by using the Quit button, the process is not cleaned up immediately by Android and the shared object stays in memory.

This means that some global variables (like the debug level) stay initialized to their previous values.

External links

ScummVM forum for the ScummVM Android port

@@ Line 1: / Line 1: @@
 {{PortFeatures|
+icon=android|
 name=Android|
-backend=android|
+version={{StableVersion}}|
-version=1.5.0|
+pkgend=|
-status=Maintained|
+web=[https://play.google.com/store/apps/details?id=org.scummvm.scummvm Play Store]|
 mp3=yes|
 ogg=yes|
 flac=yes|
 uncompressed=yes|
+maintainer=[[User:Praetorian|Praetorian]]<br/>[[User:LePhilousophe|LePhilousophe]]<br/>(previous) [[User:fuzzie|fuzzie]]|
+packager=[[User:Praetorian|Praetorian]]<br/>(previous) [[User:fuzzie|fuzzie]]|
+forum=17|
+status=Maintained|
+firstversion=1.2.0|
+backend=android|
+zlib=yes|
 plugins=yes|
-zlib=yes|
 bits=yes|
 buildbot=yes|
-firstversion=1.2.0|
-maintainer=[[User:gus|gus]]|
-packager=[[User:gus|gus]]|
-pkgend=-android.apk|
-forum=17|
-icon=android|
-agi=yes|
-agos=yes|
-cine=yes|
-cruise=yes|
-drascula=yes|
-gob=yes|
-groovie=yes|
-kyra=yes|
-lure=yes|
-made=yes|
-parallaction=yes|
-queen=yes|
-saga=yes|
-scumm=yes|
-sword1=yes|
-sword2=yes|
-sky=yes|
-tinsel=yes|
-touche=yes|
-tucker=yes|
 }}
-ScummVM has also been ported to the Android platform.
-There is a [[Android/Guide|quick start guide]] aimed at users of the stable version from the Android Market.
+== About ==
+ScummVM has been ported to the Android platform.
-== Controls ==
+For more information, including how to install and use ScummVM on Android, see the [https://docs.scummvm.org/en/latest/other_platforms/android.html Android user documentation].
-=== 5-Way navigation control / DPAD ===
-    DPAD up/down/left/right: Mouse movement
+== Developer information ==
-    DPAD center: Left mouse button
-=== Trackball ===
+=== Daily Builds ===
-    Movement: Mouse movement
+To test newer development versions, the daily autogenerated builds from the buildbot can be found [https://buildbot.scummvm.org/#/dailybuilds here].
-    Click: Left mouse button
-=== Touchscreen ===
+To install a daily build:
+* Uninstall all currently installed ScummVM versions including all plug-ins, as you can not install a daily build alongside the stable release.
+* Manually install the APK package. Instructions for manual installation are found in the [https://docs.scummvm.org/en/latest/other_platforms/android.html#manually-installing-the-apk-package Android user documentation].<br />
+The daily builds are debug builds, which means that on some devices performance may be significantly slow for certain CPU intensive features and processes, such as video decoding and MT-32 emulation.
-    The touchscreen can be used in two modes: direct mode and touchpad mode. The default mode is touchpad mode.
+To build your own version from source, see the [[Compiling_ScummVM/Android|compilation instructions for Android]].
-    When in direct mode, the mouse cursor moves to the touched point on screen.
-    In touchpad mode, the mouse cursor is independent of the touched point, it
-    is moved relative to its current position - like on a touchpad.
-    The Android version of ScummVM doesn't have an input configuration dialog yet,
-    but as a temporary workaround, touchpad mode can be toggled with the "Mixed AdLib/MIDI mode"
-    checkbox on the MIDI tab in ScummVM's main options dialog. Restart ScummVM after changing it.
-    Tap + movement: Mouse movement
-    Tap without movement: Left mouse button click
-    Tap held for &gt;0.5s without movement: Right mouse button click
-    Tap held for &gt;1s without movement: Middle mouse button click
-    Double Tap + movement: Drag and drop
-    On devices supporting multitouch:
-    Hold down one finger, tap with second: Right mouse button click
-    Hold down two fingers, tap with third: Middle mouse button click
-=== System keys ===
+=== Known issues ===
-    Back button: Escape
+When quitting ScummVM by using the Quit button, the process is not cleaned up immediately by Android and the shared object stays in memory.
-    Menu button: ScummVM menu
-    Menu button held for 0.5s: Toggle virtual keyboard
-    Camera or Search button: Right mouse button click
-== Installing Daily Builds ==
+This means that some global variables (like the debug level) stay initialized to their previous values.
-Daily autogenerated builds from our buildbot can be found [http://buildbot.scummvm.org/builds.html here].<br>
+=== External links ===
-However, to install them, a few points are needed to be dealt with:
+* [https://forums.scummvm.org/viewforum.php?f=17 ScummVM forum for the ScummVM Android port]
-* You will need to uninstall all currently installed ScummVM versions including all plugins, as you can not install a daily build alongside the stable release.
-* In order to install the APKs from the daily build zip files, you will need a file manager. The free and open source Ghost Commander is recommended which can also unzip the zip files if downloaded directly to the device.
-* In order to install these _UNSIGNED_ daily builds, you will need to enable the option in the Android Settings for Unknown sources.<br>This is usually under Settings->Security->Unknown Sources (Allow installation of apps from unknown sources).<br>You should turn this off again after you have installed both the main ScummVM apk and the required engine plugins.