Difference between revisions of "Android"

From ScummVM :: Wiki
Jump to navigation Jump to search
(+ quick start)
(→‎Touchscreen: Removed outdated workaround for Android port.)
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{PortFeatures|
{{PortFeatures|
icon=android|
name=Android|
name=Android|
backend=android|
version={{StableVersion}}|
version={{StableVersion}}|
status=Maintained|
pkgend=-android-all.apk|
mp3=yes|
mp3=yes|
ogg=yes|
ogg=yes|
flac=yes|
flac=yes|
uncompressed=yes|
uncompressed=yes|
maintainer=[[User:fuzzie|fuzzie]]|
packager=[[User:fuzzie|fuzzie]]|
forum=17|
status=Maintained|
firstversion=1.2.0|
backend=android|
zlib=yes|
plugins=yes|
plugins=yes|
zlib=yes|
16bits=yes|
16bits=yes|
buildbot=yes|
buildbot=yes|
firstversion=1.2.0|
maintainer=[[User:gus|gus]]|
packager=[[User:gus|gus]]|
pkgend=-android.apk|
forum=17|
icon=android|


agi=yes|
agi=yes|
Line 42: Line 43:
ScummVM has also been ported to the Android platform.
ScummVM has also been ported to the Android platform.


== Quick Start ==
There is a [[Android/Guide|quick start guide]] aimed at users of the stable version from the Android Market.
 
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 ==
== Controls ==
Line 65: Line 58:
=== Touchscreen ===
=== Touchscreen ===


     The touchscreen can be used in two modes
     The touchscreen can be used in two modes: direct mode and touchpad mode. The default mode is touchpad mode.
 
      
    1) Direct mode
     2) Touchpad mode
 
     When in direct mode, the mouse cursor moves to the touched point on screen.
     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
     In touchpad mode, the mouse cursor is independent of the touched point, it
     is moved relative to its current position - like on a touchpad.
     is moved relative to its current position - like on a touchpad.
 
      
     The port currently misses its own configuration dialog, the mode can
    be toggled with the "Mixed AdLib/MIDI mode" on the MIDI tab in ScummVM's
    own option dialog.
 
     Tap + movement: Mouse movement
     Tap + movement: Mouse movement
     Tap without movement: Left mouse button click
     Tap without movement: Left mouse button click
     Tap held for >0.5s without movement: Right mouse button click
     Tap held for >0.5s without movement: Right mouse button click
     Tap held for >1s without movement: Middle mouse button click
     Tap held for >1s without movement: Middle mouse button click
     Double Tap + movement: Drag and drop
     Double Tap + movement: Drag and drop
 
   
     On devices supporting multitouch:
     On devices supporting multitouch:
 
   
     Two finger tap: Right mouse button click
     Hold down one finger, tap with second: Right mouse button click
     Three finger tap: Middle mouse button click
     Hold down two fingers, tap with third: Middle mouse button click


=== System keys ===
=== System keys ===
Line 95: Line 81:
     Menu button held for 0.5s: Toggle virtual keyboard
     Menu button held for 0.5s: Toggle virtual keyboard
     Camera or Search button: Right mouse button click
     Camera or Search button: Right mouse button click
== Installation ==
=== Release Builds ===
Most users will install/update the latest stable signed release build and plugins from the Google Play store directly on their device.<br />
The ScummVM developer page for this is [https://play.google.com/store/apps/developer?id=ScummVM here].<br />
It is required to install the main ScummVM application from [https://play.google.com/store/apps/details?id=org.scummvm.scummvm here] before installing the required engine plugins.
For users with Android devices lacking the Google Play store access, there are several other options to install the release builds:<br />
# Zip files with signed apks will be provided on the download page and these can be installed with a file manager as per the instructions for daily builds below.<br />
# F-Droid OSS Catalogue from [https://f-droid.org/repository/browse/?fdid=org.scummvm.scummvm here].
=== Daily Builds ===
As the Play store version may be outdated or users may want to test newer development versions, the daily autogenerated builds from our buildbot can be found [http://buildbot.scummvm.org/builds.html here].
However, to install them, a few points are needed to be dealt with:
* 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.

Revision as of 23:16, 18 May 2020

android.png Android Port
Latest Released Version 2.8.0
Supported Audio Options MP3, OGG, FLAC, Uncompressed
Additional Webpage(s) None
Maintainer(s) fuzzie
Packager(s) fuzzie
Forum Port Forum
Status Maintained
First Official Version 1.2.0

ScummVM has also been ported to the Android platform.

There is a quick start guide aimed at users of the stable version from the Android Market.

Controls

5-Way navigation control / DPAD

   DPAD up/down/left/right: Mouse movement
   DPAD center: Left mouse button

Trackball

   Movement: Mouse movement
   Click: Left mouse button

Touchscreen

   The touchscreen can be used in two modes: direct mode and touchpad mode. The default mode is touchpad mode.
   
   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.
   
   Tap + movement: Mouse movement
   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:
   
   Hold down one finger, tap with second: Right mouse button click
   Hold down two fingers, tap with third: Middle mouse button click

System keys

   Back button: Escape
   Menu button: ScummVM menu
   Menu button held for 0.5s: Toggle virtual keyboard
   Camera or Search button: Right mouse button click

Installation

Release Builds

Most users will install/update the latest stable signed release build and plugins from the Google Play store directly on their device.
The ScummVM developer page for this is here.
It is required to install the main ScummVM application from here before installing the required engine plugins.

For users with Android devices lacking the Google Play store access, there are several other options to install the release builds:

  1. Zip files with signed apks will be provided on the download page and these can be installed with a file manager as per the instructions for daily builds below.
  2. F-Droid OSS Catalogue from here.

Daily Builds

As the Play store version may be outdated or users may want to test newer development versions, the daily autogenerated builds from our buildbot can be found here.

However, to install them, a few points are needed to be dealt with:

  • 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.

This is usually under Settings->Security->Unknown Sources (Allow installation of apps from unknown sources).
You should turn this off again after you have installed both the main ScummVM apk and the required engine plugins.