Code Based Linking Configuration Update Guide

This guide is intended to help you adopt changes related to Code Based Linking (CBL) if you have a v1.7 or earlier build of the SDK.

There have been changes made to the configuration file, which you need to be aware of. Specifically:

1. deviceInfo - This is a new configuration object that specifies device identifying information for use by the Device Capability Framework (DCF) and for authorization (CBLAuthDelegate). This object has three required values:
   • clientId (from the "Alexa Dashboard" > "My products" > "manage" > "Security Profiles" > "Other devices and platforms")
   • deviceSerialNumber (unique string, supplied by developer)
   • productId (from "Alexa Dashboard" > "My Products")

IMPORTANT: When you capture the Client ID, make sure it is from the Other devices and platforms section within the Security Profile tab and NOT from the Client ID from the top of the Product information, Security Profile, or Capabilities tabs. They are different values with the same name, and using the wrong one will result in authorization failures.

2. cblAuthDelegate - This is a new configuration object that specifies parameters for CBLAuthDelegate. This object has one required value:
   • databaseFilePath - The absolute path / file-name specifying where CBLAuthDelegate should persist data.

For detailed instructions on authorizing your product with code based linking, please consult the "run and authorize" section of the quick start guide for your platform:

• Linux Reference Guide
• Ubuntu Linux Quick Start Guide
• macOS Quick Start Guide
• Raspberry Pi Quick Start Guide with Script
• Windows Quick Start Guide with Script