当前位置： 首页 > news >正文

ninja构建笔记

news 来源：原创 2024/9/29 7:15:41

在ninja构建系统中，“rule”和“build”这两个词通常关联但扮演着不同的角色。下面我会详细解释它们的区别：

### Rule (规则)

在构建系统中，“rule”通常指的是构建系统用来指导如何构建文件或者目标的指令集。它定义了一组转换输入到输出的操作，这些操作可以包括编译源代码、链接库、运行预处理脚本等。Rule可以被看作是一种模板，用于说明当特定类型的输出尚未存在时，构建系统应该执行什么操作来生成这个输出。规则通常包含以下元素：

- **条件**：确定何时应用规则。
- **动作**：要执行的命令或操作。
- **依赖关系**：输入文件或其他目标，它们必须先构建完成才能开始当前规则的执行。

### Build (构建)

“Build”则指的是实际执行构建过程的行为，即按照构建系统中定义的规则来创建或更新软件产品的实例。构建过程涉及解析构建配置文件（比如Makefile、build.gradle、CMakeLists.txt等），识别需要构建的目标，然后根据定义的规则执行相应的操作。构建的结果通常是可执行文件、库、文档、测试报告等具体产物。

#### 区别总结：

- **Rule**：是构建系统中的逻辑描述，规定了构建过程中的行为和转换。
- **Build**：是根据构建规则执行的实际操作，产生具体的构建输出。

### 示例

假设你正在使用`make`构建系统，你可能有一个`Makefile`，其中定义了多个`rules`，比如一个规则可能是用于编译`.c`文件成`.o`文件，另一个规则可能是链接所有的`.o`文件生成最终的可执行文件。当你运行`make`命令时，它会读取`Makefile`中的规则，并根据你的请求（构建目标）执行必要的构建步骤，这个执行过程就是`build`。

简而言之，**rule**是在构建中必须遵守的规则，而**build**是基于这些规则执行的实际构建动作，旨在生成具体的产品或副产品。

举例：
rule rule36586
 description = GoogleOneTimeInitializer dexpreopt gen
 command = /bin/bash -c "out/host/linux-x86/bin/dexpreopt_gen     -global_soong out/soong/dexpreopt_soong.config     -global out/soong/dexpreopt_arm64/dexpreopt.config     -module out/target/product/a523-y83/obj/APPS/GoogleOneTimeInitializer_intermediates/dexpreopt.config     -dexpreopt_script out/target/product/a523-y83/obj/APPS/GoogleOneTimeInitializer_intermediates/dexpreopt.sh     -out_dir out"
 restat = 1
build out/target/product/a523-y83/obj/APPS/GoogleOneTimeInitializer_intermediates/dexpreopt.sh: rule36586 out/target/product/a523-y83/obj/APPS/GoogleOneTimeInitializer_intermediates/dexpreopt.config out/soong/dexpreopt_soong.config out/soong/dexpreopt_arm64/dexpreopt.config out/host/linux-x86/bin/dexpreopt_gen
build GooglePackageInstaller-target: phony device_GooglePackageInstaller_all_targets
 phony_output = true
build device_GooglePackageInstaller_all_targets: phony out/target/product/a523-y83/obj/APPS/GooglePackageInstaller_intermediates/package.apk out/target/product/a523-y83/system/priv-app/GooglePackageInstaller/GooglePackageInstaller.apk out/target/product/a523-y83/obj/APPS/GooglePackageInstaller_intermediates/dexpreopt.zip
 phony_output = true

解析：

### rule rule36586

- **描述**: `GoogleOneTimeInitializer`模块的`dexpreopt`生成规则。
- **命令**: 执行`dexpreopt_gen`工具来生成`dexpreopt.sh`脚本和配置文件。这个命令指定了多个参数，包括全局的Soong和ARM64架构的`dexpreopt`配置，以及特定模块的配置文件路径。输出目录设置为`out`。
- **restat**: 设置为1，表示如果输入文件发生变化，则重新执行此规则。

### build out/target/product/a523-y83/obj/APPS/GoogleOneTimeInitializer_intermediates/dexpreopt.sh

