Application.mk文件使用说明

本文档介绍了 ndk-build 所使用的 Application.mk 编译文件。

我们建议先阅读概念页面,然后再阅读本页面。

概览

Application.mk 指定了 ndk-build 的项目范围设置。默认情况下,它位于应用项目目录中的 jni/Application.mk下。

注意:其中许多参数也具有模块等效项。例如,APP_CFLAGS 对应于 LOCAL_CFLAGS。无论何种情况下,特定于模块的选项都将优先于应用范围选项。对于标记,两者都使用,但特定于模块的标记将后出现在命令行中,因此它们可能会替换项目范围设置。

变量

APP_ABI

默认情况下,NDK 编译系统会为所有非弃用 ABI 生成代码。您可以使用 APP_ABI 设置为特定 ABI 生成代码。表 1 显示了不同指令集的 APP_ABI 设置。

表 1. 不同指令集的 APP_ABI 设置。

指令集
32 位 ARMv7 APP_ABI := armeabi-v7a
64 位 ARMv8 (AArch64) APP_ABI := arm64-v8a
x86 APP_ABI := x86
x86-64 APP_ABI := x86_64
所有支持的 ABI(默认) APP_ABI := all

您也可以指定多个值,方法是将它们放在同一行上,中间用空格分隔。例如:

APP_ABI := armeabi-v7a arm64-v8a x86    

注意:Gradle 的 externalNativeBuild 会忽略 APP_ABI。请在 splits 块内部使用 abiFilters 块或(如果使用的是“多个 APK”)abi 块。

有关所有受支持 ABI 的列表以及有关其用法和限制的详细信息,请参阅 ABI 管理

APP_ASFLAGS

要传递给项目中每个汇编源文件(.s 和 .S 文件)的汇编器的标记。

注意ASFLAGS 与 ASMFLAGS 不同。后者专门适用于 YASM 源文件(请参阅 APP_ASMFLAGS 部分)。

APP_ASMFLAGS

对于所有 YASM 源文件(.asm,仅限 x86/x86_64),要传递给 YASM 的标记。

APP_BUILD_SCRIPT

默认情况下,ndk-build 假定 Android.mk 文件位于相对于项目根目录的 jni/Android.mk

要从其他位置加载 Android.mk 文件,请将 APP_BUILD_SCRIPT 设置为 Android.mk 文件的绝对路径。

注意:Gradle 的 externalNativeBuild 将根据 externalNativeBuild.ndkBuild.path 变量自动配置此路径。

APP_CFLAGS

要为项目中的所有 C/C++ 编译传递的标记。

注意:Include 路径应使用 LOCAL_C_INCLUDES 而不是显式 -I 标记。

另请参阅:APP_CONLYFLAGSAPP_CPPFLAGS

APP_CLANG_TIDY

要为项目中的所有模块启用 clang-tidy,请将此标记设置为“True”。默认处于停用状态。

APP_CLANG_TIDY_FLAGS

要为项目中的所有 clang-tidy 执行传递的标记。

APP_CONLYFLAGS

要为项目中的所有 C 编译传递的标记。这些标记不会用于 C++ 代码。

另请参阅:APP_CFLAGSAPP_CPPFLAGS

APP_CPPFLAGS

要为项目中的所有 C++ 编译传递的标记。这些标记不会用于 C 代码。

另请参阅:APP_CFLAGSAPP_CONLYFLAGS

APP_CXXFLAGS

注意APP_CPPFLAGS 应优先于 APP_CXXFLAGS

与 APP_CPPFLAGS 相同,但在编译命令中将出现在 APP_CPPFLAGS 之后。例如:

APP_CPPFLAGS := -DFOO    APP_CXXFLAGS := -DBAR    

以上配置将导致编译命令类似于 clang++ -DFOO -DBAR,而不是 clang++ -DBAR -DFOO

APP_DEBUG

要编译可调试的应用,请将此标记设置为“True”。

APP_LDFLAGS

关联可执行文件和共享库时要传递的标记。

注意:这些标记对静态库没有影响。不会关联静态库。

APP_MANIFEST

AndroidManifest.xml 文件的绝对路径。

默认情况下将使用 $(APP_PROJECT_PATH)/AndroidManifest.xml)(如果存在)。

注意:使用 externalNativeBuild 时,Gradle 不会设置此值。

