本文介绍如何搭建开发环境和基于各版本的SDK编译固件。

准备开发环境

  1. 搭建SDK的开发环境。

    建议您在64位Ubuntu下搭建设备端SDK的开发环境，并使用vim编辑代码。该部分的操作请自行查阅网络相关文档完成。

    说明 暂不支持在Windows系统（含Windows子系统）下编译生活物联网平台SDK。
  2. 安装Ubuntu（版本16.04 X64）程序运行时库。

    请您按顺序逐条执行命令。

    sudo apt-get update
sudo apt-get -y install libssl-dev:i386
sudo apt-get -y install libncurses-dev:i386
sudo apt-get -y install libreadline-dev:i386
  3. 安装Ubuntu（版本16.04 X64）依赖软件包。

    请您按顺序逐条执行命令。

    sudo apt-get update
sudo apt-get -y install git wget make flex bison gperf unzip
sudo apt-get -y install gcc-multilib
sudo apt-get -y install libssl-dev
sudo apt-get -y install libncurses-dev
sudo apt-get -y install libreadline-dev
sudo apt-get -y install python python-pip
  4. 安装Python依赖包。

    请您按顺序逐条执行命令。

    python -m pip install setuptools
python -m pip install wheel
python -m pip install aos-cube
python -m pip install esptool
python -m pip install pyserial
python -m pip install scons
    说明 安装完成后，请您使用aos-cube --version查看aos-cube的版本号，需确保aos-cube的版本号大于等于0.5.11。

    如果在安装过程中遇到网络问题，可使用国内镜像文件。

    ### 安装/升级 pip
python -m pip install --trusted-host=mirrors.aliyun.com -i https://mirrors.aliyun.com/pypi/simple/ --upgrade pip
### 基于pip依次安装第三方包和aos-cube
pip install --trusted-host=mirrors.aliyun.com -i https://mirrors.aliyun.com/pypi/simple/   setuptools
pip install --trusted-host=mirrors.aliyun.com -i https://mirrors.aliyun.com/pypi/simple/   wheel
pip install --trusted-host=mirrors.aliyun.com -i https://mirrors.aliyun.com/pypi/simple/   aos-cube

编译含AliOS Things的SDK（V1.3.0及以上版本）

如果您基于含AliOS Things的SDK（V1.3.0及以上版本）来开发设备固件，请根据以下步骤来编译SDK。

  1. 在开发环境中解压下载的SDK压缩包。
    如果您通过Git命令的方式下载SDK，则无需解压。
  2. 将开发的业务代码存放到SDK相应的目录下。

    如果您基于V1.3.0以上版本开发设备固件，可以将开发的代码存放到Products/品类目录/应用名/…下（例如Products/example/smart_outlet为单路智能插座参考实现）。

    SDK V1.3.0及以上版本的详细目录结构如下所示。

    ali-smartliving-device-alios-things
├── build.sh
├── LICENSE
├── Living_SDK
│   ├── 3rdparty
│   ├── app
│   ├── board
│   ├── build
│   ├── device
│   ├── doc
│   ├── example
│   ├── framework
│   ├── gen_firmware.sh -> example/smart_led_strip/gen_firmware.sh
│   ├── include
│   ├── kernel
│   ├── LICENSE
│   ├── NOTICE
│   ├── platform
│   ├── projects
│   ├── README.md
│   ├── security
│   ├── site_scons
│   ├── test
│   ├── tools
│   ├── ucube.py
│   └── utility
├── Products
│   ├── example
│   ├── Smart_lighting
│   └── Smart_outlet
├── README.md
├── Service
│   └── version
└── tools
    ├── 5981a.sh
    ├── amebaz_dev
    ├── amebaz_dev.sh
    ├── asr5501
    ├── asr5501.sh
    ├── bk7231u
    ├── bk7231udevkitc.sh
    ├── cmd
    ├── mk3060.sh
    ├── mk3080.sh
    ├── moc108
    ├── mx1270.sh
    ├── rda5981
    ├── rtl8710bn
    └── scripts
  3. 编译SDK。
    1. 在SDK根目录，执行vim build.sh命令打开build.sh文件。
    2. 根据硬件使用的模组型号和要编译的应用，修改文件中的如下参数。 
      default_type="example"      //配置产品类型
default_app="smart_outlet"  //配置编译的应用名称
default_board="uno-91h"     //配置编译的模组型号
default_region=SINGAPORE    //配置设备的连云区域：
//V1.5.0及以下版本：设备在中国内地激活配置为MAINLAND，其余地区激活配置为SINGAPORE
//V1.6.0及以上版本：配置为MAINLAND或SINGAPORE都可以，设备可以全球范围内激活
default_env=ONLINE      //配置连云环境
Debug log：default_debug=0
default_args=""         //配置其他编译参数

//更多介绍请参见README.md
    3. 执行./build.sh命令。

      以基于uno-91h模组编译smart_outlet应用为例，编译完成后，在out\smart_outlet@uno-91h目录下会生成smart_outlet@uno-91h_all.bin文件。该文件为需要烧录到真实设备中的固件。

      说明 : build.sh脚本会自动判断指定模组的toolchain（交叉编译工具链）是否已经安装，如果没有安装，脚本会自动安装。

      编译该版本SDK时，如果出现头文件、静态库缺失等错误，请参见常见问题。

编译含AliOS Things的SDK（V1.1.0及以下版本）

