Scan2Deploy Studio

Overview

Scan2Deploy Studio can be used to stage Datalogic Mobile Computers running Android 8 and above. It is installable on 64-bit Windows 7/8/10 PCs.

important

This document reflects the features and settings available in Scan2Deploy Studio 1.4.

Downloads

Downloads are available in the Releases section on the Scan2Deploy Studio Github page.

Compatibility

  • Scan2Deploy Studio requires Scan2Deploy Android agent version 1.11 or higher running on the Android device. All Datalogic devices running Android 9 and above should already have this version. For Android 8 devices, this version can be installed directly from the "Hi There!" setup screen as described here.

  • For more detail regarding what versions of Scan2Deploy Android agent support what associated Scan2Deploy Studio features, see the full list of Scan2Deploy Android releases.

Installation

  • Copy the installer file to any convenient location on your PC.
  • Launch the installer.
  • If User Access Control (UAC) is enabled on your computer, authorize the installer to run. (UAC is enabled by default on all supported Windows operating systems, but it can be disabled by default. If you do not see this prompt, UAC may have been disabled.)
  • Follow on-screen prompts to finish installing.

Task tray

When Scan2Deploy Studio is closed, it doesn't stop running. It continues running in the background, and displays a task tray icon on the far right side of the Windows taskbar, near the clock.

Task tray

Right-clicking on the Scan2Deploy Studio icon in the task tray will result in a menu being displayed.

Task tray right click

This gives you the option to Exit Scan2Deploy Studio or set Settings.

Exit

If you choose Exit, all processes related to Scan2Deploy Studio immediately stop.

important

Carefully consider whether or not you want to completely stop Scan2Deploy Studio, particularly if you are relying on Scan2Deploy Studio to serve profiles for mobile devices

Settings

Task tray settings

Currently there is only one setting available.

  • Run at startup - If checked (default), Scan2Deploy Studio will start after booting into Windows. If unchecked, it will not do so.

Welcome Page

The first page displayed when you open Scan2Deploy Studio is the Welcome page. Choose one of the following options from the Welcome page.

  • Create - to create a new Scan2Deploy profile.
  • Edit - to edit the existing Scan2Deploy profile (.tar file).

Welcome

Either way, the next page you end up on will be the Action Selection page.

A table of recent profiles appears below the Create and Edit buttons once you have saved at least one profile. Each row in the table includes the ability to edit and delete a given profile as well as display the QR code.

Recent Profiles

Profile QR

Action Selection Page

This page allows to user to add or remove various actions to the current profile, which fall under 2 categories, Deployment Actions and Firmware Actions, represented by two different radio boxes. By default, Deployment Actions radio box is selected with Wi-Fi action already selected.

Action Selection

note

Unlike deployment profiles, firmware profiles are much more limited as they are focused solely on updating device firmware.

Deployment Actions

ActionDescriptionDevice SpecificServer required
Wi-Fi SetupConfigure Wi-Fi network connection settings
Apply DXU ConfigUpload DXU configuration file to apply to the device
Manage AppsEnable/disable device applications
Install AppsInstall local or remote APKs
Datalogic AppsUpdate Datalogic apps to the latest available versions
Scanner SettingsConfigure scanner settings and parameters
Device SettingsSet Datalogic device settings
Add ScriptsConfigure script commands to apply to the device
File UploadUpload files with arbitrary file extension
Visual FormatterSetup barcode visual formatting

Firmware Actions

ActionDescriptionDevice SpecificServer required
Wi-Fi SetupConfigure Wi-Fi network connection settings
Firmware UpdateUpdate device firmware with OTA package

Device Selection

If you select (check) an action item in the list which is device-specific, e.g. Manage Apps, Datalogic Apps or Firmware Update, three fields will be presented at the bottom of the page that will allow you to select the specific device you will be deploying to.

  • Select Model (e.g. Memor 20, Memor 10 etc.)
  • Select SKU (e.g. US, EU, China etc.)
  • Select OS Version (Android version)

Action Pages

Wi-Fi Setup

This page allows users to configure Wi-Fi configuration on the device. This page consists of three sections:

Basic

The basic section allows for configuration of the following network types:

  • WPA2-PSK
  • WEP
  • Open

Wi-Fi Setup WPA2

EAP

By setting the Encryption Mode in the Basic section to WPA2-EAP or WPA-EAP, the EAP section is enabled. This section allows you to configure many different types of EAP networks:

  • PEAP
  • TLS
  • TTLS
  • PWD
  • SIM
  • AKA
  • AKA-PRIME

Wi-Fi Setup WPA2

Advanced

The Advanced section offers the ability to set a network proxy to use for the connection as well as various other deployment options. Currently, all Advanced settings apply to all Wi-Fi profile encryption method and EAP method types.

  • Proxy Host - Server name or IP address of the proxy to be used for HTTP/HTTPS communications.
  • Proxy Port Number - Server IP port of the proxy for HTTP/HTTPS communications.
  • Forget network when done - If checked, the wireless connection profile will be used solely during the staging process, and deleted once complete. If left unchecked, the profile will still be present after the staging process is done.
  • Remove other networks - If checked, any currently configured wireless networks will be removed. This can be useful in order to avoid profile roaming or to ensure no unauthorized network connections are allowed.
  • Reconfigure - When checked, if configuration for the same network is already present on the device, it will be reconfigured. If unchecked, the existing network will be left alone. This setting is unnecessary if Remove other networks is checked.
  • Wait for connection - If checked, Scan2Deploy agent will wait for the Wi-Fi network connection to be established before proceeding to subsequent device configuration steps.

