diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128646.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128646.png new file mode 100644 index 0000000000000000000000000000000000000000..c959925cfe28e81a8aa5565e4e9194c870f232b1 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128646.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128756.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128756.png new file mode 100644 index 0000000000000000000000000000000000000000..6d16295957cdeaa957b4d5e3d03c1129e9e83e07 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128756.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128844.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128844.png new file mode 100644 index 0000000000000000000000000000000000000000..8d7478096eaa6f49421ede9c55174d69bc97e7a4 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128844.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128894.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128894.png new file mode 100644 index 0000000000000000000000000000000000000000..5eaba9fabdafa12eca1da0822b4386d02530e793 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128894.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128939.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128939.png new file mode 100644 index 0000000000000000000000000000000000000000..606ce3a0eab0a39f166029182bcc2f70291740d6 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128939.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128998.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128998.png new file mode 100644 index 0000000000000000000000000000000000000000..60bdc8af1ef366c094dd4ae5c5de833892593b57 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655128998.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129041.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129041.png new file mode 100644 index 0000000000000000000000000000000000000000..038118b55274fc0f4b02e03aa6fc96cf119d3858 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129041.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129232.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129232.png new file mode 100644 index 0000000000000000000000000000000000000000..0e50de65deaceff2814666699cba33c3bcaaf12f Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129232.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129264.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129264.png new file mode 100644 index 0000000000000000000000000000000000000000..62efb682a4a9bdb31d929ea0e728327a8b42ee58 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129264.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129305.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129305.png new file mode 100644 index 0000000000000000000000000000000000000000..8160c10a4ef4d3cbe8074576915ba198ebc2159e Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129305.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129333.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129333.png new file mode 100644 index 0000000000000000000000000000000000000000..6e343ebc68da42ad9402c313d175a90082fd75e1 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129333.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129372.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129372.png new file mode 100644 index 0000000000000000000000000000000000000000..0706c7ee4a1581505e9f27574e02b98287d802d7 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129372.png differ diff --git a/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129398.png b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129398.png new file mode 100644 index 0000000000000000000000000000000000000000..b7b29950bb4f3ac3c4815c20317964a3d9572a97 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/zh-cn_image_0000001655129398.png differ diff --git a/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md b/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md new file mode 100644 index 0000000000000000000000000000000000000000..7e452d3a4b5c3bae99f762026b01d36acaaded9b --- /dev/null +++ b/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md @@ -0,0 +1,95 @@ +# full-SDK替换指南 + +**public-SDK**是提供给应用开发的工具包,跟随DevEco Studio下载,不包含系统应用所需要的高权限API + +**full-SDK**是提供给OEM厂商开发应用的工具包,不能随DevEco Studio下载,包含了系统应用所需要的高权限API + +三方开发者通过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**。 + +## 下载full-SDK(这里以3.1.1 Release版本为例) + +1. 获取full-SDK + + full-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。 + +2. 选择版本: + + ![image-20220613161049897](figures/zh-cn_image_0000001655128646.png) + + + + +## 查看本地SDK路径(此处以ets工程为例,1.0工程请以相同方式替换js-SDK) + +打开DevEco Studio——>Tools——>OpenHarmony SDK Manager,查看本地SDK安装路径。 + +![](figures/zh-cn_image_0000001655128939.png) + +![image-20220613160524053](figures/zh-cn_image_0000001655128998.png) + + +## 替换SDK + +1. 打开上一步骤中获取到的SDK本地文件路径。 + ![image-20220613161352157](figures/zh-cn_image_0000001655129041.png) + +2. 确认下载的SDK版本是否为full-SDK + + a.检查下载文件名是否包含full-SDK字样 + + ![image-20220613220702504](figures/zh-cn_image_0000001655129232.png) + + b.检查api中是否包含系统API(@ohos.application.abilityManager.d.ts、@ohos.application.formInfo.d.ts、@ohos.bluetooth.d.ts等) + + 注:系统api判定标准以发布api指导文档为主。 + + + +3. 替换SDK。 + + 以windows为例: + + a.解压`ets-windows-3.1.6.5-Release.zip` + + ![image-20220613165018184](figures/zh-cn_image_0000001655129264.png) + + b.替换SDK文件 + + **备份本地SDK**(复制并重命名ets目录下版本信息目录名,或者将ets目录拷贝至其他本地路径) + + 注:版本信息目录名称只要与其下`oh-uni-package.json`配置文件的version字段不一致即可 + + ![image-20220613165018184](figures/zh-cn_image_0000001655129398.png) + + + + **删除原SDK目录中的所有文件**(否则可能会导致文件无法全部覆盖) + + + + **拷贝full-SDK至本地SDK路径** + + 以public-SDK-3.1.6.6版本为例,将`ets`目录下的所有文件替换至`本地SDK路径\ets\3.1.6.6`中 + + 修改`oh-uni-package.json`配置文件的version字段为当前SDK版本号 + + ``` + { + "apiVersion": "8", + "displayName": "Ets", + "meta": { + "metaVersion": "3.0.0" + }, + "path": "ets", + "releaseType": "Release", + "version": "3.1.6.6" + } + ``` + + 在本地SDK路径下`\build-tools\ets-loader`目录中打开cmd/powerShell窗口,输入命令`npm install`下载**node_modules**依赖包 + + ![image-20220613171111405](figures/zh-cn_image_0000001655129333.png) + + 验证系统API接口 + + ![image-20220613213038104](figures/zh-cn_image_0000001655129372.png) \ No newline at end of file