Open main menu

Difference between revisions of "Android"

2,918 bytes removed ,  20:58, 14 January 2021
Removed duplicate information and added a link to the new docs. Added a “Developer information” section and moved the daily build information here. This will probably move to the user documentation in the future.
(Removed duplicate information and added a link to the new docs. Added a “Developer information” section and moved the daily build information here. This will probably move to the user documentation in the future.)
Line 42: Line 42:
tucker=yes|
tucker=yes|
}}
}}
ScummVM has also been ported to the Android platform.


{| border="0" cellpadding="1" cellspacing="2" style="margin-left:5em; background:#FF9999; width:50%"
== About ==
|- align="center"
ScummVM has been ported to the Android platform.
| '''NOTE'''
|- style="margin-left:1em; background:#ffffff;"
|- style="background:#ffffff"
| Please note that information on this page may be outdated.  
|}


There is a [[Android/Guide|quick start guide]] aimed at users of the stable version from the Android Market.
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]


== Controls ==
== Developer information ==
=== 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 plug-ins 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 plug-ins.
 
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 ===
=== 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 [https://buildbot.scummvm.org/builds.html here].
To test newer development versions, the daily autogenerated builds from the buildbot can be found [https://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 plug-ins, 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 plug-ins.


Please note that 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, MT-32 emulation, etc. The same features will probably perform without issues on release builds, which are the stable builds corresponding to ScummVM releases.
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.
442

edits