鸿蒙南向开发——GN快速入门指南

运行GN(Generate Ninja)

运行gn，你只需从命令行运行gn，对于大型项目，GN是与源码一起的。

  • 对于Chromium和基于Chromium的项目，有一个在depot_tools中的脚本，它需要加入到你的PATH环境变量中。该脚本将在包含当前目录的源码树中找到二进制文件并运行它。
  • 对于Fuchsia树内开发，运行fx gn ...，它将找到正确的GN二进制文件，并使用给定的参数运行它。

设置一个构建

与其他一些构建系统不同，在GN中你可以设置你自己的构建目录，和你想要的设置。这让你可以根据需要维护不同的构建，可以根据自己的需要并行维护不同的构建。

一旦你生成了一个构建目录，ninja文件将被自动生成，如果你在该目录下进行构建时，文件已经过期，ninja则会自动重新生成，所以你不必重新运行gn。

建立一个构建目录：

gn gen out/my_build

配置构建参数

在你的构建目录上运行设置构建参数：

gn args out/my_build

这将弹出一个编辑器，在该文件中输入build args，像这样：

is_component_build = true
is_debug = false

可用的变量将取决于你的构建，你可以看到可用参数的列表和它们的默认值。

通过键入:

gn args --list out/my_build

可以看到可用的参数列表和默认值，这个命令必须指定编译目录，因为不同的目录有不同的参数值。

Chrome的开发者也可以阅读Chrome特有的构建配置说明以了解更多信息。

交叉编译至目标操作系统或架构

运行 gn args out/Default（根据需要替换成你的构建目录），然后为常见的交叉编译选项添加以下一行或多行:

target_os = "chromeos"
target_os = "android"target_cpu = "arm"
target_cpu = "x86"
target_cpu = "x64"

更多信息请参见 GN cross compiles 。

添加BUILD.gn的详细步骤

添加一个构建文件

转到examples/simple_build目录，这是一个最小的GN仓库的root目录。

在该目录中，有一个tutorial目录。这里已经有一个tutorial.cc文件，但没有与构建挂钩。在该目录中为我们的新目标创建一个新的BUILD.gn文件，用于我们的新目标:

executable("tutorial") {sources = ["tutorial.cc"]
}

现在我们只需要告诉编译器这个新的目标。

打开目录（simple_build）下的BUILD.gn文件，GN从加载这个根文件，然后从这里开始加载所有的依赖项，所以我们只需要在这里添加对这个文件中的新目标的引用。

你可以把我们的新目标作为一个依赖关系加入到现有的目标中去，但把一个可执行文件作为依赖关系并没有什么意义。通常情况下，将一个可执行文件作为另一个可执行文件的依赖项是没有意义的（它们不能被链接）。

所以让我们做一个 tools group组。在GN中，一个group只是一个依赖关系的集合，没有编译或链接:

