文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Android 编译过程介绍,Android.mk 和 Android.bp 分析, 在源码中编译 AndroidStudio 构建的 App

2023-09-14 15:10

关注

目录

1. 编译流程

Google 提供的原生 Android 编译流程:

  1. 初始化编译环境

    进入 android 源代码根目录执行以下命令即可初始化编译环境。

    source build/envsetup.sh

    该过程主要是执行了 envsetup.sh 脚本且加载环境变量到当前终端。执行成功之后可以在当前终端执行 envsetup.sh 中定义的命令 (函数名) 来执行这些函数的内容,最后调用函数 source_vendorsetup 加载其他目录 (device/vendor/product) 下的 vendorsetup.sh 脚本。

  2. lunch 选择平台

    在 Android 根目录下执行 lunch 命令来选择当前编译平台,该命令可以直接跟上参数,也可以直接让其显示菜单让我们选择。lunch 函数定义在 envsetup.sh 中。

    这里有一个疑问,就是当前平台定义的 product 是怎么获得的呢?可以查看 envsetup.sh 中定义的 print_lunch_menu 函数。在这个函数中调用 get_build_var,并传递参数 COMMON_LUNCH_CHOICES 来获取当前所有平台,COMMON_LUNCH_CHOICES 被定义在 AndroidProducts.mk 中。

  3. 开始编译

    以上两步执行完之后,可以使用 make 或者 mm 等命令进行编译,但是他们的流程有差异。按照 linux 的 Makefile 机制,make 命令是直接执行当前目录下的 makefile 脚本,在 Android 系统中首先会判断有没有 soong_ui.bash 脚本,如果有则用 soong 编译系统,否则使用 Makefile 机制。m 、mm 或者 mmm 这些命令是 Android 在 envsetup.sh 中定义的。

    在 Android 7.0 之后 google 采用了 soong 编译系统,直接执行当前目录下的 android.mk 或者 android.bp 脚本。(实际上还是使用 Makefile 机制进行编译,只是 google 做了封装)

    • make 命令

      function make(){    _wrap_build $(get_make_command "$@") "$@"}function get_make_command(){    # If we're in the top of an Android tree, use soong_ui.bash instead of make    if [ -f build/soong/soong_ui.bash ]; then        # Always use the real make if -C is passed in        for arg in "$@"; do            if [[ $arg == -C* ]]; then                echo command make                return            fi        done        echo build/soong/soong_ui.bash --make-mode    else        echo command make    fi}
    • m / mm / mmm / mmma 命令

      // 编译整个安卓系统function m()(    _trigger_build "all-modules" "$@")// 编译当前目录下的模块,当前目录下需要有 Android.mk, 否则就往上找最近的 Android.mk 文件function mm()(    _trigger_build "modules-in-a-dir-no-deps" "$@")// 编译指定目录下的模块function mmm()(    _trigger_build "modules-in-dirs-no-deps" "$@")// 当前目录有修改时,可以用这个命令重新编译function mma()(    _trigger_build "modules-in-a-dir" "$@")// 指定目录有修改时,可以用这个命令重新编译function mmma()(    _trigger_build "modules-in-dirs" "$@")function _trigger_build()(    local -r bc="$1"; shift    if T="$(gettop)"; then      _wrap_build "$T/build/soong/soong_ui.bash" --build-mode --${bc} --dir="$(pwd)" "$@"    else      >&2 echo "Couldn't locate the top of the tree. Try setting TOP."      return 1    fi)

2. Soong 介绍

随着 Android 项目的逐渐庞大复杂,包含的模块增加。通过 Makefile 组织的项目编译要花更多的时间。Google 在 Android 7 引入了 ninja 进行编译系统的组织。目前 Android 项目中还在继续使用 Makefile 机制进行编译,因此 Google 引入了 kati ( soong) 将 makefile(Android.mk) 翻译成 ninja 文件。

Android 7.0 开始逐步引入kati soong (未正式使用默认关闭,需要 USE_SOONG=true 手动开启),将 makefile 文件和 Android.mk 文件转化成 ninja 文件,使用 ninja 文件对编译系统进行管理。

Android 8.0 开始引入了 Android.bp 文件来替代之前的 Android.mk 文件。Android.bp 只是纯粹的配置文件(类似json),不包括分支、循环等流程控制 (如果想要进行分支循环控制可自己写 go 来完成),因此 Android.bp 文件被转化成 ninja 文件的效率远远高于 Android.mk 文件。

Android 9.0 开始强制使用 Android.bp 来代替 Android.mk。

  1. Soong工作原理

    Soong源代码路径位于 /android/build/soong/ ,从前面说的 envsetup.sh 可以看到目前的 Android 代码编译命令 ( make / m / mm / mmm) 都基本上使用的该目录下的 soong_ui.bash 来进行代码编译。主要涉及到如下流程:

    • Android.mk 转换成 ninja 文件:soong_ui.bash 将指定目录下的所有 Android.mk (包括makefile) 文件转换成 out/build-.ninja 文件
    • Android.bp 转换成 ninja 文件:soong_ui.bash 将指定目录下所有的 Android.bp 文件也转换成 out/soong/build.ninja 文件
    • 组合 nijia 文件:soong_ui.bash 还会生成一个较小的 out/combined-.ninja 文件,负责把二者组合起来作为执行入口
    • Soong 根据 nijia 来控制源码编译

在这里插入图片描述

  1. 术语介绍
    • Android.mk:Android.mk 其本质是执行 envsetup.sh 之后,编译系统对 makefile 进行了一层封装,让开发者更加简单的使用 makefile。因此可直接把他当成 makefile 看待。
    • Android.bp:Android.bp 的出现就是为了替换 Android.mk 文件。bp 跟 mk 文件不同,它是纯粹的配置,没有分支、循环等流程控制,不能做算数逻辑运算。如果需要控制逻辑,那么只能通过Go语言编写。
    • Ninja:ninja 是一个编译框架,会根据相应的 ninja 格式的配置文件进行编译。 ninja 文件一般是由 Android.bp 或 Android.mk 文件转换来的。
    • Kati:专为 Android 开发的一个基于 Golang 和 C++ 的工具,主要功能是把 Android 中的 Android.mk 文件转换成 Ninja 文件。
    • Soong:Soong 类似于之前的 Makefile 编译系统的核心,负责提供 Android.bp 语义解析,并将之转换成 Ninja 文件。Soong 还会编译生成一个 androidmk 命令,用于将没有分支、循环等流程控制的 Android.mk 文件转换为 Android.bp 文件。
    • Blueprint:Blueprint 是生成、解析 Android.bp 的工具,是 Soong 的一部分。Blueprint 只是解析文件格式,Soong 解析内容的具体含义。Blueprint 和 Soong 都是由 Golang 写的项目,从Android 7.0,prebuilts/go/ 目录下新增 Golang 所需的运行环境,在编译时使用。
    • androidmk:androidmk 是 Soong 提供的一套可直接通过命令的方式将一个 android.mk 生成一个对应的 android.bp。通常开发者需要手动替换 Android.mk 的时候用到。

3. build.sh

全编命令

./build.sh fullbuild

具体编译过程后续再补充。

Android.mk 文件是用来描述 Android 的工程源码如何被构建系统来构建的。

语法概述

Android.bp 描述的编译对象都是以模块为组织单位的,定义一个模块从模块的类型开始,模块有不同的类型,模块包含一些属性。

[module type] {    name: "[name value]",    [property1 name]"[property1 value]",    [property2 name]"[property2 value]",}

1. 模块类型

cc_binary:编译二进制可执行文件。

android_app:编译APK。

cc_library_shared:编译动态库。

更多模块类型(build/soong/androidmk/androidmk/android.go):

var moduleTypes = map[string]string{             "BUILD_SHARED_LIBRARY":        "cc_library_shared",                      "BUILD_STATIC_LIBRARY":        "cc_library_static",                      "BUILD_HOST_SHARED_LIBRARY":   "cc_library_host_shared",                 "BUILD_HOST_STATIC_LIBRARY":   "cc_library_host_static",                 "BUILD_HEADER_LIBRARY":        "cc_library_headers",                     "BUILD_EXECUTABLE":            "cc_binary",  "BUILD_HOST_EXECUTABLE":       "cc_binary_host",                         "BUILD_NATIVE_TEST":           "cc_test",    "BUILD_HOST_NATIVE_TEST":      "cc_test_host",                           "BUILD_NATIVE_BENCHMARK":      "cc_benchmark",                           "BUILD_HOST_NATIVE_BENCHMARK": "cc_benchmark_host",           "BUILD_JAVA_LIBRARY":             "java_library_installable", // will be rewritten to java_library by bpfix    "BUILD_STATIC_JAVA_LIBRARY":      "java_library",                        "BUILD_HOST_JAVA_LIBRARY":        "java_library_host",                   "BUILD_HOST_DALVIK_JAVA_LIBRARY": "java_library_host_dalvik",            "BUILD_PACKAGE":                  "android_app",                         "BUILD_RRO_PACKAGE":              "runtime_resource_overlay", "BUILD_CTS_EXECUTABLE":          "cc_binary",               // will be further massaged by bpfix depending on the output path    "BUILD_CTS_SUPPORT_PACKAGE":     "cts_support_package",     // will be rewritten to android_test by bpfix    "BUILD_CTS_PACKAGE":             "cts_package",             // will be rewritten to android_test by bpfix    "BUILD_CTS_TARGET_JAVA_LIBRARY": "cts_target_java_library", // will be rewritten to java_library by bpfix    "BUILD_CTS_HOST_JAVA_LIBRARY":   "cts_host_java_library",   // will be rewritten to java_library_host by bpfix}

soong 提供了一系列 xx_defaults 模块类型 (cc_defaults, java_defaults, doc_defaults, stub_defaults 等)。

模块类型为 xx_defaults 的模块提供了一组可由其它模块继承的属性。其它模块可以通过添加属性defaults:[“ ”] 来指定继承 xx_defaults 类型的模块定义的属性。

cc_defaults {   name: "gzip_defaults",   shared_libs: ["libz"],   stl: "none",} cc_binary {   name: "gzip",   defaults: ["gzip_defaults"],      srcs: ["src/test/minigzip.c"],}

2. 模块属性

模块类型后面用大括号 { } 将模块的所有属性包裹起来。

每个属性的名字和值用中间用冒号连接起来, 属性值要用双引号 ” ” 包裹起来 (如果属性值是变量,变量不需要加双引号)。

如果属性被定义为数组,需要用中括号 [ ] 将数组的各元素包裹起来,每个元素中间用逗号 , 连接。

属性可以使用列表数组的形式,也可以使用 unix 通配符,例如:*.java

每一条完整的属性定义语句加上逗号 ,表示结束。

注释包括单行注释//和多行注释

Google 提供了 androidmk 工具可以将 Android.mk 转换为 Android.bp。但是这个工具目前还不完善,不能处理 Android.mk 中的宏开关。

1. androidmk 介绍

androidmk 的源码在 build/soong/androidmk 目录下。

在这里插入图片描述

全编 Android 源码之后,可以使用 find . -name androdmk -type f 查找 androidmk 工具,他在 out/host/linux-x86/bin 目录。

在这里插入图片描述

2. androidmk 用法

androidmk 可以将 Android.mk 文件 转换为 Android.bp 文件。

androidmk Android.mk > Android.bp

在这里插入图片描述

3. 示例

点击查看

1. 创建工程

在 Android Studio 中创建一个新的工程。工程名为 CompileTest。创建成功之后 Android Studio 会自动帮我们生成基本的代码框架。

在这里插入图片描述

通常情况下,我们创建的工程主要的实现逻辑和资源文件在 main 目录中。把这部分代码移动到 Android 源码中的 package/apps 目录,注意不要遗漏掉 AndroidManifest.xml 文件。

2. 编写编译文件

  1. Android.mk

    LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_PACKAGE_NAME := CompileTestLOCAL_CERTIFICATE := platformLOCAL_SRC_FILES := $(call all-subdir-java-files)LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/resLOCAL_SDK_VERSION := currentLOCAL_STATIC_ANDROID_LIBRARIES := androidx.appcompat_appcompat // Theme Packageinclude $(BUILD_PACKAGE)
  2. Android.bp

    这里使用 androidmk 命令自动生成 Android.bp 文件。

    androidmk Android.mk > Android.bp

    生成的 Android.bp 文件。

    android_app {    name: "CompileTest",    certificate: "platform",    srcs: ["***.java"],    sdk_version: "current",    static_libs: ["androidx.appcompat_appcompat",                  "androidx-constraintlayout_constraintlayout",    ],}

    Android.mk 文件

    LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_PACKAGE_NAME := CompileTestLOCAL_CERTIFICATE := platformLOCAL_SRC_FILES := $(call all-subdir-java-files)LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/resLOCAL_SDK_VERSION := currentLOCAL_STATIC_ANDROID_LIBRARIES := androidx.appcompat_appcompat \      androidx-constraintlayout_constraintlayoutinclude $(BUILD_PACKAGE)

    使用 Android.mk 编译会以下错误。

    Attribute provider#androidx.startup.InitializationProvider@authorities value=(androidx.appcompat.androidx-startup) from AndroidManifest.xml:34:13-70 is also present at AndroidManifest.xml:19:13-84 value=(androidx.constraintlayout.widget.androidx-startup).Suggestion: add 'tools:replace="android:authorities"' to  element at AndroidManifest.xml.fixed:32:9-43:20 to override.

    尝试在 AndroidManifest.xml 添加 tools:replace 属性。

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    package="com.example.compiletest">    <application        android:allowBackup="true"        android:dataExtractionRules="@xml/data_extraction_rules"        android:fullBackupContent="@xml/backup_rules"        android:icon="@mipmap/ic_launcher"        android:label="@string/app_name"        android:roundIcon="@mipmap/ic_launcher_round"        android:supportsRtl="true"        android:theme="@style/Theme.CompileTest"        tools:targetApi="31"        >        <activity            android:name=".MainActivity"            android:exported="true"            >            <intent-filter>                <action android:name="android.intent.action.MAIN" />                // Add tools:replace 属性<provider tools:replace="android:authorities"                        tools:ignore="WrongManifestParent"/>                <category android:name="android.intent.category.LAUNCHER" />            intent-filter>            <meta-data                android:name="android.app.lib_name"                android:value="" />        activity>    application>manifest>

    再次编译又会出现以下新的错误。

    packages/apps/CompileTest/app/src/main/AndroidManifest.xml:22:21-23:61 Error:tools:replace specified at line:22 for attribute android:authorities, but no new value specifiedpackages/apps/CompileTest/app/src/main/AndroidManifest.xml Error:Validation failed, exiting

    看 log 似乎是 android:authorities 属性没有值,这里不知道怎么给这个属性赋值。以后再补充。

    来源地址:https://blog.csdn.net/qq_43880417/article/details/128311478

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-移动开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