- **规则**: 根据`rule36586`构建`dexpreopt.sh`脚本。
- **输入**: 包括模块的`dexpreopt.config`、全局的`dexpreopt_soong.config`、ARM64的`dexpreopt.config`以及`dexpreopt_gen`工具本身。
- **输出**: `dexpreopt.sh`脚本。

### build GooglePackageInstaller-target

- **类型**: 虚拟目标（phony），用于表示`GooglePackageInstaller`的构建和安装过程。
- **描述**: `GooglePackageInstaller`的所有构建目标。
- **输出**: 由于是虚拟目标，输出标记为`true`。

### build device_GooglePackageInstaller_all_targets

- **类型**: 虗拟目标（phony），用于表示设备上`GooglePackageInstaller`的所有构建目标。
- **依赖**: 包括`GooglePackageInstaller`的未优化APK (`package.apk`)、已优化的APK (`GooglePackageInstaller.apk`)以及`dexpreopt.zip`文件。
- **输出**: 由于是虚拟目标，输出标记为`true`。

### 总结

这段构建规则说明了`GoogleOneTimeInitializer`模块的`dexpreopt`优化过程，以及`GooglePackageInstaller`的构建和安装流程。`dexpreopt`是一个重要的Android优化步骤，用于在部署前对Dalvik字节码进行优化，以提高应用的运行效率。`GooglePackageInstaller`的构建流程涉及到生成未优化的APK，对其进行`dexpreopt`优化，然后安装到设备的`/system/priv-app/`目录中。此外，构建规则还生成了`dexpreopt.zip`文件，这通常包含优化后的DEX文件，可以用于快速启动和性能分析。
 

.PHONY: PackageInstaller-checkbuild
PackageInstaller-checkbuild: out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/PackageInstaller.apk\out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dex-withres-aligned/PackageInstaller.jar\out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dexpreopt/oat/arm64/package.odex\out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dexpreopt/oat/arm64/package.vdex
.PHONY: PackageInstaller-depsinfo
PackageInstaller-depsinfo: out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/depsinfo/flatlist.txt\out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/depsinfo/fulllist.txt
.PHONY: PackageInstaller-install
PackageInstaller-install: out/target/product/a523-y83/system/priv-app/PackageInstaller/PackageInstaller.apk\out/target/product/a523-y83/system/priv-app/PackageInstaller/oat/arm64/PackageInstaller.odex\out/target/product/a523-y83/system/priv-app/PackageInstaller/oat/arm64/PackageInstaller.vdex
.PHONY: PackageInstaller-soong
PackageInstaller-soong: PackageInstaller-checkbuild\PackageInstaller-install

这段Makefile语法描述了Android构建系统中针对`PackageInstaller`的一系列构建目标和它们之间的依赖关系。在Android源码构建中，Makefile用于定义目标、规则和依赖，使构建系统知道如何以及何时构建特定的组件。下面是各部分的详细解释：

### .PHONY: PackageInstaller-checkbuild
这一行定义了一个虚拟的目标`PackageInstaller-checkbuild`，它不是一个实际的文件，而是用来组织和标记一组构建动作。当make工具遇到`.PHONY`指令时，它会理解接下来的目标不是文件系统中的文件，而是一个构建规则。

### PackageInstaller-checkbuild:
这个目标列出了构建`PackageInstaller`所需的中间文件，包括：
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/PackageInstaller.apk`：表示构建过程中的`PackageInstaller`的APK文件。
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dex-withres-aligned/PackageInstaller.jar`：预处理后的DEX文件，通常用于运行时加载。
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dexpreopt/oat/arm64/package.odex`：针对ARM64架构预优化的ODEX文件，用于提高运行时性能。
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/dexpreopt/oat/arm64/package.vdex`：针对ARM64架构的VDex文件，用于快速启动。

### .PHONY: PackageInstaller-depsinfo
这是一个另一个虚拟目标，用于收集`PackageInstaller`的依赖信息。