APP_MODULES

要编译的模块的显式列表。此列表的元素是模块在 Android.mk 文件的 LOCAL_MODULE 中显示的名称。

默认情况下,ndk-build 将编译所有共享库、可执行文件及其依赖项。仅当项目使用静态库、项目仅包含静态库或者在 APP_MODULES 中指定了静态库时,才会编译静态库。

注意:将不会编译导入的模块(在使用 $(call import-module) 导入的编译脚本中定义的模块),除非要在 APP_MODULES中编译或列出的模块依赖导入的模块。

APP_OPTIM

将此可选变量定义为 release 或 debug。默认情况下,将编译发布二进制文件。

发布模式会启用优化,并可能生成无法与调试程序一起使用的二进制文件。调试模式会停用优化,以便可以使用调试程序。

请注意,您可以调试发布二进制文件或调试二进制文件。但是,发布二进制文件在调试期间提供的信息较少。例如,变量可能会被优化掉,导致无法检查代码。此外,代码重新排序会使单步调试代码变得更加困难;堆栈跟踪可能不可靠。

在应用清单的 <application> 标记中声明 android:debuggable 将导致此变量默认为 debug,而不是 release。通过将 APP_OPTIM 设置为 release 可替换此默认值。

注意:使用 externalNativeBuild 进行编译时,Android Studio 将根据您的编译风格适当地设置此标记。

APP_PLATFORM

APP_PLATFORM 会声明编译此应用所面向的 Android API 级别,并对应于应用的 minSdkVersion

如果未指定,ndk-build 将以 NDK 支持的最低 API 级别为目标。最新 NDK 支持的最低 API 级别总是足够低,可以支持几乎所有使用中的设备。

警告:将 APP_PLATFORM 设置为高于应用的 minSdkVersion 可能会生成一个无法在旧设备上运行的应用。在大多数情况下,库将无法加载,因为它们引用了在旧设备上不可用的符号。

例如,值 android-16 指定库使用在 Android 4.1(API 级别 16)以前的版本中不可用的 API,并且无法在运行较低平台版本的设备上使用。有关平台名称和相应 Android 系统映像的完整列表,请参阅 Android NDK 原生 API

使用 Gradle 和 externalNativeBuild 时,不应直接设置此参数。而是在模块级别 build.gradle 文件的 defaultConfig 或 productFlavors 块中设置 minSdkVersion 属性。这样就能确保只有在运行足够高 Android 版本的设备上安装的应用才能使用您的库。

请注意,NDK 不包含 Android 每个 API 级别的库,省略了不包含新的原生 API 的版本以节省 NDK 中的空间。ndk-build 按以下优先级降序使用 API:

  1. 匹配 APP_PLATFORM 的平台版本。
  2. 低于 APP_PLATFORM 的下一个可用 API 级别。例如,APP_PLATFORM 为 android-20 时,将使用 android-19,因为 android-20 中没有新的原生 API。
  3. NDK 支持的最低 API 级别。

APP_PROJECT_PATH

项目根目录的绝对路径。

APP_SHORT_COMMANDS

LOCAL_SHORT_COMMANDS 的项目范围等效项。有关详情,请参阅 Android.mk 中有关 LOCAL_SHORT_COMMANDS 的文档。

APP_STL

用于此应用的 C++ 标准库。

默认情况下使用 system STL。其他选项包括 c++_sharedc++_static 和 none。请参阅 NDK 运行时和功能

APP_STRIP_MODE

要为此应用中的模块传递给 strip 的参数。默认为 --strip-unneeded。要避免剥离模块中的所有二进制文件,请设置为 none。有关其他剥离模式,请参阅剥离文档

APP_THIN_ARCHIVE

要为项目中的所有静态库使用瘦归档,请将此变量设置为“True”。有关详情,请参阅 Android.mk 中有关 LOCAL_THIN_ARCHIVE 的文档。

APP_WRAP_SH

要包含在此应用中的 wrap.sh 文件的路径。

每个 ABI 都存在此变量的变体,ABI 通用变体也是如此:

  • APP_WRAP_SH
  • APP_WRAP_SH_armeabi-v7a
  • APP_WRAP_SH_arm64-v8a
  • APP_WRAP_SH_x86
  • APP_WRAP_SH_x86_64

