一、概述
OpenHarmony SDK 升级助手，用于帮助开发者快速解决OpenHarmony应用SDK升级导致的API不兼容问题。 由于OpenHarmony SDK Beta版本不承诺API稳定性，在SDK升级后，可能存在API不兼容的问题，应用开发者对现在工程切换API版本后，需要适配API接口及其底层行为的变更，存在一定的升级成本；因此OpenHarmony提供了SDK升级助手，可以帮助开发者快速了解升级适配全貌，并通过工具提示快速适配升级，显著提高SDK升级效率。
二、约束与限制
- 应用在升级SDK之前，需要将旧版本的SDK文件进行备份，以免被新版本SDK给覆盖掉。
- 目前suap工具仅支持OpenHarmony应用升级SDK时使用。
三、使用教程
3.1、工具安装
1.在DevEco Studio主菜单栏中点击 “File” > “Settings…”。
2.在Settings弹出框界面，选中"Plugins"进入IDE插件模块
3.点击"Marketplace"选项，在下方搜索框中输入"OpenHarmony SDK Upgrade Assistant"
4.点击搜索到的插件右方"Install"按钮进行下载安装，安装完成之后点击"Apply"按钮，重启IDE即安装成功（注意：插件安装完成后需要重启IDE）
3.2、使用工具
1.辅助升级插件安装好后，打开需要升级的OpenHarmony工程。
2.工程加载完毕后，点击窗口上方主菜单栏的"UpdateCheck" > “Start”
3.报告生成成功后，将弹窗提示，点击“OK”按钮，关闭当前弹窗。
4.根据弹窗提示，打开下方工具栏内UpdateReport按钮，查看升级报告
3.3、报告功能点介绍
- 报告下方总数为因升级SDK导致当前应用出现的问题总数，帮助快速评估修改工作量
- 报告的每个标题头都可以单击进行排序
- 报告中选择类型下拉框可以选择升级类型原因，下方总计会根据选择的类型更改数量
- 是否已修改功能可以帮助开发者记录哪些问题已修改，避免出现重复工作量
- 双击代码所在位置列，可以快速定位到当前代码在应用中位置
- 提示信息列会提供修改建议，供开发者参考修改
- changelog列如果多个版本，单击之后会出现弹出框，将版本号和链接罗列，点击进行跳转。单个版本变更，单击之后，直接跳转到对应的ChangeLog文档中
网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。
一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
