Anyline SDK v43 (New Changes and Upgrade Guide) - iOS

Owned by
Colm Rogers
Last updated: 03 Apr, 2024
11 min read

 

New and Improved!

Our Engineers have meticulously rewritten our Anyline iOS SDK from the ground up with Version 43. Here you will experience a wide array of game changing features, performance enhancements and overall ease-of-use improvements.

This article covers a summary of what v43 offers compared to our previous versions, a video guide on how to upgrade from any previous version of our Anyline iOS SDK to v43, links to the documentation, and a glossary of some of the terminology associated with our SDK.

 

Before and After

 

Previous versions of Anyline SDK

 

 

Version 43 of Anyline SDK

 

Changes in Version 43

Anyline iOS SDK previous versions

 

  • Implementing a scan module requires the following classes to be initialized:

  1. a scan view

  2. a scan view plugin

  3. a scan plugin

  • the second and third class specify the scanning module you have selected.
    For instance:
    OCR → ALOCRScanViewPlugin ALOCRScanPlugin

Example:

NSError *error = nil; self.licensePlateScanPlugin = [[ALLicensePlateScanPlugin alloc] initWithPluginID:@"LICENSE_PLATE" delegate:self error:&error]; NSAssert(self.licensePlateScanPlugin, @"Setup Error: %@", error.debugDescription); [self.licensePlateScanPlugin addInfoDelegate:self]; self.licensePlateScanViewPlugin = [[ALLicensePlateScanViewPlugin alloc] initWithScanPlugin:self.licensePlateScanPlugin]; NSString *confPath = [[NSBundle mainBundle] pathForResource:@"license_plate_capture_config" ofType:@"json"]; ALScanViewPluginConfig *scanViewPluginConfig = [ALScanViewPluginConfig configurationFromJsonFilePath:confPath]; self.licensePlateScanViewPlugin = [[ALLicensePlateScanViewPlugin alloc] initWithScanPlugin:self.licensePlateScanPlugin scanViewPluginConfig:scanViewPluginConfig]; self.scanView = [[ALScanView alloc] initWithFrame:CGRectZero scanViewPlugin:self.licensePlateScanViewPlugin]; if (error) { // handle the error NSLog(@"The error: %@", error.localizedDescription); }

  • cancelOnResult is a required field and is either true or false. id should be a valid keyword string and is a required field. viewPlugins is an array where the viewPlugin JSON bodies of each child plugin is listed.

Example:

{ "serialViewPluginComposite": { "id": "CATTLE_DL_VIN", "cancelOnResult": true, "viewPlugins": [ { "viewPlugin": { "plugin": { "id": "CATTLE_TAG", "ocrPlugin": { "cattleTagConfig": {} } }, ... } }, { "viewPlugin": { "plugin": { "id": "DRIVING_LICENSE", "idPlugin": { ... } }, ... } ] } }

  • Previous config files are parsed with the top-level keys identified as the objects they represent.

  • For example: The JSON configuration for the camera on a device is under the key identifier, camera ; the JSON configuration for the flash of the camera is under the key identifier, flash, and so on.

  • The cancelOnResult method is found inside the viewPlugin

Example:

{ "viewPlugin": { "plugin": { "id": "LICENSEPLATE_PLUGIN", "licensePlatePlugin": { "scanMode": "AUTO" } }, "cutoutConfig" : { "style": "rect", "maxWidthPercent": "70%", "maxHeightPercent": "70%", "alignment": "top_half", "ratioFromSize": { "width": 3, "height": 1 }, "outerColor": "000000", "outerAlpha": 0.3, "strokeWidth": 1, "strokeColor": "FFFFFF", "cornerRadius": 2, "feedbackStrokeColor": "0099FF" }, "scanFeedback": { "animation": "none", "animationDuration" : 250, "style": "rect", "strokeWidth": 2, "strokeColor": "0099FF", "beepOnResult": true, "vibrateOnResult": true, "blinkAnimationOnResult": true }, "cancelOnResult" : true } }

  • The ALScanPlugin, ALScanViewPlugin, and ALScanView delegates all require the implementation different delegate protocols for specific modules

  • Some module specific delegate examples are ALOCRScanPluginDelegate, ALIDScanPluginDelegate, ALLicensePlateScanPluginDelegate, and so on.

Example:

  • ALScanResult does not support strongly-typed result types of modules and are not defined as part of the result object.

Example:

Anyline iOS SDK v43

 

 

Upgrading to v43

To watch the video tutorial, please click here.

 

Other Additions

  • Added ALPluginConfig for describing configuration data.

    • Added a type of configuration for each scanning capability.

  • Added ALPluginResult for describing result data.

    • Added a type of plugin result for each scanning capability.

  • [Tire] Added tire size specification fields to the result.

  • [Barcode] Added AAMVA parsing for PDF417 codes on driving licenses.

  • [ID] Restructured ID results in a way that every field can contain date- & multi-language information.

 

 

Glossary