Android

This pages contains some specific information about the Battle for Wesnoth new Android port (1.19+)

Playing controls

• Tap a unit to select/deselect it.
• Tap a unit, then tap the target hex to show defense stats of that unit and footsteps. (Similar to hover on PC)
• Tap a unit, then double tap on the target hex to move it. Alternative, you can drag along the path to choose the exact path which the unit is supposed to move by.
• Drag from attacker unit towards attacked unit to attack.

Logs and debugging steps

• Install adb (Android Debug Bridge) on your computer. Search internet for information about your OS. Install drivers for your phone/tablet if necessary.
• Enable Developer Mode on your Android device (phone/tablet). Again, the internet is your friend. On newer devices, you need tap Settings > About Phone > Build Number 7 times until it says "You are now a developer", then go into the Setting > System > Developer Options (newly appeared), and find "USB Debugging" in the menu and turn that on.
• Connect phone to PC. Do adb logcat or similar from a terminal/command prompt to see if your device appears on the list and is authorized. Tap ok on your phone if any permission request appears.
• Run adb logcat -c (clears existing logs), then adb logcat > log.txt (or adb logcat and copy from terminal). Run Wesnoth on phone. Reproduce the crash.
• stop adb logcat on PC, and attach the log.txt to your issue report on github along with detailed steps of the bug, and use the Android label.

(Note: adb can be ./adb.exe on Windows. Use internet for help on any of the steps if needed, this is supposed to be a preliminary guideline. Steps might slightly differ based on manufacturer or Android version.)

Enabling taps

It is useful for debugging purposes, especially if you're sharing a screen recording of your bug, to show where you're tapping on the screen in the screen recording. See here for how to enable that.

Turning off Developer Mode

Go to System > Developer Options and turn off the Use developer options toggle.

Dev Notes

Version Code scheme (1.19.16)

1MMmmPPPVV

Where,

• 1 - since Wesnoth first digit is almost always 1 and the max versionCode is 21000000.
• MM - Major version code.
• mm - Minor version code.
• PPP - Patch version/any other use.
• VV - Reserved for ABI/Variants.
  • Last digit - ABI (['armeabi-v7a': 1, 'arm64-v8a': 2, 'x86': 3, 'x86_64': 4])
  • Last but one digit - Unused (variants if we need them)

New Version Code scheme draft

1SUUMMmmPPVV

Where,

• 1 - since Wesnoth first digit is almost always 1 and the max versionCode is 21000000.
• S - store identifier (must be greater than 2 to allow upgrade from previous scheme.) For example:
  • 2 - F-Droid
  • 3 - Google Play
  • Others if needed.
• UU - unused/unspecified.
• MM - Major version
• mm - Minor version
• PP - Patch version
• VV - ABI/Variants
  • Last digit - ABI (['armeabi-v7a': 1, 'arm64-v8a': 2, 'x86': 3, 'x86_64': 4])
  • Last but one digit - Unused (variants if we need them)