本节我们讨论下如果引用一个开源三方库,引入 OpenHarmony 编译并在设备上运行。
1. 开源库结构
我们选取比较简单的 linux-logo 开源库(库地址为:https://github.com/deater/linux_logo),
. ├── configure ├── contrib ├── libsysinfo-0.3.0 ├── linux_logo.c ├── LINUX_LOGO.FAQ ├── linux_logo.h ├── ll_asm ├── load_logo.c ├── load_logo.h ├── load_logos.h ├── logo_config ├── logo_config.BSD ├── logo_config.Irix ├── logo_config.Solaris ├── logos ├── logo_types.h ├── parse_logos ├── parse_logos.c ├── po ├── tests
在 linux 下的运行步骤和结果
●目录 ls
●配置 ./configure
●编译,运行 make&./linux_logo
3. 移植到 OpenHarmony 下进行编译运行
移植到 OpenHarmony 需要在三方库里增加文件夹和 gn 文件。OpenHarmony 里三方库的位置在[代码目录]/third_party 位置
我们可以在三方库里创建文件夹:linuxlogo,然后在 linuxlogo 里创建 BUILD.gn 文件。接下来我们需要拷贝第三方 linuxlog 文件到此文件夹内。然后我们需要阅读三方库的 Makefile 文件。以下是基本的 makefile 的规则:
●makefile 的规则
target... : prerequisites ...
command
...
-----------------------------------------------------------------
●target 就是一个目标文件,可以是 Object File,也可以是执行文件。还可以是一个动作/伪目标/标签(Label),如 clean。
- prerequisites就是,要生成那个target所需要的文件或是目标。
- command也就是make需要执行的命令。(任意的Shell命令)
这是一个文件的依赖关系,target 这一个或多个的目标文件依赖于 prerequisites 中的文件,其生成规则定义在 command 中。在定义好依赖关系后,后续的那一行定义了如何生成目标文件的操作系统命令,make 会一层又一层地去找文件的依赖关系,直到最终编译出第一个目标文件。这就是整个 make 的依赖性。
GNU 的 make 工作时的执行步骤如下:(想来其它的 make 也是类似)
\1. 读入所有的 Makefile。
\2. 读入被 include 的其它 Makefile。
\3. 初始化文件中的变量。
\4. 推导隐晦规则,并分析所有规则。
\5. 为所有的目标文件创建依赖关系链。
\6. 根据依赖关系,决定哪些目标要重新生成。
\7. 执行生成命令。
1-5 步为第一个阶段,6-7 为第二个阶段。第一个阶段中,如果定义的变量被使用了,那么,make 会把其展开在使用的位置。但 make 并不会完全马上展开,如果变量出现在依赖关系的规则中,那么仅当这条依赖被决定要使用了,变量才会在其内部展开。规则包含两个部分,一个是依赖关系,一个是生成目标的方法。
查看 makefile(内部有一些关键命令的注释)
Makefile 会告诉 make 命令做什么(通常是如何编译和链接程序)。
路径: /../Makefile
-include Makefile.default
PROGNAME = linux_logo
#ifeq ($(OS),IRIX64)
# LDFLAGS += -lintl
#endif
ifeq ($(OS),FreeBSD)
LDFLAGS += -lintl
endif
#
# Installation location
#
INSTALL_BINPATH = $(DESTDIR)$(PREFIX)/bin
INSTALL_MANPATH = $(DESTDIR)$(PREFIX)/share/man
INSTALL_DOCPATH = $(DESTDIR)$(PREFIX)/share/doc
#
# Libsysinfo location
#
LIBSYSINFO_INCLUDE = -I$(LIBSYSINFO)
LIBSYSINFO_LIBRARY = -L$(LIBSYSINFO)
ifneq ($(XGETTEXT),)
TRANSLATIONS = translations
endif
all: Makefile.default parse_logos linux_logo $(TRANSLATIONS)
Makefile.default:
ifneq($(CONFIGURE_RAN),1)
$(error Please run configure first)
endif
translations:
cd po && $(MAKE)
logos-all: logo_config
find ./logos -type f -a ! -name banner.logo -a ! -name classic.logo | sort >> logo_config
$(MAKE) all
logo_config:
echo "./logos/banner.logo" > logo_config
echo "./logos/classic.logo" >> logo_config
clean: Makefile.default
rm -f *.o
rm -f linux_logo linux_logo-dyn parse_logos load_logos.h
rm -f *~
cd $(LIBSYSINFO) && $(MAKE) clean
cd po && $(MAKE) clean
distclean: clean
cd $(LIBSYSINFO) && $(MAKE) distclean
rm -f Makefile.default logo_config
# rm -f po/linux_logo.pot
#此处即为我们最终生成的linux_logo二进制文件,他依赖linux_logo.o,load_logo.o两个中间文件和libsysinfo.a这个库
linux_logo: linux_logo.o load_logo.o ./$(LIBSYSINFO)/libsysinfo.a
$(CROSS)$(CC) $(LDFLAGS) -o linux_logo linux_logo.o load_logo.o $(LIBSYSINFO_LIBRARY) ./$(LIBSYSINFO)/libsysinfo.a
linux_logo_shared: linux_logo.o load_logo.o ./$(LIBSYSINFO)/libsysinfo.a
$(CROSS)$(CC) $(CFLAGS) -o linux_logo-dyn linux_logo.o load_logo.o $(LIBSYSINFO_LIBRARY) -lsysinfo
#此处为libsysinfo.a库的编译脚本,他会进入$(LIBSYSINFO)目录再执行make命令
./$(LIBSYSINFO)/libsysinfo.a:
cd $(LIBSYSINFO) && $(MAKE)
parse_logos: parse_logos.o load_logo_native.o
$(CC) $(LDFLAGS) -o parse_logos parse_logos.o load_logo_native.o
parse_logos.o: parse_logos.c logo_config
$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c parse_logos.c
load_logos.h: logo_config parse_logos
./parse_logos
load_logo.o: load_logo.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c load_logo.c
load_logo_native.o: load_logo.c
$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -o load_logo_native.o -c load_logo.c
#此处即为我们最终生成的linux_logo文件的main函数
linux_logo.o: linux_logo.c defaults.h load_logos.h
@echo Compiling for $(OS)
@echo Edit defaults.h to change Default Values
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) \
-DLOCALE_DIR=\"$(PREFIX)/share/locale\" -DUSE_I18N=$(USE_I18N) \
-c linux_logo.c
install: linux_logo
$(INSTALL) -c -m755 $(PROGNAME) -D $(INSTALL_BINPATH)/$(PROGNAME)
$(INSTALL) -c -D -m644 $(PROGNAME).1.gz $(INSTALL_MANPATH)/man1/$(PROGNAME).1.gz
cd po && $(MAKE) install
install-doc:
$(INSTALL) -c -d -m 755 $(INSTALL_DOCPATH)/$(PROGNAME)
$(INSTALL) -c -p -m 644 *[A-Z] $(INSTALL_DOCPATH)/$(PROGNAME)
# The old way of installing
install-by-copying:
cp linux_logo $(PREFIX)/bin
进而查看 libsysinfo.a 静态库下的 makefile
路径:/../libsysinfo-0.3.0/Makefile
include Makefile.default
all: libsysinfo.a
clean:
rm -f *.o *~
rm -f libsysinfo.a libsysinfo.so config.h
cd AIX && $(MAKE) clean
cd Linux && $(MAKE) clean
cd FreeBSD && $(MAKE) clean
cd Irix && $(MAKE) clean
cd SunOS && $(MAKE) clean
cd w32 && $(MAKE) clean
cd all && $(MAKE) clean
distclean: clean
rm -f Makefile.default
install:
#选择一种系统类型,本文选用的是arm
libsysinfo.a: Linux/cpuinfo_alpha.c \
Linux/cpuinfo_ia64.c \
Linux/cpuinfo_ppc.c \
Linux/cpuinfo_vax.c \
Linux/cpuinfo_arm.c \
Linux/cpuinfo_m68k.c \
Linux/cpuinfo_s390.c \
Linux/cpuinfo_avr32.c \
Linux/cpuinfo_mips.c \
Linux/cpuinfo_sh3.c \
Linux/cpuinfo_x86.c \
Linux/cpuinfo_cris.c \
Linux/cpuinfo_parisc.c \
Linux/cpuinfo_sparc.c \
Linux/sysinfo_linux.c
#进入all目录进行编译
cd all && $(MAKE)
#进入$(OS)目录进行编译
cd $(OS) && $(MAKE)
$(CROSS)$(AR) crus libsysinfo.a ./$(OS)/*.o ./all/*.o
#此处为libsysinfo.a库的链接命令,此处也依赖了$(OS)和all文件夹里的内容
shared: libsysinfo.a
ld -shared -o libsysinfo.so ./$(OS)/*.o ./all/*.o
查看 all 文件下的 makefile
路径: /../libsysinfo-0.3.0/all/Makefile
include ../Makefile.default
all: bogomips.o fix_mhz.o parsing.o string_truncate.o sysinfo_common.o uname.o
bogomips.o: bogomips.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c bogomips.c
fix_mhz.o: fix_mhz.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c fix_mhz.c
parsing.o: parsing.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c parsing.c
sysinfo_common.o: sysinfo_common.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c sysinfo_common.c
string_truncate.o: string_truncate.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c string_truncate.c
uname.o: uname.c
$(CROSS)$(CC) $(CFLAGS) $(LIBSYSINFO_INCLUDE) -c uname.c
clean:
rm -f *.o
rm -f *~
4. 编译开源库
在 BUILD.gn 文件里增加以下内容。可以参考 third-party/libuv/BUILD.gn 里的内容
ohos_executable("linuxlogo"){
include_dirs=[
"linux_logo-master",
"linux_logo-master/libsysinfo-0.3.0",
"linux_logo-master/libsysinfo-0.3.0/include",
]
sources=[
"linux_logo-master/linux_logo.c",
"linux_logo-master/load_logo.c",
"linux_logo-master/libsysinfo-0.3.0/Linux/cpuinfo_arm.c",
"linux_logo-master/libsysinfo-0.3.0/all/bogomips.c",
"linux_logo-master/libsysinfo-0.3.0/all/fix_mhz.c",
"linux_logo-master/libsysinfo-0.3.0/all/parsing.c",
"linux_logo-master/libsysinfo-0.3.0/all/string_truncate.c",
"linux_logo-master/libsysinfo-0.3.0/all/sysinfo_common.c",
"linux_logo-master/libsysinfo-0.3.0/all/uname.c",
"linux_logo-master/libsysinfo-0.3.0/Linux/sysinfo_linux.c",
]
}
完成后,这个开源库还需要有一个入口进行加载,在此文章中我们仍然选取 graphic 的 BULID.gn 进行依赖添加
路径:test/xts/acts/grahpic/BUILD.gn
import("//build/ohos_var.gni")
group("graphic") {
testonly = true
if (is_standard_system) {
deps = [
"webGL:webGL_hap_test",
"windowstandard:window_hap_test",
//增加下面这行引入依赖
"//third_party/libuv:linuxlogo",
]
} else {
deps = [
"appaccount:appaccount_hap",
"osaccount:osaccount_hap",
]
}
}
在源码根目录下执行
./build.sh --product-name rk3568 --gn-args build_xts=true --build-target "acts" --gn-args is_standard_system=true
5. 执行开源库
编译完成后生成的****第三方库验证程序 linuxlogo 使用流程
库文件会输出****linuxlogo,路径为:out/rk3568/common/common
hrt@ubuntu:~/oh31/out/rk3568/common/common$ ls
glcts libdeqp_ohos_platform.z.so libhmicui18n.z.so libphonenumber_standard.z.so librosen_context.z.so libc libgif.z.so libhmicuuc.z.so linuxlogo
libprotobuf_standard.z.so libsqlite.z.so
1. 拷贝linuxlogo到板子上
hdc_std.exe file send linuxlogo /data/local/tmp
//2. 登录板子,运行linuxlogo,如果第一次需要给权限
pc端:hdc_std.exe shell
板子:cd /data/local/tmp
板子:chmod +x runtest
板子:./linuxlogo
6. 结果显示
补充
在此,想说关于程序编译的一些规范和方法,一般来说,C、C++ 代码要先把源文件编译成中间代码文件,在 Windows 下也就是 .obj 文件,Linux 下是 .o 文件,即 Object File,这个动作叫做编译(compile)。然后再把大量的 Object File 合成执行文件,这个动作叫作链接(link)。
编译时,是要确定编译目标所需要的源文件。编译器需要的是正确的语法,正确的函数与变量声明。对于后者,通常是需要告诉编译器头文件的所在位置(头文件中应该只是声明,而定义应该放在 C/C++ 文件中),只要所有的语法正确,编译器就可以编译出中间目标文件。一般来说,每个源文件都应该对应于一个中间目标文件(O 文件或是 OBJ 文件)。
链接时,是确定链接的时候需要依赖的额外的库。主要是链接函数和全局变量,所以,可以使用这些中间目标文件来链接我们的应用程序。链接器并不管函数所在的源文件,只管函数的中间目标文件,在大多数时候,由于源文件太多,编译生成的中间目标文件太多,而在链接时需要明显地指出中间目标文件名,这对于编译很不方便,所以,我们要给中间目标文件打个包生成库文件,在 Windows 下是 Library File,也就是 .lib 文件;在 UNIX 下,是 Archive File,即为.a 文件。
总结就是,源文件首先会生成中间目标文件,再由中间目标文件生成执行文件。在编译时,编译器只检测程序语法,和函数、变量是否被声明。如果函数未被声明,编译器会报警告,但可以生成 Object File。而在链接程序时,链接器会在所有的 Object File 中找寻函数的实现,如果找不到,那到就会报 Linker Error。
总结
本文主要介绍了在 OpenHarmony 下如何移植一个开源库,手写一个 BUILD.gn、编译运行
写在最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)文档用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)文档包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习文档能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习文档
鸿蒙(HarmonyOS NEXT)5.0最新学习路线
有了路线图,怎么能没有学习文档呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习文档
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V3.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……
《鸿蒙开发进阶》
●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……
《鸿蒙进阶实战》
●ArkTS实践
●UIAbility应用
●网络案例
……