Wi-Fi Setup WPA2

Apply DXU Config

This page allows users to upload a DXU configuration file which will be applied on the device. Build your DXU configuration file using the Datalogic DXU application, along with a connected device of the type you are planning to deploy to (i.e. connect a Memor 10 if that's the device type you plan to configure for in Scan2Deploy Studio). Follow the Save a Configuration File steps as described in the DXU manual.

Apply DXU Config page

Manage Apps

This page allows users to enable/disable GMS apps, System apps and GMS services on the device as well as set managed configurations for apps that offer it.

Manage Apps page

note

The list of applications that show up on the Manage Apps page is dependent upon the the selected device type on the Action Selection page.

Action column

The action column allows you to specify if an app should be enabled (green circle containing white +), disabled (red circle containing white - symbol), or left alone (leave at current/default setting value).

Manage Apps page

Configuration column

Chrome Managed Configurations

Install Apps

This page allows users to install Android apps (APKs) from the local file system or from a remote URL.

Install Apps page

Datalogic Apps

This page allows users to update Datalogic apps to the latest available versions.

Datalogic Apps page

note

The list of applications that show up on the Datalogic Apps page is dependent upon the the selected device type on the Action Selection page.

Scanner Settings

This page allows users to configure scanner settings and parameters for the device.

Scanner Settings page

Device Settings

This page allows users to set Datalogic device settings, including:

Device Settings page

Add Scripts

This page allows users to configure script commands to apply to the device.

Add Scripts page

File Upload

This page allows users to upload files with arbitrary file extensions.

Scanner Settings page

Visual Formatter

The Visual Formatter page allows users to create formatting rules to manipulate the barcode data received from the scanner. The user can decide which inputs and outputs to consider and create a connection that goes from the specified inputs towards the outputs, passing through some nodes, each representing a specific operation. This data flow is used to manipulate the input data in order to obtain the desired output.

The following sections will explain the different components available in the Visual Formatter, the general usage of the tool and some examples:

Visual Formatter page

Firmware Update

This page allows users upload the OTA (over-the-air) update file compatible with the selected device.

Firmware Update page

note

The OTA file you upload must be compatible with the selected device model and Android version on the Action Selection page. Otherwise, an error will be given, preventing you from using the incorrect OTA file

tip

Firmware images are available for download at developer.datalogic.com.

Save and Print

This is the last page in the app which allows users to save the profile (.tar file) and preview and save the generated barcodes(.pdf file). If a server is needed to host the profile (which is not always the case), the Profile host location option will be presented, so that the user can specify the server details where the profiles generated by Scan2Deploy Studio are to be hosted.

No server required

Depending on how you have configured your profile, a server may not be required to configure your device. If this is the case, the Profile host location option is not displayed and you can use the barcode displayed without a server. All settings are included directly in the barcode.

tip

Check the tables in the Action Selection page section to understand which settings require a server and which do not.

No server required

Hosted in Scan2Deploy Studio

When Profile host location is displayed and you select Scan2Deploy Studio, it will be hosted directly within Scan2Deploy Studio itself.

important

Scan2Deploy Studio must be running and reachable by the mobile device. For this use case, when you close Scan2Deploy, it keeps running in the background. See the task tray section for more detail.

note

Scan2Deploy Studio inserts the hosting PC's hostname as well as IP addresses for all connected interfaces, so that the Android device will be as likely as possible to connect to Scan2Deploy Studio and retrieve the profile successfully.

tip

Any profiles hosted with Scan2Deploy Studio are saved to disk at C:\users\<user>\scan2deploy_uploads\<profile-id>.

Host with Scan2Deploy Studio

Hosted Somewhere else

In this use case, you are responsible for knowing ahead of time where the profile will be hosted. The barcode created will point to the Custom deployment server location specified.

Hosted somewhere else

Advanced

A few specialized fields are available here:

Final Action

  • Action - Determines the last action Scan2Deploy should take before finishing profile processing. Values are none, close, enterprise-reset, factory-reset, and reset. The default value is none. If intent is selected, you will be expected to provide an intent URI that should be sent.
  • Intent - The intent that should be sent. Only applicable if the action field is set to intent.

Default Home/Launcher

  • App type - The type of application that should be used as the default launcher. Selecting Google Launcher App will provide standard, default launcher. Selecting Custom App will require you to enter the name of a package in the Package name field.
  • Package name - Package name of an APK that is or will be installed on the device that should serve as the device's Home/Launcher app. Not just any application can be used as a launcher app. It has to meet certain requirements specified by Google to be set as the launcher app.

Deployment Settings

  • Hide from launcher - Caution if checked, Scan2Deploy will become hidden after the barcode read and the profile is processed fully.
  • Valid until - Set a date on which the barcode will be invalidated.

Deployment QR Codes

Barcode displayed when Scan2Deploy Studio hosts the profile:

Scan2Deploy hosting barcode

Barcode displayed when an external server hosts the profile:

Hosted somewhere else barcode

Sample PDF

Sample generated PDF