第二章：官方Sample

官方Sample将被存放在Github空间进行周期性更新，它将由android-sdk-v5-as、android-sdk-v5-sample和android-sdk-v5-uxsdk共三个项目组成。

• android-sdk-v5-as项目，定义了属于Android Studio所需的项目信息。
• android-sdk-v5-sample项目，定义了属于Sample项目的功能。
• android-sdk-v5-uxsdk项目，定义了一个UI框架。

如何使用官方Sample：

1. 从Github上把官方Sample克隆到本地。
2. 打开Android Studio，点击Open an Existing Project。
3. 点击Mobile-SDK-Android-V5/SampleCode-V5/android-sdk-v5-as进行项目导入。
4. 由于项目编译的app属于sample-app-aircraft模块，所以需要前往build.gradle(Module: android-sdk-v5-as.sample-app-aircraft)文件中查询applicationId的字符串，在本项目中applicationId=com.dji.sampleV5.aircraft。
5. 前往开发者网站申请一个新的app key，注意Package Name必须与项目中的applicationId一致，本项目中applicationId=com.dji.sampleV5.aircraft。
6. 申请好的appkey为一串数字与小写英文字母组成的字符串，需要填入项目中gradle.properties (Project Properties)的AIRCRAFT_API_KEY中。
7. 编译好apk后安装即可正常使用官方Sample，第一次注册时移动设备需有网络。

【5.2及其之前版本】

成功导入项目后我们会看到四个模块，sample-app-aircraft、sample-module-aircraft、sample-module-common和uxsdk四个模块。

• sample-app-aircraft模块，包含了飞行器Sample的页面初始化，安装SDK等功能。
• sample-module-aircraft模块，包含了仅适用于飞行器的相关功能。
• sample-module-common模块，包含了适用于飞行器和手持设备的通用功能。
• uxsdk模块，包含了所有UI控件框架的定义。

【5.3版本开始】

5.3版本取消了手持和全局模块，仅剩下飞行器模块。

【5.8版本开始】

5.8版本的示例代码结构发生了变化。示例代码变成只有两个模块：android-sdk-v5-sample和android-sdk-v5-uxsdk。

• android-sdk-v5-sample包含飞行器功能的全部示例代码。
• android-sdk-v5-uxsdk包含了UI控件以及示例页面。