OpenHarmony如何将public-SDK替换为full-SDK

Trainee_Li · 发表于 2023-8-11 14:20:56

本帖最后由 Trainee_Li 于 2023-8-11 14:24 编辑

背景
  在OpenHarmony应用开发中，有时候会用到系统接口，这个时候就需要用full-SDK

SDK分类
  public-SDK是提供给应用开发的工具包，跟随DevEco Studio下载，不包含系统应用所需要的高权限API

  full-SDK是提供给OEM厂商开发应用的工具包，不能随DevEco Studio下载，包含了系统应用所需要的高权限API

  三方开发者通过DevEco Studio自动下载的API8版本SDK均为public版本。public-SDK不支持开发者使用所有的系统API，包括animator组件、xcomponent组件、@ohos.app.ability.abilityManager.d.ts、@ohos.app.form.formInfo.d.ts、@ohos.bluetooth.d.ts等，如工程必须依赖于系统API，请按照以下步骤替换full-SDK。

下载full-SDK
  如果需要Full SDK 可以从gitee上周转测下载，或者每日构建上下载。
  gitee周转测下载链接：https://gitee.com/openharmony/docs/tree/master/zh-cn/release-notes

  每日构建下载链接：https://gitee.com/openharmony-sig/oh-inner-release-management/blob/master/Release-Testing-Version.md

  查看本地SDK路径(此处以ets工程为例)：打开DevEco Studio——>Tools——>OpenHarmony SDK Manager，查看本地SDK安装路径。发现在C:\Users\Administrator\AppData\Local\OpenHarmony\SDKTOP下，版本为3.2.7.5（笔者这里已经完成替换，所以版本是3.2.7.5）。

替换SDK

确认下载的SDK版本是否为full-SDK
a.检查下载文件名是否包含full-SDK字样

b.检查api中是否包含系统API（@ohos.app.ability.abilityManager.d.ts、@ohos.app.form.formInfo.d.ts、@ohos.bluetooth.d.ts等）

注：系统api判定标准以发布api指导文档为主。

替换SDK，以public-SDK-3.2.7.5版本为例。

以windows为例：

a.解压已下载的full-SDK文件

b.替换SDK文件

备份本地SDK（复制并重命名ets目录下版本信息目录名，或者将ets目录拷贝至其他本地路径）

打开获取到的本地已安装SDK文件路径并进行备份。

然后，复制到前面的C:\Users\Administrator\AppData\Local\OpenHarmony\SDKTOP路径下，将其重命名为3.2.7.5，然后将其原来的3.2.x.x备份为3.2.x.x（不要和要替换的full_SDK 3.2.7.5重复就行）

接着，修改3.2.7.5里的oh-uni-package.json配置文件的version字段为当前SDK版本号，若相同则可以忽略。

在3.2.7.5\build-tools\ets-loader目录中打开cmd/powerShell窗口，输入命令npm install下载node_modules依赖包

c.验证系统API接口

找个系统API接口进行验证，如果不报错，则证明已经完成替换。

		自动登录	找回密码
密码			立即注册