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.
- OS X
- Xcode. Download Xcode from the Mac App Store.
- iOS 8, or higher, installed.
- An iOS Developer account with Apple.
- A provisioned iOS device.
To launch the application on the device:
- Connect a provisioned iOS device to your Mac.
- Open the ScannerSDKApp.xcodeproj project file.
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.
- Click the Run button. Xcode installs the application on the device.
- 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.
- If a prompt appears that asks whether or not codesign may sign the application using a key in your keychain, click Always Allow.
- The application launches on your device.
- An iOS device with iOS 8, or higher, installed.
To launch the scanner application on the device from the Apple App Store:
- Launch the App Store application on your iOS device.
- Search for the Zebra Scanner application, or Zebra Scanner Control application by Zebra Technologies.
- Tap the Get button next to the application, then tap the Install button.
- 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.
- 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.
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
Select Scanners from the menu. The following screen displays:Figure 2 Scanner Control App - Scanners
- Select the device from the list, and then tap the Connect.
Once connected, the Active Scanner menu displays. This menu is used to select various options including Info, Barcode, and Settings.
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
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
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 - Settings
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. When setting the Inter Character Delay for HID only, set the delay in milliseconds between emulated keystrokes. When pairing with an Android device, set the Inter Character Delay to 70ms to avoid data loss.
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:
- Create a new Xcode project and save it to a new project folder.
- 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.
- Open the new project in Xcode, and select your project in the file navigator sidebar.
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
- 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.
- Select your Target, and then its Build Phases tab.
- Expand the Link Binary With Libraries item.
Add the following frameworks by clicking the + button:
- Select the Build Settings tab.
- Navigate to the Search Paths section of the Build Settings.
- Set User Header Search Paths to $(SRCROOT)/symbolbt-sdk/include/.
- Your project is now configured to use the Zebra Scanner SDK for iOS.