问题现象
语法错误问题导致的编译构建报错,具体表现包括但不限于以下几种场景:
- 场景一:
执行设置环境变量DEVECO_CANGJIE_PATH = "${HOME}/cangjie",执行build,其中一个Linux编译正常,另外一个环境编译失败。编译构建时报错:cannot find crtbeginS.o: No such file or directory。
- 场景二:
DevEco Studio没有导入BusinessError,编译没有报错,但是打包会报错:Error Message: Cannot find name 'BusinessError'。
- 场景三:
C++模块构建报错自定义头文件找不到。
- 场景四:
编译构建时报错:error: unknown type name ‘_Bool’。
- 场景五:
编译构建时告警:Switching off type checks with in-place comments is not allowed (arkts-strict-typing-required)。
- 场景六:
编译构建时报错:hvigor ERROR: Error: Cannot read properties of undefined (reading 'xxx') 。
- 场景七:
编译构建时报错:Unknown resource name 'XXX'或Error: Cannot find module 'xxx'。
- 场景八:
编译构建时报错:arkts-no-any-unknown或Cannot find module 'xx' or its corresponding type declarations。
- 场景九:
编译构建时报错:hvigor ERROR: 'xx' is not a function。
问题定位
- 场景一:
基于报错关键字:cannot find crtbeginS.o: No such file or directory。可知是cjc没有考虑到Amazon Linux系统的路径造成的问题。
- 场景二:
检查Command Line Tools版本,版本过低会产生该问题。
- 场景三:
检查模块下文件:
- index.d.ts里的方法定义是否已改为export const ping: (a: string) => string。
- CMakeLists.txt里的add_library函数是否添加了ping.cpp入参。
- 场景四:
在C99标准之前,C语言只能通过宏定义的方式使用布尔类型,而_Bool类型是C99标准引进的,通过标准库头文件<stdbool.h>定义了bool,true,false。
- 场景五:
ArkTS不支持通过注释的方式绕过严格类型检查,检查问题代码是否使用了类似// @ts-nocheck或者// @ts-ignore的注释。参考文档。
- 场景六:
主要原因为变量未定义或为空和预期类型错误,以下逐步排查:
- 变量未定义或为空: 在调用xxx方法前,未对目标变量进行有效初始化或赋值,导致其值为undefined。
- 预期类型错误: 比如xxx是字符串(String)或数组(Array)的内置方法,若目标变量非这两种类型(如数字、对象或undefined),将引发此错误。
- 场景七:
出现该类错误,一般是资源没有定义导致,根据报错的资源标签到对应目录下查看该资源是否存在。
- 场景八:
此报错场景常源于引用中的大小写问题。
- 场景九:
检查是否是在开发工具引入了三方的加固插件没有适配当前版本,导致报错。
分析结论
- 场景一:cjc没有考虑到Amazon Linux系统的路径造成的问题。
- 场景二:Command Line Tools版本过低。
- 场景三:模块下index.d.ts及CMakeLists.txt未正确编写。
- 场景四:不支持C99标准引入的_Bool类型。
- 场景五:ArkTS不支持通过类似// @ts-nocheck或者// @ts-ignore的注释方式绕过严格类型检查。
- 场景六:变量未定义或为空和预期类型错误。
- 场景七:资源不存在、损坏或无法访问。
- 场景八:引用中存在大小写问题。
- 场景九:开发工具引入的三方加固插件没有适配当前版本导致报错。
修改建议
- 场景一:
问题原因是cjc没有考虑到Amazon Linux系统的路径,需要补充额外的“-B”配置(不同Linux发行版本会有一些小差异),具体操作如下:升级gcc版本,修改toml配置文件的内容,[target.x86_64-unknown-linux-gnu],补充compile-option="-B/usr/lib/gcc/x86_64-amazon-linux/11",用于指定gcc的库目录。
- 场景二:
更新Command Line Tools至新版本。
- 场景三:
- index.d.ts里的方法定义改为export const ping: (a: string) => string。
- CMakeLists.txt里的add_library函数添加ping.cpp入参。
- 场景四:
- 在报错的代码文件中引入<stdbool.h>头文件,并将代码中的_Bool替换为bool。
- 如果无法修改源码,可以手动定义_Bool布尔类型。
- 场景五:
检查问题代码,将注释(// @ts-nocheck或者// @ts-ignore)删去,再根据报错信息修改其他代码。这些警告不会导致编译失败,应用多数场景下可以正常编译和运行。
- 场景六:
- 变量未定义或为空:在调用方法前,可使用条件判断确保变量已初始化:if (targetVariable !== undefined && targetVariable !== null) { // ... }
- 预期类型错误:在调用方法前,可使用条件判断确保目标变量是对应类型:if (typeof targetVariable === 'string' || Array.isArray(targetVariable)) { // ... }
若以上排查仍存在问题,建议清除编译缓存,再重新启动。该报错下的其余可能原因可以查看参考文档。
- 场景七:
在资源标签指向的目录下添加对应资源/访问权限,或者修改正确的资源标签。
- 场景八:
本地可以尝试将大小写检查的开关打开,检查大小写问题并修改,配置方法是build-profile.json5文件strictMode字段中的"caseSensitiveCheck"设置为true。
- 场景九:
更新对应当前DevEco Studio版本的三方加固插件版本,或者更新至最新的插件即可解决。