Troubleshooting Guide for iWalk Cornwall Android app

Android Troubleshooting Guide

Contents


    Buying walks

    Normal behaviour: walks are sold as in-app purchases so on pressing "buy walk", Android pops up a box for Google to take a payment and the purchase is stored in your Google account. The app is then notified of the purchase and should download the walk (progress bar) which should then appear in "My Walks" in the app.

    Trouble making a purchase

    If you want to disable Android's requirement for a password when paying, see here.

    If you're having problems with purchasing a walk (e.g. the device is failing to connect to Google's servers), the first thing to quickly eliminate is that in-app purchases are not disabled via Android parental controls.

    A reliable way rule out any issues with the wifi connection (e.g. router blocking Google's servers or invisibly redirecting the request to a login page) is to briefly disable wifi and test it using mobile data.

    Next thing is to eliminate is any form of corruption or malfunction on the device:

    • Do an uninstall/reinstall of the iWalk Cornwall app just in case the app didn't install cleanly (can cause all sorts of weird behaviour).
    • It's also worth doing a phone restart in case Android has got itself confused.

    It that doesn't sort it then it's most likely some kind of problem with the Google Pay component of Android which is what the app defers to for the purchasing process:

    • Ensure the Google Pay component of Android is up-to-date (via Play Store)
    • Check the date and time are correct on the device (as Android uses timestamps to cache responses from Google servers)
    • It's worth checking if the payment card has expired. The Android payments troubleshooting guide may be helpful for ensuring a valid payment method has been set up.
    • Finally Google support should be able to help sort out any problem with your Google account and payment setup, or help if Android itself is misbehaving.

    Not sure if purchase went through

    You can confirm the purchase was successful and was stored in your Google account using the guide here.

    Purchase went through but walk didn't download

    A quick thing to try first is:

    • Press the "Check for walk updates" button on the "More options" of menu the app

    This will contact Google for the latest list of purchases and then download any walks in the Google account that are not already on the device.

    Next check your Google order history to see if the purchase is "pending" (this means Google is waiting on the payment provider). There's an option to cancel a pending payment on the Google orders screen if you want to try purchasing it again to see if it goes through immediately. Note that Google will never charge you twice for the same walk (even if you manage to do something to create 2 transactions initially, they will automatically refund one).

    If the purchase has completed but the walk still doesn't download (i.e. the information about the purchase hasn't reached the app) then the following has fixed nearly all "stuck" purchase issues reported to date:

    • Restart the device - this clears in-memory caches
    • Delete the app cache (via the app settings page in the Settings app) - this removes cache data backed-up to the cloud
    • Uninstall the app - this clears caches from the phone storage
    • Reinstall the app and re-run it
    • Wait a minute or so to give the app a chance to sync up with Google
    • Press "Restore Purchases" on the home screen of the app if the walks don't automatically download

    If you're still having problems after this please Contact Us and we'll help you troubleshoot further.

    Purchased walks are not synchronising between my devices when I press "restore purchases"

    You need to be signed into Android on both devices with the same Google account. Also note when there multiple accounts on a device, the PRIMARY Google account (normally the first one added) is the one that Android uses for Google Play to store and fetch your walks.

    • Double-check that the primary Google account is the same on both devices using About Phone in the Android Settings app. Google Account is displayed there.

    If you definitely are signed in to Android as the same user on both devices then try the following on the device that the walks are not appearing on:

    • Uninstall the app (this will clear the operating system caches)
    • Reinstall the app
    • Press "Restore Purchases" on the app home screen

    GPS and compass

    There's a red "NO GPS" sign at the top of the page

    This will be displayed if your GPS receiver is turned off or the app can't access it for some reason. While this message is displayed, don't attempt to start the walk as the app cannot track your location to know that you've started.

    If you've forgotten to turn your GPS receiver on, simply exit/switch out of the app, turn it on and switch back again. The app will detect the change when you switch back to it and begin seeking a GPS location fix.

    If your device doesn't have a built-in GPS receiver, you'll need an external GPS receiver. These can be purchased on Amazon, for example, and can connect to your device via Bluetooth or USB. If you have an external GPS device and are seeing this sign, make sure the external receiver is switched on, your device has Bluetooth is switched on and that the external GPS receiver has been correctly "paired" with your device.

    There's an orange "SEEKING GPS" sign at the top of the page

    While this is displayed, the app cannot track your position to give you relevant direction information.

    It is displayed when the GPS receiver your device is using is activated but a GPS fix has yet to be acquired. In order to track your position, the receiver must locate a minimum of 3 GPS satellites. When the walk navigation is started, this can take anywhere from a couple of seconds to a few minutes. You may also see this sign appear if your GPS receiver loses its location fix. This can occur when objects are obscuring the sky such as when you are under heavy tree cover or inside a building. The sign will disappear once a fix has been reacquired. If for some reason this sign doesn't disappear, try restarting your device.

    My GPS signal keeps dropping out

    Check in Android settings that battery saver is off and in Apps > iWalk Cornwall, check "Location" permission is "Allow all the time" and "Physical activity" permission is not denied.

    The Android GPS service could be malfunctioning so restart the device. This fixes most issues.

    If the issue persists after a restart, have a look at this guide for troubleshooting Android GPS issues (because GPS positions are provided to apps by Android itself, exactly the same things apply).

    My compass direction seems wrong

    The compass in your Android device uses a magnetic sensor to detect magnetic north. Sometimes this sensor gives a wrong reading and needs calibrating. To calibrate your compass, simply move your phone around in the air in a 3 dimensional figure of 8. It may look a bit bonkers but it allows the phone to measure the Earth's magnetic field strength at different points in the field - after a few loops, your compass should automatically re-calibrate.

    Misc

    My photo wasn't saved to my image gallery after I used the Camera button

    When you press the Camera button inside the app, a built-in function within Android takes over to provide an in-app camera. After using this to take a photo, you are then presented with a preview of the photo. You need to press the "OK" (or "tick" - depending on the Android version) button to save the photo. Pressing any other button (or the hardware back button) will not save your photo. We're not quite sure what Google's rationale was for making their in-app camera behave differently from the standalone Android camera app.

    The location that the image gets saved to on the phone is controlled by Android and depends on the flavour/version of Android. On Google Pixel phones, it goes into a top-level folder called "Pictures" (whereas the Android camera app saves into the "DCIM" folder). If the photos are not automatically showing up on the Photos tab in Google Photos, go to Library > Photos on this device > View all. Find the folder they are being saved in then select and and turn on the Backup and sync switch to backup the folder.

    App not beeping for some directions

    Extending the screen dim time in Android will cause this. Setting it back to the default (or "immediate") will fix it. Here's an explanation of why and how:

    The app sends an Android system notification in order to make a beep for each direction. Due to a weird quirk (bug?) in Android's screen dimming behaviour, no sound is made by the phone if the app on the dimmed screen sends a notification (it beeps fine whilst another app is on the dimmed screen instead or if the phone is on the home screen when dimmed). Android doesn't tell the app if the screen is dimmed or not so the app doesn't have a way of knowing if Android is being silent or not.

    The default setting in Android is for the lock screen to be enabled 5 seconds after the screen dims (and Android beeps just fine on the lock screen too) so normally there's only a 5 second "no beep" window which during real world walk usage won't coincide with a new direction (because directions are a lot more than 5 seconds apart even if you are a very fast walker!).

    However, if you've changed your Android settings to increase the time between the screen dimming and the lock screen appearing to more than 5 seconds, this will cause Android to not make any sounds during this period if the app is on the dimmed screen. You can set the time back to the default (or even better to "immediate") for your walk by going to Android Settings, Security and tapping the cog next to "screen lock" (NB not "screen lock" itself). Then tap on "lock after screen timeout" to adjust the value.

    Note unlike the screen dimming, "smart lock" (which allows you to return from the lock screen without re-entering your PIN) doesn't mess up Android's beeping. So if you have any bluetooth device you pair to your phone (smartwatch, earbuds etc), setting up smart lock is a better way to unlock the device easily than altering the screen dim time.

    The app closed without warning

    So long as the iWalk app is selected as the current app (in the "foreground") during a walk, the app will keep running and track your progress, even if the screen is switched off. However, if you switch to use another app during a walk while the iWalk app is running (putting it in the "background"), Android may decide to close the iWalk app to save system resources. If this happens, the iWalk app will no longer be able to track your route progress, so you won't get alerted when you reach a direction point or go off-route.

    The most likely cause is your phone running low on RAM (volatile memory - different from phone storage). Running apps or Android itself can "leak" RAM memory (not return it properly to Android when finished with it) which causes Android to think it's still in use and there is not much free. Restarting the phone should fix this.

    When you reopen the iWalk app, it will automatically resume your current walk and start route tracking again. If you have passed a number of direction points before noticing the app wasn't tracking your progress, the app may not be up-to-date with your current progression through the walk. To remedy this, on the directions screen you can tap on the direction marker before your position shown on the map and select "Start from here" for the relevant direction, to tell the app where to resume the walk from.

    An issue not described here

    The following steps have been found to fix 99% of device issues:

    • Restart the device (clears in-memory caches and reboots phone operating system)
    • Uninstall the app (clears caches in phone storage)
    • Reinstall the app (ensures the app installed properly e.g. if the phone operating system was malfunctioning before)
    • Press "Restore Purchases" on the home screen of the app (re-downloads a fresh copy of all walks)

    If an issue still persists after this then contact us and we'll help you to troubleshoot further.

    Also, if you have a question rather an actual problem, check out the FAQ.