App SDK integration description

1 Applying License

For device security, all developers need to apply the license for SDK from BroadLink DNAKit Developer Portal. BroadLink DNAKit Developer Portal.

Note: The license is associated with your bundle ID. You need to apply different licenses for each bundle ID if necessary.

Procedure of application:

  1. Go to BroadLink DNAKit Developer Portal
  2. Log in with your account or register new one for developer.
  3. Wait for approval
  4. After approval, enter home page and go to Integration > SDK.
  5. Go to Manage license > Apply new license and fill in required information. If you also want to control third party devices, you need to specify the vendor name and model of specific device in note field and submit for approval.
  6. You will find the license on license management page after approval
    Note: Broadlink DNAKit Developer Portal is Chinese now,broadlink FAE can help you to apply the License.

2 Configuration for Android Project

The SDK supports Android version 2.3.1 and above and supports importing in gradlew.

Current configuration for this SDK is

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        minSdkVersion 8
        targetSdkVersion 23
    }
}

1.Add the following codes in “build.gradle” in your project:

    allprojects {
        repositories {
            jcenter()
        }
    }

2.Add the following codes in “build.gradle” in App directory:

    dependencies {
        compile fileTree(include: ['*.jar'], dir: 'libs')

        compile 'com.ibroadlink:BLLetCoreAndroid:2.9.+'
	    compile 'com.ibroadlink:BLLetAccountAndroid:2.+'
	    compile 'com.ibroadlink:BLLetFamilyAndroid:2.+'
	    compile 'com.ibroadlink:BLLetIRCodeAndroid:2.+'
        ......
    }

3.You need to add the following permissions in AndroidManifest.xml or apply the following permissions during invoking:

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />

Description

android.permission.WRITE_EXTERNAL_STORAGE is a highly risky permission which will download control script to the phone during control. You can choose if the permission will be granted. You will be unable to control the device using dnacontrol interface if no script is found on phone.

Configuration for iOS Project

The SDK supports iOS version 8.0 and above and supports the following configuration methods:

Import in Cocoapods

Explanation for integration with Cocoapods:

  1. Please refer to Official website of Cocoapods for the installation of cocoapods. Cocoapods Official website
  2. Add specified Source as https://github.com/ibroadlink/BLLibSpecs.git in Podfile.
  3. You need to add the following sources in Podfile if you want to import BLLetCore: pod 'BLLet/BLLetCore', '~> 2.9'

Example of Podfile:

    source 'https://github.com/ibroadlink/BLLibSpecs.git'
    source 'https://github.com/CocoaPods/Specs.git'

    target 'BLAPPSDKDemo' do
        pod 'BLLet/BLLetBase', '~> 2.9'
        pod 'BLLet/BLLetCore', '~> 2.9'
        pod 'BLLet/BLLetAccount', '~> 2.9'
        pod 'BLLet/BLLetFamily', '~> 2.9'
        pod 'BLLet/BLLetIRCode', '~> 2.9'
    end