### PackageInstaller-depsinfo:
它列出了两个依赖信息文件：
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/depsinfo/flatlist.txt`：一个简化的依赖列表。
- `out/soong/.intermediates/frameworks/base/packages/PackageInstaller/PackageInstaller/android_common/depsinfo/fulllist.txt`：一个详细的依赖列表。

### .PHONY: PackageInstaller-install
这个目标用于指定`PackageInstaller`安装后的文件位置，包括：
- `out/target/product/a523-y83/system/priv-app/PackageInstaller/PackageInstaller.apk`：最终的APK文件位置。
- `out/target/product/a523-y83/system/priv-app/PackageInstaller/oat/arm64/PackageInstaller.odex`：预优化的ODEX文件位置。
- `out/target/product/a523-y83/system/priv-app/PackageInstaller/oat/arm64/PackageInstaller.vdex`：VDex文件位置。

### .PHONY: PackageInstaller-soong
这个目标组合了`PackageInstaller-checkbuild`和`PackageInstaller-install`，意味着构建`PackageInstaller-soong`目标时，将首先确保`checkbuild`目标完成，然后进行`install`。

整体而言，这些目标和规则定义了构建`PackageInstaller`的流程，从编译、预优化到最终的安装位置。当在构建系统中请求`PackageInstaller-soong`目标时，构建系统将按照定义的顺序执行这些规则，确保所有必要的构建步骤得到执行。

相关文章：

  • 2024.6.17-21学习日报
  • Go微服务: redis分布式锁
  • css中content属性你了解多少？
  • 【Python Cookbook】S02E12 字符串的连接及合并 ‘ ‘.join()
  • 解决uniapp h5 本地代理实现跨域访问及如何配置开发环境
  • C语言笔记25 •顺序表介绍•
  • Ubuntu乌班图安装VIM文本编辑器工具
  • k8s解决java服务下载超时问题
  • lighttpd cgi不能重启
  • 【毕业设计】Django 校园二手交易平台（有源码＋mysql数据）
  • 笔记-python map函数
  • 视频智能分析平台智能边缘分析一体机安防监控平台打手机检测算法工作原理介绍
  • 2024年旅游与经济发展国际会议（ICTED 2024）
  • 在WordPress上添加亚马逊联盟链接的三种方法
  • 网络安全筑基篇——SQL注入
  • ----------
  • 2017-09-12 前端日报
  • AzureCon上微软宣布了哪些容器相关的重磅消息
  • ES6, React, Redux, Webpack写的一个爬 GitHub 的网页
  • iOS帅气加载动画、通知视图、红包助手、引导页、导航栏、朋友圈、小游戏等效果源码...
  • JavaScript类型识别
  • javascript数组去重/查找/插入/删除
  • Java教程_软件开发基础
  • Python 使用 Tornado 框架实现 WebHook 自动部署 Git 项目
  • Spring Boot MyBatis配置多种数据库
  • vue总结
  • 精益 React 学习指南 （Lean React）- 1.5 React 与 DOM
  • 批量截取pdf文件
  • 手写一个CommonJS打包工具（一）
  • 用mpvue开发微信小程序
  • 通过调用文摘列表API获取文摘
  • ​14：00面试，14：06就出来了，问的问题有点变态。。。
  • ​Linux·i2c驱动架构​
  • ！！java web学习笔记(一到五)
  • #《AI中文版》V3 第 1 章 概述
  • (07)Hive——窗口函数详解
  • (2024)docker-compose实战 (9)部署多项目环境(LAMP+react+vue+redis+mysql+nginx)
  • (zt)最盛行的警世狂言（爆笑）
  • （二）构建dubbo分布式平台-平台功能导图
  • （附源码）springboot电竞专题网站 毕业设计 641314
  • （南京观海微电子）——COF介绍
  • （算法）Travel Information Center
  • (算法)大数的进制转换
  • （转）EOS中账户、钱包和密钥的关系
  • （转）nsfocus-绿盟科技笔试题目
  • .bat批处理（四）：路径相关%cd%和%~dp0的区别
  • .NET 3.0 Framework已经被添加到WindowUpdate
  • .Net 6.0 Windows平台如何判断当前电脑是否联网
  • .NET Core 控制台程序读 appsettings.json 、注依赖、配日志、设 IOptions
  • .net 前台table如何加一列下拉框_如何用Word编辑参考文献
  • .net快速开发框架源码分享
  • /dev下添加设备节点的方法步骤（通过device_create）
  • /etc/motd and /etc/issue
  • ?
  • []我的函数库