Android Support Guide

Android Support Guide

References:

• Installing Barcoders Android Server
• Android Usage Guide

Filesystem:

• "C:\Program Files\Barcoders" - the ABSStudio files
• "C:\logs"
• "C:\data"

Shortcuts should be created on the desktop:

• "Start Barcoders Server" - the server itself - should already be running
• "Start Barcoders Admin" - similar to Wavelink Administrator - shows the connected devices and licenses.
• "Start Barcoders Updater" - for updating the version.

The ABSStudio Server runs in a command window that must remain open at all times. Do not close this window as this will stop all Android functionality for that customer.

When Android devices connect, the processes will be running under the "Start Barcoders Server" - it is from here that they can be killed with Task Manager.

The Android version of the RDT program is installed in exactly the same place as the existing RDT program RDTMenu1.exe and is called RDTMeni1_Android.exe.

In "C:\Program Files\Barcoders\AndroidStudio" there are two configuration files:

• appsettings.json - application log levels
• config.json - the applications being run by ABSStudio

To configure applications that can be run by the system, add entries to the config.json file, example below:

{
	"ProgramTasks": [
		{	"ExecutablePath": "C:/WCSTEST/RDTMenu1_Android.exe",
			"Name": "RDTMenu1 (TEST)",
			"UsePipes": "True",
		},
		{	"ExecutablePath": "C:/WCSLIVE/RDTMenu1_Android.exe",
			"Name": "RDTMenu1 (LIVE)",
			"UsePipes": "True",
		},
	]
}

To change logging for the application, modify the Logging setting of the appsettings.json file, example below:

  "Logging": {
    "LogLevel": {
      "Default": "Info",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Error"
    }
  },

Values can be changed to

• Info
• Warning
• Error
• Debug

Logging is exported to the command window of the application. This can be changed to export to a file if required, by changing the "Start Barcoders Server" shortcut.

When running the system, the Android application and the Android Server connector must be the compatible versions.

To see the Android app version, get the user to:

• Go to Settings
• Apps
• Find Warehouse Terminal
• Check version

Troubleshooting Guide

Android device can't connect

• Check can other Wavelink devices connect
  • Proves system up and running
• Check error on device
  • When using the app on a wireless device, the application being used is subject to the connectivity of the device to the network and to the application. If there are any issues with the network connectivity or the app cannot be accessed, the application will display the main screen, showing "Error Connecting". Ensure that there is a network connection, then advise hit any key on any physical or popup keyboard to reconnect.
  • If displays selection of system then does not show WCS splash screen:
    • Check Android app set up properly in JSON config settings.
  • If system selected then splash screen displays, then Error connecting to WCS
    • Check WCS running - basic WCS issue
• Check Android Connector Window
  • If not already running, use "Start Barcoders Admin" shortcut on Desktop, or "C:\Program Files\Barcoders\AndroidConnectorWindow\TermProtoTestWindow.exe"
• Check command window open
  • Command window will be named "Start Barcoders Server", or "C:\Program Files\Barcoders\AndroidStudio\Android Connector.exe"
  • Check Task Manager that it is running
  • Start if not
• Check for versions
  • Confirm version of Android connector version in server logs
  • Confirm Android version on device
  • Confirm validity and compatibility of versions - check local project documentation.
  • Advise update device for compatibility
• Check for errors in the server.
  • Check the command window
  • Check the server log.