#创作者激励#OpenHarmony南向编译出错自查手册 原创 精华

【本文正在参加2023年第一期优质创作者激励计划】
在长期的OpenHarmony教学过程中,发现经常会有学员被一些低级的,重复出现的错误所困扰,有些是因为粗心,有些是对原理和机制理解不到位,而一遍一遍的讲解此种错误,不仅耗费巨量的时间,而且长此以往会消磨执教人员的耐性,变得易怒,本篇就用来记录个种常见的错误,以供学员和各位初学者用来自查之用.
以下每种错误都非常典型,每个错误都配有截图和文字说明,一般对照来看可解决90%以上的新手入门问题,并会在后续的教学活动中持续改进,建议收藏,

1. 之前是好的.有一次输入hb set提示找不到hb工具

原因分析:没有在源码目录内执行,简单判断是否源码目录就看目录里面有没有一个ohos_config.json文件:

解决办法:cd到源码所在目录内再执行hb set
知识点:执行linux指令的时候需要注意当前工作目录

2.提示Unable to load xxx

原因分析:在BUILD.gn内没有对应的目录,导致到不到该路径下的BUILD.gn文件
解决办法:修改BUILD.gn内的目录名称或检查对应的名称有没有写错,如大小写,空格等问题,特别是有些学员会粗心大意,目录名称前有空格或者大写的L与I没有区分

此时重命名就会发现:


知识点:BUILD.gn内deps的写法,冒号前是文件夹名称

3.提示unresolved xxx dependencies … need by xxx

原因分析:在BUILD.gn同级的文件夹内的BUILD.gn声明的static_library名称与deps里面的不一致
解决办法:修改deps内的冒号后面的库名称或者将文件夹内BUILD.gn声明的static_library改成与deps内一致
知识点:deps内冒号后面的内容是对应文件夹内的库名称
补充知识:对于deps内的内容是出错的高危区,出现这种错误一般是对deps机制不理解导致,现用一图来说明deps到底改怎么写:

4.提示 ERROR at xxx/BUILD.gn:25:12: Assignment had no effect.

[OHOS INFO] source = [

原因分析:source单词拼写错误,正确写法是sources,同样的其他类似问题如:

也是单词拼写错误
解决办法:将对应报错的单词改成正确的名称
知识点:正确的名称为sources和include_dirs,如下图:

推荐安装gn插件,有颜色提示,还可以方便进行快捷键注释,括号补全等操作

在安装之前:

安装之后:

如果某一变量不是内置变量,则不能正确高亮:

5.提示ninja error: … needed by xxx.o, missing and unkonow rule to make it

原因分析:在static_library内的sources列表中将.c文件名写错了导致编译时候找不到对应的源文件
解决办法:修改sources内的c文件名或者修改文件系统内的文件名使之与sources里的文件一致
知识点:c语言编译时依靠文件名寻找文件,对应的文件不存在则报错

6.提示某个符号未定义:undefined reference to xxx

原因分析:函数/变量名写错或调用一个根本不存在的函数/变量
解决方式:将函数/变量名修改正确即可
知识点:c语言编译的相关知识

7.提示too few arguments to function xxx

原因分析:c语言函数参数个数传错
解决方式:正确传入参数
知识点:c语言基础知识

8. 提示 Expected comma between items.

原因分析:在gn中列表的两行数据没有用逗号隔开,如下:

解决方式:输入一个英文的逗号即可,建议:每一个列表项后面跟上一个逗号
知识点:gn的基础知识

9. 提示Replacing nonempty list.

原因分析:尝试覆盖一个非空的列表,如下例:

解决方式:在下一个变量处使用+=即可解决,+=代表在后面追加

知识点:gn的基础知识

10.提示:fatal error: xxxx.h: No such file or directory

原因分析:在某个c文件里引用了某个头文件,但是没有在include_dirs里包含这个头文件的路径

解决方式:在include_dirs内添加这个头文件即可,写在内部或使用+=在后面追加都行

知识点:c语言编译相关知识点

11.待定…