1# full-SDK替换指南 2 3**public-SDK**是提供给应用开发的工具包,跟随DevEco Studio下载,不包含系统应用所需要的高权限API 4 5**full-SDK**是提供给OEM厂商开发应用的工具包,不能随DevEco Studio下载,包含了系统应用所需要的高权限API 6 7三方开发者通过DevEco Studio自动下载的**API8版本**SDK均为**public版本**。public-SDK**不支持**开发者使用**所有的系统API**,包括animator组件、xcomponent组件、@ohos.application.abilityManager.d.ts、@ohos.application.formInfo.d.ts、@ohos.bluetooth.d.ts等,如工程必须依赖于系统API,请按照以下步骤替换**full-SDK**。 8 9## 下载full-SDK(这里以3.1.1 Release版本为例) 10 11full-SDK需要手动下载。请参考[OpenHarmony 3.1.1 Release版本说明书](https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v3.1.1-release.md)中的获取方式,获取所需的操作系统的full-SDK。 12 13 14 15 16 17 18 19 20## 查看本地SDK路径(此处以ets工程为例,1.0工程请以相同方式替换js-SDK) 21 22打开DevEco Studio——>Tools——>OpenHarmony SDK Manager,查看本地SDK安装路径。 23 24 25 26 27 28 29## 替换SDK 30 311. 确认下载的SDK版本是否为full-SDK 32 33 a.检查下载文件名是否包含full-SDK字样 34 35  36 37 b.检查api中是否包含系统API(@ohos.application.abilityManager.d.ts、@ohos.application.formInfo.d.ts、@ohos.bluetooth.d.ts等) 38 39 注:系统api判定标准以发布api指导文档为主。 40 41 42 432. 替换SDK,以public-SDK-3.1.6.6版本为例。 44 45 以windows为例: 46 47 a.解压已下载的full-SDK文件:`ets-windows-3.1.6.5-Release.zip` 48 49  50 51 b.替换SDK文件 52 53 **备份本地SDK**(复制并重命名ets目录下版本信息目录名,或者将ets目录拷贝至其他本地路径) 54 55 打开获取到的本地已安装SDK文件路径并进行备份。 56 57  58 59 注:备份版本信息目录名称只要与其下`oh-uni-package.json`配置文件的version字段不一致即可,如下图所示,备份3.1.6.6版本sdk 60 61  62 63 `oh-uni-package.json`文件配置信息如下: 64 65 ``` 66 { 67 "apiVersion": "8", 68 "displayName": "Ets", 69 "meta": { 70 "metaVersion": "3.0.0" 71 }, 72 "path": "ets", 73 "releaseType": "Release", 74 "version": "3.1.6.6" 75 } 76 ``` 77 78 **删除原SDK(3.1.6.6)目录中的所有文件**(否则可能会导致文件无法全部覆盖) 79 80 81 82 **拷贝full-SDK至本地SDK路径** 83 84 将下载的full-SDK文件包中`ets`目录下的所有文件替换至本地SDK路径下`ets\3.1.6.6`目录中 85 86 修改`oh-uni-package.json`配置文件的version字段为当前SDK版本号 87 88 89 90 在`3.1.6.6\build-tools\ets-loader`目录中打开cmd/powerShell窗口,输入命令`npm install`下载**node_modules**依赖包 91 92  93 94 95 96 c.验证系统API接口 97 98 