注意APP_WRAP_SH_<abi> 无法与 APP_WRAP_SH 相结合。如果任何 ABI 使用特定于 ABI 的 wrap.sh,则所有 ABI 都必须使用该 wrap.sh。

原文地址:https://www.cnblogs.com/gamesky/p/11369167.html

时间: 2024-11-09 03:54:21

Application.mk文件使用说明的相关文章

Android NDK开发指南---Application.mk文件和android.mk文件

https://android.googlesource.com/platform/development/+/donut-release/ndk/docs/OVERVIEW.TXT https://android.googlesource.com/platform/ndk/+/4e159d95ebf23b5f72bb707b0cb1518ef96b3d03/docs/ANDROID-MK.TXT https://android.googlesource.com/platform/ndk/+/4

NDK开发之Application.mk文件详解

做过NDK开发的同学应该都知道有个Application.mk文件,这是android NDK构建系统使用的一个可选构建文件.它的目的是描述应用程序需要哪些模块,也定义了所有模块的一些通用变量.主要有以下几个变量. APP_MODULES,默认情况下,ndk会构建在android.xk文件中声明的所有模块.但是这个变量可是覆盖上述行为. 假如我们的android.mk文件是这样的: LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_

【转】Application.mk 文件语法规范

原文网址:http://blog.sina.com.cn/s/blog_4c451e0e0100s6q4.html Application.mk file syntax specification Application.mk 文件语法规范 Introduction: 介绍: ------------- This document describes the syntax of Application.mk build files written to describe the native m

Android.mk和Application.mk文件语法规范说明及举例

以下英文内容摘自:http://www.kandroid.org/ndk/docs/OVERVIEW.htmlThe Android NDK is a set of tools that allows Android application developers to embed native machine code compiled from C and/or C++ source files into their application packages. NDK development

Android.mk文件、Application.mk文件编写规则

在Application.mk文件中有个预定义命令参数APP_ABI,是指明编译与调试的CPU架构. 目前Android系统支持以下七种不同的CPU架构:ARMv5,ARMv7(从2010年起),x86(从2011年),MIPS(从2012年),ARMv8,MIPS64和x86_64(从2014年),每一种都对应相应的ABI. CPU架构 ABI   ARMv5 armeabi 32位,从2010年 ARMv7 armeabi-v7a 32位,从2010年 x86 x86 32位,从2011年

【Android本地开发技术:编译脚本】Application.mk

作者:郭孝星 微博:郭孝星的新浪微博 邮箱:[email protected] 博客:http://blog.csdn.net/allenwells Github:https://github.com/AllenWells 一 Application.mk文件的作用和特点 作用:描述应用程序中所需要的模块(静态库或动态库). 位置:Application.mk通常放在PROJECT/jni/Applicatio.mk,PROJECT指的是项目路径. 二 Application.mk文件的变量 2

Android JNI学习笔记(三)-编译文件Android.mk、Application.mk 与camke

1. 前言 在android2.2中,加入了cmake编译,而以前都是用Android.mk.Application.mk的,今天就来记录下,他们的配置选项. 2. Android.mk Android.mk在jni目录下,用于描述构建系统的源文件以及 shared libraries .文件格式如下: 以LOCAL_PATH变量开始 LOCAL_PATH := $(call my-dir) 紧接着是CLEAR_VARS变量 include $(CLEAR_VARS) 接下来LOCAL_MODU

Cocos2d-x移植到Android平台编译的两个文件Android.mk和Application.mk

背景 首先,说说文章的背景.最近手中的一个项目,由于需求中要求提供Web界面的打印功能,当然如果没有打印机,还可以提供保存到本地.项目组长把这个"小任务"分给了我.本着努力为组长分忧解难的思想,领了任务之后,就马上开始了工作. 问题 刚开始的时候,组长给了一个工具(jatoolsprinter)让我研究,我用了一个多小时的时间,做出了一个简单的Demo,然后就是各种的测试,由于 web 打印需要浏览器安装 ActiveX 组件,在随后的测试中,我用了几款浏览器,甚至把安全级别都调到了最

Android.mk 文件语法详解

转:http://blog.sina.com.cn/s/blog_602f8770010148ce.html ===================================================================================== 0. Android.mk简介: Android.mk文件用来告知NDK Build 系统关于Source的信息. Android.mk将是GNU Makefile的一部分,且将被Build System解析一次或多次