Skip to content

Stendhal WebView Client 2022-02-09

Pre-release
Pre-release
Compare
Choose a tag to compare
@github-actions github-actions released this 09 Feb 09:40
· 4170 commits to master since this release
webview-20220209
39eac8a

Description

This is a WebView client for the Android platform that is designed to be optimized as a conduit for the experimental browser-based web client. In essence, a WebView client is simply a web browser or an interpreter for HTML markup. In comparison to fully-fledged web browsers, it strips many commonly found widgets used to enhance the experience of browsing the internet, such as URL bars & tabs. This allows for the client to make use of more of the screen area. And because the app is geared toward a single specific website, many of the normal browser features would be of no use.

Because many of these features are not implemented, it should also use less system resources than loading the web client in a full browser & may benefit users with lower-end devices. In addition, it will have some features that may not be available while playing in a normal browser such as customizing parts of the container interface.

Warnings & Disclaimers

The web client & WebView client for Android are very experimental. Do not expect everything to work right. It is not currently recommended to use the Android WebView client on the main server. If your character dies or you lose any items due to the usage of this software, do not expect the game moderators to compensate you. These packages are released with the intention for testing purposes only.

While I am a member of the Stendhal development team, these packages should NOT be considered official. I am using this release system to test the software, & facilitate others in contributing in testing, with the goal of an eventual official line that will be securely signed & publicly distributed. Do not consider this software to be secure & be wary of installing software from third party sources.

Installation

IMPORTANT NOTE: The packages in each pre-release are signed with a uniquely generated key. This means that they cannot be installed over another version. In order to install a new package, you must uninstall the old one first. This behavior will not be the case for officially released packages which will be signed with a common private key to allow for secure automatic updates.

  1. Open the .apk on your device.
  2. After installation completes, there will be an associated launch icon in the app drawer.
  3. Launch the "Stendhal" or "Stendhal (debug)" app.
  4. From the initial splash screen, press the "Login" button located in the menu bar at the bottom of the screen.
    • If you installed the debug .apk, you will be prompted to select between the main or testing server.
    • The prerelease .apk allows connection to the main server only.
    • If you connect to the main server there will also be a warning notice popup.
  5. The first screen will prompt you for your username & password, after which, the character select page will open upon successful login.
    • If a previous log in session is still active, it will immediately redirect to character select.
  6. Select a character to use & the active client interface will begin loading.

To exit the game, you can simply close the app. If you want to disconnect & return to the main web page without exiting the app, you can press the menu button in the upper right area of the client & select an option such as "Hall of Fame" or "Select Character". To return to the splash screen, open the menu bar by pressing the back button. Then select "Main Page" on the menu that pops up at the bottom of the screen.

The client supports viewing any pages under the stendhalgame.org domain. All external links will prompt the default associated activity to be launched. If this occurs while a character is connected to the server it will be immediately disconnected to prevent attacks from other players & entities, & loss of items while the interface is not in view.

Changes

20220209:

  • Added menu option to return to main screen.
  • Added mechanism for storing settings (currently no settings available).

20220208:

  • Added toolbar menu.

20220206-rev5:

  • Splash image retains aspect ratio.

20220206:

  • Reworked launcher icons.
  • Disabled zooming.
  • Added splash image.
  • Fixed activity reloaded on orientation change.

20220203-1:

  • Debug build uses unique application ID for parallel installations.

20220203:

  • Added warning about using on main server.
  • External URLs are not opened internally within the WebView client.
  • Only debug builds allow connecting to test server.
Assets 4
Loading