public-SDK 与 full-SDK
OpenHarmony 作为面向全场景的分布式操作系统,为开发者提供了两种不同的软件开发工具包(SDK):public-SDK 和 full-SDK。这两种SDK在设计目标、权限范围和使用场景上存在显著差异。
public-SDK 是面向普通应用开发者的标准工具包,它会随 DevEco Studio 开发环境自动下载安装。public-SDK 包含了开发常规应用所需的全部公共 API,但不包含任何需要高权限的系统级 API。这种设计保证了普通应用只能访问安全的、受限的接口,符合最小权限原则,有利于维护系统的安全性和稳定性。
full-SDK 则是专门为 OEM 厂商和系统应用开发者设计的完整工具包,它包含了 OpenHarmony 系统的全部 API,包括需要高权限的系统接口。由于包含敏感权限,full-SDK 不会随 DevEco Studio 自动下载,需要开发者手动获取和配置。
那什么时需要使用 full-SDK呢?
是否需要使用 full-SDK 是开发过程中的关键决策。以下是几种明确需要使用 full-SDK 的场景:
系统接口调用需求:当应用需要访问系统级功能时,必须使用 full-SDK。例如,控制屏幕亮度、管理外置存储设备、使用组件管理等系统核心功能。这些接口通常在文档中标注有 @systemapi标识,表明它们仅供系统应用使用。
特定组件依赖:某些高级组件如 animator 组件、xcomponent 组件等仅在 full-SDK 中可用。如果应用设计依赖于这些组件,则必须切换到 full-SDK 环境进行开发。
接口标注检查:在 OpenHarmony 官方 API 文档中,系统接口通常会明确标注。开发者可以通过查阅在线文档或本地文档,确认所需接口是否标记为系统接口。例如,亮度控制接口 brightness.setValue()就明确标记为 @systemapi,这意味着调用此接口需要 full-SDK 环境。
获取 full-SDK 有两条主要路径:从官方每日构建站点下载预编译包,或从源码自行编译。对大多数应用开发者而言,下载预编译包是更高效便捷的选择。
OpenHarmony 社区提供了每日构建服务,自动编译最新版本的 SDK 供开发者下载:
1.访问 OpenHarmony 每日构建网站:https://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist;
2.选择需要的版本(如 5.0.0.71 Release 对应 API 12);
3.调整日期以获取最新构建(部分老版本可能不再更新,可往前调整日期);
4.找到对应的 full-SDK 链接,点击下载全量包;
5.下载完成后,解压压缩包得到 ets、js、native 等核心文件夹;
6.找到当前 DevEco Studio 中已安装的 SDK 位置,进行替换;
更多推荐
所有评论(0)