如果您基于含AliOS Things的SDK V1.1.0或者V1.0.0版本（原天猫精灵Wi-Fi SDK）来开发设备固件，请根据以下步骤来编译SDK。

  1. 在开发环境中解压下载的SDK压缩包。
    如果您通过Git命令的方式下载SDK，则无需解压。
  2. 将开发的业务代码存放到SDK相应的目录下。

    可以将开发的代码存放到example/应用名下，如您基于linkkitapp开发，即把新增加的代码合入example/linkkitapp目录。

    SDK V1.1.0之前版本与SDK V1.3.0及以上版本的目录对比如下。

    目录机构对比
  3. 编译SDK。
    1. 以mk3060模组为例，如果是第一次编译，在SDK根目录，执行编译如下命令，会自动安装指定模组的toolchain。
      aos make helloworld@mk3060
    2. 如已经安装toolchain，在SDK根目录，执行编译如下命令。
      aos make linkkitapp@mk3060

      编译完成后，在out\linkkitapp@mk3060\binary目录下会生成linkkitapp@mk3060_crc.bin文件。该文件为需要烧录到真实设备中的固件。

      如果编译失败且提示头文件或静态库缺失的错误，请参见常见问题。

编译无AliOS Things的SDK

如果您基于无AliOS Things的SDK来开发设备固件，请根据以下步骤来编译SDK（无AliOS Things SDK各版本的编译操作一致）。

  1. 在开发环境中解压下载的SDK压缩包。
    如果您通过Git命令的方式下载SDK，则无需解压。
  2. 将开发的业务代码存放到SDK相应的目录下。

    不含AliOS Things的SDK目录结构如下所示。

    ali-smartliving-device-sdk-c
├── build-rules
│   ├── docs
│   ├── funcs.mk
│   ├── hooks
│   ├── misc
│   ├── pre-build.sh
│   ├── _rules-complib.mk
│   ├── _rules-coverage.mk
│   ├── _rules-dist.mk
│   ├── _rules-flat.mk
│   ├── _rules-kmod.mk
│   ├── _rules-libs.mk
│   ├── rules.mk
│   ├── _rules-modinfo.mk
│   ├── _rules-origin.mk
│   ├── _rules-prefix.mk
│   ├── _rules-prog.mk
│   ├── _rules-repo.mk
│   ├── _rules-submods.mk
│   ├── _rules-top.mk
│   ├── scripts
│   └── settings.mk
├── CMakeLists.txt
├── components
│   ├── tick_notify
│   └── timer_service
├── Config.in
├── Config.linkkit
├── docs
│   ├── 智能生活C-SDK适配FreeRTOS帮助文档.pdf
│   ├── 智能生活SDK复位功能介绍.pdf
│   └── 智能生活设备配网绑定问题分析参考.pdf
├── examples
│   ├── cJSON.c
│   ├── cJSON.h
│   ├── iot.mk
│   └── linkkit
├── include
│   ├── exports
│   ├── imports
│   ├── iot_export.h
│   └── iot_import.h
├── lib
│   ├── ANDES_N10
│   ├── ARM968E-S
│   ├── Cortex-M4
│   ├── linux
│   └── xtensa
├── LICENSE
├── linkkit_kv.bin
├── makefile
├── make.settings
├── output
│   └── release
├── prebuilt
│   ├── extra
│   ├── mdm9206
│   ├── ubuntu
│   └── win7
├── project.mk
├── README.md
├── sdk-c.mk
└── src
    ├── board
    ├── infra
    ├── protocol
    ├── ref-impl
    ├── sdk-impl
    ├── security
    ├── services
    └── tools
  3. 编译SDK。
    1. 在SDK根目录，执行vim make.settings命令打开make.settings文件。
    2. 根据硬件使用的模组型号和要编译的应用，修改文件中的如下参数。

      其中详细的参数解释请参见基于非认证的模组开发。 

      #=========Basic Features==========
FEATURE_SRCPATH="."
FEATURE_MQTT_COMM_ENABLED=y
FEATURE_MQTT_AUTO_SUBSCRIBE=y
FEATURE_DEVICE_MODEL_ENABLED=y
FEATURE_OTA_ENABLED=y
FEATURE_DEV_BIND_ENABLED=y
FEATURE_SUPPORT_TLS=y
#Support unified service post
FEATURE_DM_UNIFIED_SERVICE_POST=y
#=========Basic Features==========

#=========User Config Features==========
FEATURE_ALCS_ENABLED=y

# FEATURE_DEVICE_MODEL_GATEWAY=n

#
# AWSS Configurations
#
FEATURE_WIFI_PROVISION_ENABLED=y

FEATURE_AWSS_SUPPORT_SMARTCONFIG=y
FEATURE_AWSS_SUPPORT_ZEROCONFIG=y
FEATURE_AWSS_SUPPORT_DEV_AP=y
    3. 执行make distclean命令。
    4. 执行make reconfig命令，并在出现以下提示后，输入选项对应的序号。

      请根据要编译的目标平台（即board）来选择。如果您编译demo，则选择7。 

      SELECT A CONFIGURATION:

1) config.esp8266.aos       6) config.rhino.make
2) config.freertos.esp8266  7) config.ubuntu.x86
3) config.macos.x86         8) config.win7.mingw32
4) config.mk3060.aos        9) config.xboard.make
5) config.mk3080.aos
    5. 执行make命令。

      以编译config.ubuntu.x86为例，编译完成后，在output/release/bin目录下会生成living_platform文件为demo。如果您编译真实固件请参见无AliOS Things的SDK适配指南。