Installation and Configuration

Overview

This page describes the process required to install and execute the Zebra Scanner Control application that is provided with the Zebra Scanner SDK for iOS.

NOTE: The purpose of the scanner Zebra Scanner Control application is to demonstrate the various capabilities of the SDK library. It is not intended for production use purposes.


Installing the Zebra Scanner Control Application

Using the Source Code

Prerequisites

  • OS X
  • Xcode. Download Xcode from the Mac App Store.
  • An iOS Developer account with Apple.
  • A provisioned iOS device with iOS 14, or higher installed.

Launching the Zebra Scanner Control Application

To launch the application on the device:

  1. Connect a provisioned iOS device to your Mac.
  2. Open the ScannerSDKApp.xcodeproj project file.
  3. In the project navigator, choose your device from the Scheme toolbar menu.

    NOTE: If your iOS device is listed as an ineligible device, fix the issue before continuing. The version of iOS that is installed on the device must match the deployment target set in the project.

  4. Click the Run button. Xcode installs the application on the device.
  5. If a warning message appears that states No matching provisioning profile found, click the Fix Issue button. Xcode needs to add the device to the team provisioning profile before it can launch the application on the device.
  6. If a prompt appears that asks whether or not codesign may sign the application using a key in your keychain, click Always Allow.
  7. The application launches on your device.

From the Apple App Store

Prerequisites

  • An iOS device with iOS 14, or higher, installed.

Launching the Zebra Scanner Control Application

To launch the scanner application on the device from the Apple App Store:

  1. Launch the App Store application on your iOS device.
  2. Search for the Zebra Scanner application, or Zebra Scanner Control application by Zebra Technologies.
  3. Tap the Get button next to the application, then tap the Install button.

Launching the Zebra Scanner Control Application

  1. Before launching the application, set the Zebra scanner to the appropriate configuration. See Supported Scanners to determine the required configuration needed for your Zebra scanner.
  2. Enable Bluetooth on your iOS device and pair it with the Bluetooth Zebra scanner, if it is not paired already. Refer to the relevant Product Reference Guide, User Guide, or Integration Guide for instructions on how to pair the device.
  3. Launch the application by selecting the Zebra Scanner Control application from your device's home screen. The following screen displays:
    Figure 1: Zebra Scanner Control - Home Screen
  4. Connect to a scanner.
    1. Connect a BLE scanner: Scan the STC (Scan To Connect) pairing barcode on the 'BT LE' tab to connect a BLE scanner (See the Figure 1).
    2. Connect a MFi supported scanner: Navigate to the 'Help' tab for the pairing information and select a paired MFi scanner on the list to connect.
      Figure 2: Scanner Control App - MFi

  5. Once connected, the Active Scanner menu displays. This menu is used to select various options including Info, Barcode, and Settings.
    1. Select the Info tab to view the Scanner ID, Type, Name, and Auto Reconnection state. This tab also contains functionality to control the Beeper and LED. The following screen displays:
      Figure 3: Zebra Scanner Control - Active Scanners

    2. Select the Barcode tab to view scanned bar codes, and to pull/release the scanner trigger.The following screen displays:
      Figure 4: Zebra Scanner Control - Barcode Data

    3. Select the Settings tab to select supported Symbologies, configure the beeper volume and frequency, and to enable/disable scanning. The following screen displays:
      Figure 5: Zebra Scanner Control - Scanner Settings

    4. To control which symbologies the scanner reads, select the Symbologies option. An on/off control switch appears next to each bar code type displayed in the menu.
      Figure 6: Zebra Scanner Control - Symbologies

      NOTE: Custom symbology settings can be configured via 123Scan.


Configuring the Xcode Project

The Zebra Scanner SDK for iOS consists of a static library that can be linked with an external iOS application and a set of necessary header files.

To add the SDK:

  1. Create a new Xcode project and save it to a new project folder.
  2. Copy the symbolbt-sdk folder provided by Zebra Technologies into the new project folder. This folder contains the libsymbolbt-sdk.a file and an include folder containing SDK header files.
  3. Open the new project in Xcode, and select your project in the file navigator sidebar.
  4. Configure the Xcode project to support one or more external accessory communication protocols through the UISupportedExternalAccessoryProtocols key in your application Info.plist file or via the Info tab of your project settings.

    Table 1: Communication Protocols

    Communication Protocols Zebra Scanner
    com.motorolasolutions.CS4070_ssi CS4070
    com.zebra.scanner.SSI CS6080
    DS8178
    RFD8500

  5. In order to configure your application to communicate with Bluetooth scanners in a background mode, configure your Xcode project to specify the background modes that your application supports using the UIBackgroundModes key in your application Info.plist file or via the Info tab of your project settings.
  6. Select your Target, and then its Build Phases tab.
  7. Expand the Link Binary With Libraries item.
  8. Add the following frameworks by clicking the + button:

    • libsymbolbt-sdk.a
    • ExternalAccessory
    • CoreBluetooth
  9. Select the Build Settings tab.
  10. Navigate to the Search Paths section of the Build Settings.
  11. Set User Header Search Paths to $(SRCROOT)/symbolbt-sdk/include/.
  12. Your project is now configured to use the Zebra Scanner SDK for iOS.