Installing Barcoders Android Server - Revision history

Anw: Categorisation

2024-08-08T12:11:06Z

Categorisation

← Older revision		Revision as of 14:11, 8 August 2024
Line 123:		Line 123:

	[[Category:Android]]		[[Category:Android]]
			[[Category:Technical Guides]]

Anw: Split device setup guide into its own page

2024-02-27T16:05:26Z

Split device setup guide into its own page

← Older revision		Revision as of 18:05, 27 February 2024
Line 119:		Line 119:
	* Confirmation of the license renewal process with Barcoders requested.		* Confirmation of the license renewal process with Barcoders requested.

			{{:Android_Setup_Guide}}

	~~== Downloading the Android App ==~~
	~~Side-load the Barcoders Android application on your device.~~

	* Enter URL in Google Search or Chrome, or scan the barcode in above, or scan using Zebra Xing scanner app.
	~~https://www.barcoders.com/app-release.apk~~
	~~[[Image:BarcodersAPK.png\|250px]]~~
	* Download APK (confirm if asked)
	* Confirm name if asked.
	* Open Downloaded APK (from open/install button or from notification drag down from top of screen or from Apps/Downloads or from Apps/Files).
	* Confirm installing.
	* If prompted confirm settings to allow installing unsafe apps, then return to * above.
	* Install – confirm install location if requested (accept default)

	~~The application will be named "Warehouse Terminal" and have a green Barcoders icon for its graphic.~~
	~~Drag to the home screen for easy access.~~


	~~== Configuring the Android App ==~~
	* When you start the APK for the first time, it will display an IP address pointing to our RFServer here. You’ll need to change it to point to the IP address of your Android RFServer. To do this navigate to https://www.barcoders.com/make-server-barcode.php and generate a barcode PNG for the IP address of your Android RFServer. Print it out and scan it at the step above. You may have to exit and get back in for it to recognize the new IP address.
	* When the menu come up, select the bottom option and test.


	~~== Zebra Enterprise Keyboard ==~~
	~~Zebra provide a freely-downloadable enterprise keyboard that can be configured for function key presses.~~

	* https://www.zebra.com/gb/en/products/software/mobile-computers/enterprise-keyboard.html
	* https://www.zebra.com/us/en/support-downloads/software/productivity-apps/enterprise-keyboard.html
	* https://techdocs.zebra.com/enterprise-keyboard/4-1/guide/about/
	* https://www.zebra.com/us/en/support-downloads/software/productivity-apps/enterprise-keyboard-designer.html

	~~Android 5 URL - https://CentralTyres-webtest.calidus-epod.com/WebServices/Calidus_ePOD/PDAUpdates/EnterpriseKeyboard_v1.6.0.0.apk~~

	~~[[Image:ZebraKeyboard1_6.png\|250px]]~~

	~~{{Note}} Version 1.6 does not allow function keys. Only works on Android 5 below~~


	~~Android 10+ URL - https://CentralTyres-webtest.calidus-epod.com/WebServices/Calidus_ePOD/PDAUpdates/ENTERPRISEKEYBOARD-4.1.0.11.apk~~

	~~[[Image:ZebraKeyboard4.png\|250px]]~~

	~~{{Note}} Version 4 allows function and special keys to be set up. Only works on Android 6 above.~~

	~~=== General Configuration ===~~
	~~After installation, the keyboard must be enabled.~~
	* Go to Settings/System/Languages/On-screen Keyboard/Manage On Screen Keyboard.
	* Enable Enterprise Keyboard.

	~~On devices with a physical keyboard:~~
	* Exit and return to any app that allows the popup keyboard and display it.
	* Click the keyboard icon in the bottom right.
	* Enable "Show Virtual Keyboard".

	~~=== Zebra EKB v1.6 ===~~

	~~Guide: https://techdocs.zebra.com/enterprise-keyboard/2-0/guide/settings/~~

	~~Function keys can be set up on this standard keyboard (on this or the later version).~~

	* Go to Settings/System/Languages/On-screen Keyboard/Manage On Screen Keyboard.
	* Click Enterprise Keyboard.
	* Click Remapping
	* Pick the key to be remapped on which layout - there are 4 on Numeric, 1 on Alpha and one on Symbol that can be remapped.
	* Remap the key to output Unicode (U+24BB)

	~~The remapped key will then display as an F on the keyboard.~~

	You can then hit the F key - an F will appear, and then you can enter the number keys 1-9 and hit ENTER - this will enter the selected function key e.g. the remapped key, plus 8 plus ENTER will send F8.


	~~=== Zebra EKB v4.x Configuration ===~~

	~~Creation of full keyboard layouts can be completed through the Zebra EKB Designer. This tool allows creation of multiple keyboard layouts.~~
	* Guide:
	** https://techdocs.zebra.com/enterprise-keyboard/latest/guide/settings/
	** https://techdocs.zebra.com/ekd/1-9/guide/about/
	* Keycodes: https://techdocs.zebra.com/mx/keymappingmgr/
	* Download: https://www.zebra.com/us/en/support-downloads/software/productivity-apps/enterprise-keyboard-designer.html

	~~You will need to deploy to each device. This can be through:~~
	* The EKD application itself, device by device.
	* Sideload, through ADB, device by device.
	* Your chosen MDN software if it supports it.

	~~The blow guide focusses on deploying a pre-created custom keyboard layout through the EKD software. You will need:~~
	* The EKD software
	* The keyboard layout
	* A direct connection between the device and the PC running the software.

	~~The sample SAP project works perfectly on supported devices - download from here: https://techdocs.zebra.com/ekd/latest/samples/.~~
	* Get the keyboard layout project from URL or pre-created (MC3x-FKeys)
	* Start EKD
	* Load the project
	* Select a layout
	* Connect the device to your computer
	* Send to the device

	~~Alternatively, this designer keyboard can be sideloaded onto the device into the following area: /enterprise/device/settings/ekb/config~~

	~~Once the keyboard is loaded, the layout must be enabled.~~
	* Got to DataWedge
	* Select the profile associated to your app (in this case BC-AndroidTerminal-v2)
	* Click the Enterprise Keyboard section
	* Ensure Enabled is checked.
	* Click Select Layout
	* Choose "qwertylayout" as the default under the loaded EKD layout project (MC3x-FKeys)

	~~Now the standard keyboard will be the selected custom keyboard layout.~~

	~~The keyboard supports~~
	* Alpha uppercase and lowercase layouts
	* Accessible numbers and symbols when long-pressing keys
	* Symbols layout
	* Numeric Only layout
	* Functions layout, supporting
	** Numbers
	** Function Keys
	** ESC key
	** Cursor Keys
	** and more.

	~~When displayed, the keyboard will start on alpha layout.~~
	* Use the Caps or ABC key to switch between Alpha Uppercase and Lowercase.
	* Use the 123 key to switch to numeric
	* Use the FUNC key to switch to function and control keys (including cursor keys)
	* Use the /*?# key to switch to symbol keys.

	[[Category:Android]]		[[Category:Android]]

Anw: Added cleardown of server logs (draft); License Renewal

2024-01-16T12:36:42Z

Added cleardown of server logs (draft); License Renewal

← Older revision		Revision as of 14:36, 16 January 2024
Line 90:		Line 90:
	* Error		* Error
	* Debug		* Debug

			{{Note}} We can clear (delete) the log file and it will recreate with no issues whilst still running.

			{{Note}} A single copy of the log file is added to by the server - it does not change or rotate every day or hour.

			A script is being investigated to copy and to cleardown old scripts - details will be added here and in the support guide when available.


			== Updating Licenses ==

			To update the license manually:
			* Contact Barcoders
			* Get updated license files.
			* Drop into ProgramData
			* Stop and restart ABS server.

			To renew the license automatically:
			* Contact Barcoders
			* Barcoders renew license on server
			* Stop and restart ABS server.


			{{Note}} Confirmation on some processes is being sought:
			* Who in Aptean is in charge of renewals of Android licenses?
			** We want to be changing and updating licenses BEFORE expiration.
			** We want to plan downtime for this.
			** Customer Product Manager should handle this.
			* Confirmation of the license renewal process with Barcoders requested.

Anw: Categorisation

2023-07-17T08:16:56Z

Categorisation

← Older revision		Revision as of 10:16, 17 July 2023
Line 218:		Line 218:
	* Use the FUNC key to switch to function and control keys (including cursor keys)		* Use the FUNC key to switch to function and control keys (including cursor keys)
	* Use the /*?# key to switch to symbol keys.		* Use the /*?# key to switch to symbol keys.

			[[Category:Android]]

Anw: Added details of Zebra EKB configuration and Zebra EKD.

2023-06-01T14:44:53Z

Added details of Zebra EKB configuration and Zebra EKD.

@@ Line 135: / Line 135: @@
 {{Note}} Version 4 allows function and special keys to be set up. Only works on Android 6 above.
-{{Warning}} Issue with keyboard displaying on a device with a physical keyboard:
+On devices with a physical keyboard:
-* Regarding getting the popup keyboard to work, I think you have to go into Datawedge and tap on the barcoders profile "BCAndroidTerminal-v2" and enable it, then tap on "Enterprise Keyboard" and enable it as well.
+* Exit and return to any app that allows the popup keyboard and display it.

Anw: Added details of getting popup keyboard to work.

2023-04-27T14:49:52Z

Added details of getting popup keyboard to work.

← Older revision		Revision as of 16:49, 27 April 2023
Line 134:		Line 134:

	{{Note}} Version 4 allows function and special keys to be set up. Only works on Android 6 above.		{{Note}} Version 4 allows function and special keys to be set up. Only works on Android 6 above.


			{{Warning}} Issue with keyboard displaying on a device with a physical keyboard:
			* Regarding getting the popup keyboard to work, I think you have to go into Datawedge and tap on the barcoders profile "BCAndroidTerminal-v2" and enable it, then tap on "Enterprise Keyboard" and enable it as well.

Anw: Added TechHub notes.

2023-04-24T14:55:36Z

Added TechHub notes.

← Older revision		Revision as of 16:55, 24 April 2023
Line 2:		Line 2:

	== Installing the server ==		== Installing the server ==
	Install on Windows Server		Install on Windows Server.

	~~Install on~~ the ~~RDT server~~		This server must have the following configured by TechHub:
			* Port 50061 for TCP
			* Access to internet for license validation and application download.


			Install on the RDT server:
	* Show hidden files and files with known extensions		* Show hidden files and files with known extensions
	* Create the following directories:		* Create the following directories:

Anw: Added Configuring applications

2023-04-24T14:41:55Z

Added Configuring applications

← Older revision		Revision as of 16:41, 24 April 2023
Line 49:		Line 49:
	cd c:\program files\barcoders		cd c:\program files\barcoders
	BarcodersUpdater --license-id versions/23.52		BarcodersUpdater --license-id versions/23.52


			== Configuring the Applications ==

			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

Anw: Added Zebra Enterprise Keyboard details

2023-04-24T12:24:37Z

Added Zebra Enterprise Keyboard details

← Older revision		Revision as of 14:24, 24 April 2023
Line 71:		Line 71:
	* When you start the APK for the first time, it will display an IP address pointing to our RFServer here. You’ll need to change it to point to the IP address of your Android RFServer. To do this navigate to https://www.barcoders.com/make-server-barcode.php and generate a barcode PNG for the IP address of your Android RFServer. Print it out and scan it at the step above. You may have to exit and get back in for it to recognize the new IP address.		* When you start the APK for the first time, it will display an IP address pointing to our RFServer here. You’ll need to change it to point to the IP address of your Android RFServer. To do this navigate to https://www.barcoders.com/make-server-barcode.php and generate a barcode PNG for the IP address of your Android RFServer. Print it out and scan it at the step above. You may have to exit and get back in for it to recognize the new IP address.
	* When the menu come up, select the bottom option and test.		* When the menu come up, select the bottom option and test.


			== Zebra Enterprise Keyboard ==
			Zebra provide a freely-downloadable enterprise keyboard that can be configured for function key presses.

			* https://www.zebra.com/gb/en/products/software/mobile-computers/enterprise-keyboard.html
			* https://www.zebra.com/us/en/support-downloads/software/productivity-apps/enterprise-keyboard.html
			* https://techdocs.zebra.com/enterprise-keyboard/4-1/guide/about/
			* https://www.zebra.com/us/en/support-downloads/software/productivity-apps/enterprise-keyboard-designer.html

			Android 5 URL - https://CentralTyres-webtest.calidus-epod.com/WebServices/Calidus_ePOD/PDAUpdates/EnterpriseKeyboard_v1.6.0.0.apk

			[[Image:ZebraKeyboard1_6.png\|250px]]

			{{Note}} Version 1.6 does not allow function keys. Only works on Android 5 below


			Android 10+ URL - https://CentralTyres-webtest.calidus-epod.com/WebServices/Calidus_ePOD/PDAUpdates/ENTERPRISEKEYBOARD-4.1.0.11.apk

			[[Image:ZebraKeyboard4.png\|250px]]

			{{Note}} Version 4 allows function and special keys to be set up. Only works on Android 6 above.

Anw: Minor correction

2023-04-24T10:57:30Z

Minor correction

← Older revision		Revision as of 12:57, 24 April 2023
Line 56:		Line 56:
	* Enter URL in Google Search or Chrome, or scan the barcode in above, or scan using Zebra Xing scanner app.		* Enter URL in Google Search or Chrome, or scan the barcode in above, or scan using Zebra Xing scanner app.
	https://www.barcoders.com/app-release.apk		https://www.barcoders.com/app-release.apk
	[[Image:BarcodersAPK.png]]		[[Image:BarcodersAPK.png\|250px]]
	* Download APK (confirm if asked)		* Download APK (confirm if asked)
	* Confirm name if asked.		* Confirm name if asked.