MSDK更新版本避坑思想

从本文中，你将了解到以下内容：
-更新消息来源
-版本说明，更新与否判别
-更新要点关注
-正确更新

一，更新消息来源
主要是让开发者能够明确当前具体版本和未来版本特性。
1.邮件，邮件是大部分人获取更新正式通知的第一入口，展示了版本重点说明等信息。
2.下载界面（https://developer.dji.com/mobile-sdk/downloads/），展示了明确的当前版本信息，示例代码入口，release notes入口。
3.SDK Road Map（https://developer.dji.com/user/roadmap/#msdk），展示了将要释放的新版本，新功能，预计释放时间，问题修复等信息，十分具有指导意义。
（目前仅更新至4.16版本）
4.其他诸如论坛，开发群等途径均是拓展技术交流的渠道，不乏众多大神活跃，不在过多赘述

二，版本说明
主要是MSDK不同各版本区别。
1.大版本。如4.12，4.13字样，一般是更新了重大功能，新机型支持才会发布，发布频次不高。
2.小版本。如4.12.1, 4.13.1字样，从大版本延伸出的小版本，一般用于问题修复，建议更新。
3.更新与否判别。更新与否取决自身项目情况，如有需要新功能，新机型则必须更新。如果用户只是使用某些固定机型，且功能已经满足需求。作为长期稳定的生产工具，用户可以慎重更新。

三，更新关注要点
更新信息繁多，本文从较为重要的，Release Notes和官方Sample两个方面来重点诠释需要关注项。
1.Release Notes
DJI发布MSDK新版本完整诠释的说明（入口见上文更新来源处），主要应关注以下方面：
-高亮，包含重大更新，新功能和新机型说明
-其他变更，辅以新功能的API介绍和重要API变更说明
-问题修复
-已知问题，此栏目确认已知问题是否与开发需求冲突，合理提早避坑，建议关注
-产品支持，对于新机型支持，建议对比具体固件需求，避免固件问题导致的无法使用问题

2.官方Sample
官方Sample内提供了更多细节的变更，与开发者项目版本变更息息相关，一定要做到每次更新必看，实时对比关注。
本文以Android Sample(https://www.github.com/dji-sdk/Mobile-SDK-Android/)为例，作为一线开发者，应关注以下点：

-commits。往往提供了新功能的示例用法，完整的版本更新迭代过程的代码变更示例，重点关注
https://www.github.com/dji-sdk/Mobile-SDK-Android/commits/master

-API文档。与旧版本API对比，提供具体的增，改，删，具体说明，对从旧版本升级上来，旧API失效的指南（文件为html格式，不能直接github上预览，需要下载后在本地使用浏览器预览）
https://www.github.com/dji-sdk/Mobile-SDK-Android/tree/master/docs/SDK%20APIs%20Diff

-gradle配置。一般变更了版本号，新增so文件，依赖等，如果是MSDK版本更新必须的，一定要重点关注，避免更新失败错误
https://www.github.com/dji-sdk/Mobile-SDK-Android/blob/master/Sample%20Code/app/build.gradle

-混淆文件。对于开启了混淆的项目，一定要关注混淆配置，需要关注依从官方提供的混淆配置文件混淆
https://www.github.com/dji-sdk/Mobile-SDK-Android/blob/master/Sample%20Code/app/proguard-rules.pro

四，正确更新
正确更新步骤和以上关注要点相辅相成，从以下几点入手，不再过多赘述。
-修改版本号
-对比官方gradle文件
-检查API不同
-检查混淆文件