group("tools") {deps = [# 这将扩展到"//tutorial:tutorial "这个名字，这是新目标的全名# 新目标，运行 "gn help labels "可以获得更多信息# ‘//’双斜杠代表的是从source-root目录开始的路径，也可以用绝对路径来写，比如'/usr/local/foo:bar'"//tutorial"]
}

执行gn help labels可以看到help的详细的解释，关于如何添加子目录的目标到BUILD.gn里面。

测试你的添加

从simple_build目录下的命令行:

$ gn gen out$ ninja -C out tutorialninja: Entering directory `out'[2/2] LINK tutorial

执行./out/tutorial

你应该看到 Hello from the tutorial.输出到控制台。

题外话：GN鼓励静态库的目标名称不是全局唯一的。要建立一个这样的库，你可以把标签和它的路径（但没有前面的//）给ninja：

ninja -C out some/path/to/target:my_target

所以前面的tutorial可以是：

$ ninja -C out tutorial:tutorialninja: Entering directory `out'ninja: no work to do.

声明依赖性

让我们看看在下列文件examples/simple_build/BUILD.gn中定义的目标。这里有一个静态库定义了一个函数，GetStaticText()：

static_library("hello_static") {sources = [	"hello_static.cc",    "hello_static.h",    ] }

还有一个共享库，定义了一个函数GetSharedText()：

shared_library("hello_shared") {	sources = [		"hello_shared.cc",		"hello_shared.h",    ]	defines = [ "HELLO_SHARED_IMPLEMENTATION" ]}

这也说明了如何为一个目标设置预处理程序的定义，要设置多个以上的定义或赋值，请使用这种形式：

defines = [    "HELLO_SHARED_IMPLEMENTATION",    "ENABLE_DOOM_MELON=0",]

现在我们来看看依赖这两个库的可执行文件：

executable("hello") {    sources = [    	"hello.cc",    ]         # 以冒号开头的标签指的是当前BUILD.gn文件中的标签    deps = [    	":hello_shared",    	":hello_static",    ]}

这个可执行文件包括一个源文件，并依赖于前面的两个库，以冒号开头的标签指的是当前BUILD.gn文件中具有该名称的目标。

测试二进制文件

在simple_build目录下的命令行中:

ninja -C out helloout/hello

注意，你不需要重新运行GN。当任何构建文件发生变化时，GN会自动重新构建
ninja文件。因为ninja在开始执行时打印出[1/1] Regenerating ninja files时，你就知道这个发生了。

将设置放在config中

一个库的用户经常需要用到compile flags、 defines、include directories，要做到这一点，把所有这些设置放到一个 "config "中就可以，这是一个命名的设置集合（但不包括源和依赖关系）。

config("my_lib_config") {  defines = [ "ENABLE_DOOM_MELON" ] 。  include_dirs = [ "//third_party/something" ] 。}

要将一个配置的设置应用于目标，请将其添加到configs列表中。

static_library("Hello_shared") {  ...  # 注意这里的 "+="通常是必须的，见下面的 "默认配置"。  configs += [    ":my_lib_config",  ]}

一个配置可以应用于所有依赖当前配置的目标，只要把它的标签放在public_configs 列表中。

static_library("Hello_shared") {  ...  public_configs = [    ":my_lib_config",  ]}

public_configs也适用于当前的目标，所以不需要在两个地方都列出一个配置。

默认配置

构建配置将设置一些默认适用于每个target的设置。

默认情况下，这些通常会被设置为默认的配置列表。你可以用print命令看到 你可以使用print命令看到这一点，这对调试很有用:

executable("hello") {  print(configs)}

运行GN将打印类似的东西:

$ gn gen out["//build:compiler_defaults", "//build:executable_ldconfig"]

目标可以修改这个列表以改变其默认值。

例如，构建设置可能会通过添加no_exceptions配置来默认关闭异常，但目标可以通过用不同的配置来重新启用它们:

executable("hello") {  ...  configs -= [ "//build:no_exceptions" ] # 删除全局默认。  configs += [ "//build:exceptions" ] # 用一个不同的来代替.}

我们上面的打印命令也可以用字符串插值来表达，这是一种将数值转换成字符串的方法。它使用符号"$"来指代一个变量。

print("The configs for the target $target_name are $configs")

执行ninja -C out hello

$ ninja -C out helloninja: Entering directory `out'[0/1] Regenerating ninja filesThe configs for the target hello are ["//build:compiler_defaults", "//build:executable_ldconfig"]ninja: no work to do.

添加一个新的构建参数

你可以通过declare_args声明你接受哪些参数并指定默认值。

declare_args() {  enable_teleporter = true  enable_doom_melon = false}

参见gn help buildargs以了解其工作原理。
参见gn help declare_args以了解声明参数的具体细节。

在一个给定的范围内多次声明一个参数是一个错误，所以在确定参数的范围和命名时应该谨慎。

不知道发生了什么？

你可以在verbose模式下运行GN，以看到很多详细过程，使用-v参数就可以：

$ gn gen out -vUsing source root /home/hui/disk4t/codes/gn/examples/simple_buildGot dotfile /home/hui/disk4t/codes/gn/examples/simple_build/.gnUsing build dir //out/Loading //build/BUILDCONFIG.gnLoading //BUILD.gnRunning //BUILD.gn with toolchain //build/toolchain:gccThe configs for the target hello are ["//build:compiler_defaults", "//build:executable_ldconfig"]Defining target //:hello(//build/toolchain:gcc)Defining target //:hello_shared(//build/toolchain:gcc)Defining target //:hello_static(//build/toolchain:gcc)Defining target //:tools(//build/toolchain:gcc)Loading //build/BUILD.gn (referenced from //build/BUILDCONFIG.gn:22)Loading //build/toolchain/BUILD.gn (referenced from //BUILD.gn:5)Loading //tutorial/BUILD.gn (referenced from //BUILD.gn:34)Running //build/BUILD.gn with toolchain //build/toolchain:gccRunning //tutorial/BUILD.gn with toolchain //build/toolchain:gccDefining config //build:compiler_defaults(//build/toolchain:gcc)Defining target //tutorial:tutorial(//build/toolchain:gcc)Defining config //build:executable_ldconfig(//build/toolchain:gcc)Running //build/toolchain/BUILD.gn with toolchain //build/toolchain:gccDefining toolchain //build/toolchain:gccComputing //:hello_shared(//build/toolchain:gcc)Computing //:hello_static(//build/toolchain:gcc)Computing //:hello(//build/toolchain:gcc)Computing //tutorial:tutorial(//build/toolchain:gcc)Computing //:tools(//build/toolchain:gcc)Done. Made 5 targets from 5 files in 5ms

"desc "命令

你可以运行gn desc <build_dir> <targetname>来获取有关
一个给定的目标。

gn desc out //tutorial:tutorialThe configs for the target hello are ["//build:compiler_defaults", "//build:executable_ldconfig"]Target //tutorial:tutorialtype: executabletoolchain: //build/toolchain:gcc...

获取ldflags信息

$ gn desc out //tutorial:tutorial ldflagsThe configs for the target hello are ["//build:compiler_defaults", "//build:executable_ldconfig"]-Wl,-rpath=$ORIGIN/-Wl,-rpath-link=

假设你想知道你的TWO_PEOPLE定义来自哪里:

gn desc out/Default //foo/bar:say_hello defines --blame...lots of other stuff omitted...  From //foo/bar:hello_config       (Added //foo/bar/BUILD.gn:12)    TWO_PEOPLE

另一个特别有趣的变体:

gn desc out/Default //base:base_i18n deps --tree

更多信息见gn help desc。

附：gn labels

关于标签

所有可以参与依赖关系的图（目标、配置和工具链）都由标签来识别，一个常见的标签看起来像：

//base/test:test_support

这个例子包括一个source-root绝对路径、一个冒号和一个target，这意味着要在 "base/test/BUILD.gn "中寻找名为 "test_support "的目标。 如果有必要，你也可以指定系统的绝对路径。通常情况下，这样的路径会通过构建参数来指定，所以开发者可以指定组件在他们系统中的位置。

/usr/local/foo:bar (Posix)/C:/Program Files/MyLibs:bar (Windows)

工具链

一个规范的标签包括正在使用的工具链的标签。通常情况下，工具链标签隐含地继承自当前的执行环境，但你可以覆盖它以指定跨工具链的依赖关系。

//base/test:test_support(//build/toolchain/win:msvc)

这里 GN 将在文件"//build/toolchain/win "中寻找名为 "msvc "的工具链定义，以知道如何编译这个目标。

相对标签

如果你想引用同一构建文件中的东西，你可以省略路径名称，只用冒号开头。这种格式被推荐用于同文件中的标签引用。

:base

标签可以被指定为相对于当前目录的标签。从风格上看，我们更倾向于对所有非文件本地的引用使用绝对路径，除非一个构建文件需要在不同的环境下运行（比如一个项目既需要独立运行，又需要拉到目录层次中不同位置的其他项目中）。

source/plugin:myplugin.../net:url_request

隐式名称

如果一个名字没有被指定，它将继承目录名称。从风格上看，我们倾向于在可能的情况下省略冒号和名称。

//net -> //net:net//tools/gn -> //tools/gn:gn

为了能让大家更好的学习鸿蒙 (OpenHarmony) 开发技术，这边特意整理了《鸿蒙 (OpenHarmony)开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙 (OpenHarmony)开发学习手册》

入门必看：https://qr21.cn/FV7h05

  1. 应用开发导读(ArkTS)
  2. ……

HarmonyOS 概念：https://qr21.cn/FV7h05

  1. 系统定义
  2. 技术架构
  3. 技术特性
  4. 系统安全

如何快速入门？：https://qr21.cn/FV7h05

  1. 基本概念
  2. 构建第一个ArkTS应用
  3. 构建第一个JS应用
  4. ……

开发基础知识：https://qr21.cn/FV7h05

  1. 应用基础知识
  2. 配置文件
  3. 应用数据管理
  4. 应用安全管理
  5. 应用隐私保护
  6. 三方应用调用管控机制
  7. 资源分类与访问
  8. 学习ArkTS语言
  9. ……

基于ArkTS 开发：https://qr21.cn/FV7h05

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/656600.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

常用芯片学习——CD4094芯片

常用芯片学习——CD4094芯片

CD4094 8位移位寄存器/3态输出缓冲器 使用说明 CD4094是由一个 8 位串行移位寄存器和一个 3 态输出缓冲器组成的 CMOS 集成电路。寄存器带有存储锁存功能&#xff0c;集成电路根据 STROBE 信号确定锁存器是否接收移位寄存器各位数据&#xff0c;数据是否由锁存器传输到 3 态输…
阅读更多...
【教学类-35-23】20240130“红豆空心黑体”不能显示的汉字

【教学类-35-23】20240130“红豆空心黑体”不能显示的汉字

作品展示&#xff1a; 背景需求 使用红豆空心黑体制作幼儿字帖&#xff08;涂色版&#xff09; 【教学类-35-22】正式版 20240129名字字卡3.0&#xff08;15CM正方形手工纸、先男后女&#xff0c;页眉是黑体包含全名&#xff0c;名字是红豆空心黑体&#xff09;-CSDN博客文章…
阅读更多...
线性代数---------学习总结

线性代数---------学习总结

线性代数之行列式 行列式的几条重要的性质 1.某两行某两列交换位置之后&#xff0c;值变号 2.行列式转置&#xff0c;值不变 3.范德蒙德行列式&#xff0c;用不同行的公比做一系列的累乘运算 4.把某一行的行列式加到另一行上&#xff0c;利用他们之间的倍数关系&#xff0…
阅读更多...
Could not resolve host: github.com问题解决

Could not resolve host: github.com问题解决

git clone的时候发现机器无法解析github.com&#xff0c;其实应该改用ssh协议去clone&#xff0c;但是我用的是公用的机器&#xff0c;密钥对一直没配置好&#xff0c;所以也就堵死了。那么如果想让机器能解析github.com&#xff0c;&#xff08;机器本身没有ping命令&#xff…
阅读更多...
Python XPath解析html出现⋆解决方法 html出现#123；解决方法

Python XPath解析html出现⋆解决方法 html出现#123；解决方法

前言 爬网页又遇到一个坑&#xff0c;老是出现乱码&#xff0c;查看html出现的是&#数字;这样的。 网上相关的“Python字符中出现&#的解决办法”又没有很好的解决&#xff0c;自己继续冲浪&#xff0c;费了一番功夫解决了。 这算是又加深了一下我对这些iso、Unicode编…
阅读更多...
MySQL原理（二）存储引擎（3）InnoDB

MySQL原理（二）存储引擎（3）InnoDB

目录 一、概况&#xff1a; 1、介绍&#xff1a; 2、特点&#xff1a; 二、体系架构 1、后台线程 2、内存池&#xff08;缓冲池&#xff09; 三、物理结构 1、数据文件&#xff08;表数据和索引数据&#xff09; 1.1、作用&#xff1a; 1.2、共享表空间与独立表空间 …
阅读更多...
计算机网络——静态路由的配置实验

计算机网络——静态路由的配置实验

1.实验题目 实验四&#xff1a;静态路由的配置 2.实验目的 1.了解路由器的基本配置。 2.实现对路由器的静态配置。 3.了解Ping命令和trace的原理和使用 3.实验任务 &#xff08;1&#xff09;路由器的基本配置&#xff1a;关闭域名解释&#xff1b;设置路由器接口 IP 地…
阅读更多...
网络地址相关函数一网打尽

网络地址相关函数一网打尽

这块的函数又多又乱&#xff0c;今天写篇日志&#xff0c;以后慢慢补充 1. 网络地址介绍 1.1 ipv4 1.1.1 点、分十进制的ipv4 你对这个地址熟悉吗&#xff1f; 192.168.10.100&#xff0c;这可以当做一个字符串。被十进制数字、 “ . ”分开。IP地址的知识就不再多讲…
阅读更多...
一文速学-selenium高阶操作连接已存在浏览器

一文速学-selenium高阶操作连接已存在浏览器

前言 不得不说selenium不仅在自动化测试作为不可或缺的工具&#xff0c;在数据获取方面也是十分好用&#xff0c;能够十分快速的见到效果&#xff0c;这都取决于selenium框架的足够的灵活性&#xff0c;甚至在一些基于web端的自动化办公都十分有效。 通过selenium连接已经存在…
阅读更多...
【解决】No match for argument: gflags-devel

【解决】No match for argument: gflags-devel

背景 在centos-8中安装gflags-devel&#xff0c;直接dnf安装&#xff0c;失败了。 [rootpcs2 ~]# sudo dnf -y install gflags-devel Extra Packages for Enterprise Linux 8 - x86_64 Extra Packages…
阅读更多...
什么是Vue Vue入门案例

什么是Vue Vue入门案例

一、什么是Vue 概念&#xff1a;Vue (读音 /vjuː/&#xff0c;类似于 view) 是一套 构建用户界面 的 渐进式 框架 Vue2官网&#xff1a;Vue.js 1.什么是构建用户界面 基于数据渲染出用户可以看到的界面 2.什么是渐进式 所谓渐进式就是循序渐进&#xff0c;不一定非得把V…
阅读更多...
华为radius认证

华为radius认证

组网需求 如图1所示&#xff0c;用户同处于huawei域&#xff0c;Router作为目的网络接入服务器。用户需要通过服务器的远端认证才能通过Router访问目的网络。在Router上的远端认证方式如下&#xff1a; Router对接入用户先用RADIUS服务器进行认证&#xff0c;如果认证没有响应…
阅读更多...
（M)UNITY三段攻击制作

（M)UNITY三段攻击制作

三段攻击逻辑 基本逻辑&#xff1a; 人物点击攻击按钮进入攻击状态&#xff08;bool isAttack&#xff09; 在攻击状态下&#xff0c; 一旦设置的触发器&#xff08;trigger attack&#xff09;被触发&#xff0c;设置的计数器&#xff08;int combo&#xff09;查看目前攻击…
阅读更多...
基于JAVA+SpringBoot+Vue的前后端分离的美食分享推荐平台2

基于JAVA+SpringBoot+Vue的前后端分离的美食分享推荐平台2

✌全网粉丝20W,csdn特邀作者、博客专家、CSDN新星计划导师、java领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java技术领域和毕业项目实战✌ &#x1f345;文末获取项目下载方式&#x1f345; 一、项目背景介绍&#xff1a; 在当今社会&#xff0…
阅读更多...
自然语言处理（NLP）技术使用

自然语言处理（NLP）技术使用

自然语言处理&#xff08;NLP&#xff09;技术使用 以下是一些自然语言处理&#xff08;NLP&#xff09;技术的例子&#xff1a;以上只是一些NLP技术的例子&#xff0c;还有许多其他的技术和应用&#xff0c;如文本分类、文本生成、问答系统等。NLP技术的发展正逐渐改变人们与计…
阅读更多...
手撕红黑树

手撕红黑树

目录 性质 插入规则 调整方法 插入在grandfather的左子树 uncle存在为红色&#xff08;变色&#xff09; uncle不存在或存在为黑色&#xff08;旋转变色&#xff09; 插入在grandfather的右子树 uncle存在且为红色&#xff08;变色&#xff09; uncle不存在或者存在为黑…
阅读更多...
Whatsapp 相关(七) -网络请求

Whatsapp 相关(七) -网络请求

本篇主要用来完善上篇文章 frida 监测网络请求的. whatsapp相关(五)- frida监测网络请求 1: 脚本 本次的脚本与上次的区别是,之前只能输出请求的地址,本次优化后,可输出请求参数,结果等. 代码如下: Java.perform(function () {var HttpURLConnection Java.use(java.net.H…
阅读更多...
如何在DBeaver中重命名数据库

如何在DBeaver中重命名数据库

前言 DBeaver是一款强大的开源通用数据库管理和开发工具&#xff0c;支持多种数据库类型。在某些数据库系统中&#xff0c;你可以直接通过DBeaver的图形界面来重命名数据库名称。本文将详细介绍如何在DBeaver中进行数据库重命名操作。 重要提示&#xff1a; 对于不同的数据库…
阅读更多...
15EG使用vivado2021.1实现LWIP的网络传输

15EG使用vivado2021.1实现LWIP的网络传输

创建工程模板在hello_world中已经介绍过了&#xff0c;这里直接从配置完zynq ip核开始&#xff0c;由于使用vivado的版本不同&#xff0c;配置ZYNQ时需要用到的tcl文件我会放在工程文件夹下的file文件夹中 配置好IP核后&#xff0c;右键设计模块&#xff0c;点击Generate Outpu…
阅读更多...
【通信系统】MIMO阵列信号来向DOA估计实现~含FOCUSS、OMP、贝叶斯学习(SBL)等稀疏重构法和常规、子空间法、空间平滑滤波法

【通信系统】MIMO阵列信号来向DOA估计实现~含FOCUSS、OMP、贝叶斯学习(SBL)等稀疏重构法和常规、子空间法、空间平滑滤波法

MIMO阵列目标信号来向估计原理与实现~基于常规法、子空间变换法和稀疏恢复法 写在最前前言空间谱估计的历史发展 仿真原理离散时间阵列信号模型波束形成矩阵(完备字典)回波生成空间平滑滤波传统方法CBF~常规波束成型Capon~最小方差无失真响应法ML~最大似然估计法 子空间方法MUS…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023