代码中引入'@kit.CoreSpeechKit',如下面代码所示:
import { speechRecognizer } from '@kit.CoreSpeechKit'; 会报错提示:
Cannot find module '@kit.CoreSpeechKit' or its corresponding type declarations. <ArkTSCheck>
OpenHarmony 13版本下,无法找到和引入UIExtensionComponent系统接口,且在SDK中也没有找到相关的d.ts文件。
在DevEco Studio 3.1 Release版本中下载API 7 SDK时失败,提示"Could not found download URL, the network or server is abnormal"。
在build-profile.json5文件中配置"runtimeOS": "OpenHarmony"后,DevEco Studio中UI层报错。
开发者在DevEco Studio工具中尝试下载SDK时出现网络异常问题,可能是由于全局路由服务(Global Routing Service)缓存文件,即位于本地目录C:\Users\用户名\AppData\Local\Huawei\DevEcoStudio\caches\下的grs.json文件失效。
可能的原因包括但不限于:网络环境异常、路由节点过期、由于DevEco Studio非正常关闭导致grs.json文件损坏。
该问题的核心在于应用的编译配置与手机系统版本之间的匹配机制。开发者混淆了"开发环境的SDK版本"与"手机系统的运行库版本"之间的关系,担心高版本特性的依赖项无法在低版本系统中存在。
开发者在OpenHarmony 13环境下尝试调用UIExtensionComponent系统接口时,发现开发工具的SDK中缺失该组件相关的.d.ts文件,其根源在于当前工程使用的公共版本SDK(public-SDK),该版本剔除了该接口。
当前已不再维护该历史版本,API 7 SDK在外网无对外下载地址,导致DevEco Studio无法获取有效的下载链接。
检查已下载的SDK文件,发现缺失component_config.json文件,导致DevEco Studio无法正确解析UI组件配置信息,从而出现UI层报错。
删除grs.json文件是非常有效的解决方案。删除该文件本质上是迫使工具在下一次启动或者下载时,重新向调度中心发起全局路由请求,重新获取适配当前网络环境的新下载节点,从而打通网络链路。
HarmonyOS的SDK的运行库内置于手机系统而非随应用打包,因此应用的兼容性本质上取决于"手机系统版本"是否不低于应用配置的SDK版本;一旦用户系统版本过低,高版本特性将因缺少系统底层支持而导致运行异常。
该历史版本已停止维护,API 7 SDK的下载地址已失效,因此DevEco Studio 3.1 Release在尝试下载API 7 SDK时无法找到有效的下载URL。
SDK下载不完整,缺失component_config.json文件,导致DevEco Studio无法正确加载UI组件配置,出现UI层报错。
删除C:\Users\用户名\AppData\Local\Huawei\DevEcoStudio*\caches\下的grs.json文件。
打包后应用的SDK版本,取决于在IDE的File->Project Structure=>Basic Info中的Compatible SDK的版本,安装包是相同的,但是不同用户的手机系统版本可能不同,所以兼容性取决于手机版本和打包时选的SDK版本是否兼容。一般如果打包时选择的SDK版本比较新,建议也同步升级手机系统版本,避免出现不兼容的情况。
OpenHarmony3.2Beta5版本之前可以参考版本说明书手动下载OpenHarmony full-SDK;OpenHarmony3.2Beta5版本及之后不再随版本提供full-SDK包,后续可通过OpenHarmony每日构建平台,根据分支与日期在每日构建或者滚动构建中查找对应版本的full-SDK。
下载对应版本的full-SDK后替换本地SDK包并重新配置后方可正常使用。
具体可参考:如何编译full-SDK,如何替换full-SDK。
可通过以下链接手动下载API 7 SDK,下载后将SDK文件放置于SDK目录hmscore\3.0.0_7下,刷新后查看SDK是否正常显示。
macOS版本下载链接:
如需下载Windows版本,将链接中的"darwin"替换为"Windows"即可。
下载完成后,建议通过SHA256校验文件的完整性和未被篡改。在终端中执行以下命令:
sha256sum 文件名
例如:
sha256sum toolchains-darwin-3.0.0.5-Release.zip