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}}|
-status=Maintained|
+pkgend=|
+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.
-== Quick Start ==
-You can install the latest stable version from the Android Market. You need both the main 'ScummVM' app and the plugins for the engines corresponding to the games you want to use.
-The default input controls are touch-pad style (relative mouse movement). At the moment there is no configuration for this, sorry. As a temporary workaround, you can switch to direct touch mode by opening the Options dialog from the main menu, selecting the MIDI tab, toggling the "Mixed AdLib/MIDI mode" checkbox and restarting the application. See the 'Controls' section below for more details.
-You might also want to disable the Fullscreen setting (if you don't want your games stretched to cover your whole screen), and to change the Graphics Mode to 'Linear filtering' if you want higher-quality (but slower) scaling.
-Savegames are stored in the ScummVM directory on your SD card if possible.
-== Controls ==
-=== 5-Way navigation control / DPAD ===
-    DPAD up/down/left/right: Mouse movement
-    DPAD center: Left mouse button
-=== Trackball ===
-    Movement: Mouse movement
+== About ==
-    Click: Left mouse button
+ScummVM has been ported to the Android platform.
-=== Touchscreen ===
+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].
-    The touchscreen can be used in two modes
+== Developer information ==
-) Direct mode
+=== Daily Builds ===
-) Touchpad mode
-    When in direct mode, the mouse cursor moves to the touched point on screen.
+To test newer development versions, the daily autogenerated builds from the buildbot can be found [https://buildbot.scummvm.org/#/dailybuilds here].
-    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 port currently misses its own configuration dialog, the mode can
+To install a daily build:
-    be toggled with the "Mixed AdLib/MIDI mode" on the MIDI tab in ScummVM's
+* Uninstall all currently installed ScummVM versions including all plug-ins, as you can not install a daily build alongside the stable release.
-    own option dialog.
+* 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.
-    Tap + movement: Mouse movement
+To build your own version from source, see the [[Compiling_ScummVM/Android|compilation instructions for Android]].
-    Tap without movement: Left mouse button click
-    Tap held for >0.5s without movement: Right mouse button click
-    Tap held for >1s without movement: Middle mouse button click
-    Double Tap + movement: Drag and drop
-    On devices supporting multitouch:
+=== Known issues ===
-    Two finger tap: Right mouse button click
+When quitting ScummVM by using the Quit button, the process is not cleaned up immediately by Android and the shared object stays in memory.
-    Three finger tap: Middle mouse button click
-=== System keys ===
+This means that some global variables (like the debug level) stay initialized to their previous values.
-    Back button: Escape
+=== External links ===
-    Menu button: ScummVM menu
+* [https://forums.scummvm.org/viewforum.php?f=17 ScummVM forum for the ScummVM Android port]
-    Menu button held for 0.5s: Toggle virtual keyboard
-    Camera or Search button: Right mouse button click