区长

Android Gradle Plugin 源码解析之 externalNativeBuild

发表于 | 分类于 | |

在Android Studio 2.2开始的Android Gradle Plugin版本中，Google集成了对cmake的完美支持，而原先的ndkBuild的方式支持也变得更加良好。这篇文章就来说说Android Gradle Plugin与交叉编译之间的一些事，即externalNativeBuild相关的task，主要是解读一下gradle构建系统相关的源码。

前言

如果你在gradle中使用过cmake，你会发现在gradle执行sync操作后，项目的module目录下就会生成一个叫.externalNativeBuild的文件夹，该文件夹用来进行C/C++代码的编译，当然，如果你用的是ndkBuild的方式，该文件夹下的文件会发生变化，文件较cmake会少很多。

cmake方式产生的文件列表如下：

extern-build-cmake.png

而ndkBuild方式产生的文件列表如下：

extern-build-ndk.png

他们的共同点是都有一个叫android_gradle_build.json的文件，这个文件用来被Android Gradle Plugin中的externalNativeBuild任务解析，将构建命令解析出来，然后编译C/C++代码，最后产生目标so文件。除此之外，还有x_build_command.txt和x_build_output.txt两个文件，其中x表示构建方式，使用cmake的话x就等于cmake，使用ndkBuild的话x就等于ndkBuild。x_build_command.txt文件承载着构建命令，android_gradle_build.json的生成依赖它，而x_build_output.txt文件是执行x_build_command.txt中的构建命令后控制台输出的内容。

cmake

通过查看android gradle plugin的源码，可以发现生成cmake_build_command.txt文件生成的方式其实很简单，就是一个不断拼接参数的过程，其源码在CmakeExternalNativeJsonGenerator中的getProcessBuilder，如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
@NonNull
@Override
ProcessInfoBuilder getProcessBuilder(@NonNull String abi, int abiPlatformVersion,
        @NonNull File outputJson) {
    checkConfiguration();
    ProcessInfoBuilder builder = new ProcessInfoBuilder();
    // CMake requires a folder. Trim the filename off.
    File cmakeListsFolder = getMakefile().getParentFile();

    builder.setExecutable(getCmakeExecutable());
    builder.addArgs(String.format("-H%s", cmakeListsFolder));
    builder.addArgs(String.format("-B%s", outputJson.getParentFile()));
    // TODO: possibly remove the Android Gradle part.
    // Depends on how upstream CMake accepts our JSON patch.
    builder.addArgs("-GAndroid Gradle - Ninja");
    builder.addArgs(String.format("-DANDROID_ABI=%s", abi));
    builder.addArgs(String.format("-DANDROID_NDK=%s", getNdkFolder()));
    builder.addArgs(
            String.format("-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=%s",
                    new File(getObjFolder(), abi)));
    builder.addArgs(
            String.format("-DCMAKE_BUILD_TYPE=%s", isDebuggable() ? "Debug" : "Release"));
    builder.addArgs(String.format("-DCMAKE_MAKE_PROGRAM=%s",
            getNinjaExecutable().getAbsolutePath()));
    builder.addArgs(String.format("-DCMAKE_TOOLCHAIN_FILE=%s",
            getToolChainFile().getAbsolutePath()));

    builder.addArgs(String.format("-DANDROID_PLATFORM=android-%s", abiPlatformVersion));

    if (!getcFlags().isEmpty()) {
        builder.addArgs(String.format("-DCMAKE_C_FLAGS=%s", Joiner.on(" ").join(getcFlags())));
    }

    if (!getCppFlags().isEmpty()) {
        builder.addArgs(String.format("-DCMAKE_CXX_FLAGS=%s",
                Joiner.on(" ").join(getCppFlags())));
    }

    for (String argument : getBuildArguments()) {
        builder.addArgs(argument);
    }

    return builder;
}

该函数的返回值为ProcessInfoBuilder，该对象专门用于携带可执行文件以及可执行文件执行时需要的参数，传递给project.exec执行。

  • 设置可执行文件为cmake，调用getCmakeExecutable方法，获取cmake可执行文件，调用setExecutable方法设置它
  • 拼接-H参数，其值为CMakeList.txt文件所在目录
  • 拼接-B参数，其值为cmake产生的中间产物，一般就是cmake_build_command.txt所在目录的父目录，cmake构建产生的中间产物全都位于此目录。
  • 拼接-G参数，其值为Android Gradle - Ninja，告诉cmake生成Android Gradle需要的项目文件，并且使用ninja构建，值得注意的是，该值在标准的cmake中是不支持的，也就是说，as使用的cmake是google修改过的，通过查看其注释 possibly remove the Android Gradle part. Depends on how upstream CMake accepts our JSON patch. 也可以看出，google可能会移除该值中Android Gradle部分，但是还是要取决于cmake如果接受google的patch。
  • 设置ANDROID_ABI参数，其值为armeabi，armeabi-v7a，arm64-v8a，x86，x86_64，mips，mips64中的一个。
  • 设置ANDROID_NDK参数，其值为ndk的路径。
  • 设置CMAKE_LIBRARY_OUTPUT_DIRECTORY参数，其值为so的输出路径，一般其值为项目的build路径下的intermediates/cmake/debug/obj/$ANDROID_ABI
  • 设置CMAKE_BUILD_TYPE参数，是否是debug，其值为Debug或者Release中的一个，debug含符号信息，so很大，便于调试，Release移除了debug信息，小很多。其值来源于build.gradle中的debuggable值。
  • 设置CMAKE_MAKE_PROGRAM参数。其值为ninja路径，因为生成的是ninja构建的项目，所以需要指定其路径。该值gradle会根据sdk和ndk的路径，自动推断出。
  • 设置CMAKE_TOOLCHAIN_FILE参数，该参数是cmake用于交叉编译时设置的必要参数，主要设置一些交叉编译需要的参数，如CC，CXX，AR，AS，CFLAGS，CXXFLAGS等，可以查看NDK 交叉编译常用变量，android.toolchain.cmake文件的代码在android.toolchain.cmake，兼容android-cmake，该值gradle会根据sdk和ndk的路径，自动推断出。
  • 设置ANDROID_PLATFORM参数，一般设成和项目的最小api版本一样即可，gradle会通过它和minSdk查找出合适的值
  • 设置可选项CMAKE_C_FLAGS参数，如果不为空，则设置，其值为编译C时的一些参数
  • 设置可选项CMAKE_CXX_FLAGS参数，如果不为空，则设置，其值为编译C++时的一些参数
  • 设置可选项arguments，其值为gradle传进来的arguments参数。

更多参数说明见CMake

然后将该返回值转为字符串输出到文件中，该文件即cmake_build_command.txt

其内容大致如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Executable : /Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/cmake
arguments : 
-Hpath/to/CMakeFiles Parent Dir
-Bpath/to/moduleDir/.externalNativeBuild/cmake/debug/armeabi-v7a
-GAndroid Gradle - Ninja
-DANDROID_ABI=armeabi-v7a
-DANDROID_NDK=/Users/lizhangqu/AndroidNDK/android-ndk-r14b
-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=path/to/moduleDir/build/intermediates/cmake/debug/obj/armeabi-v7a
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_MAKE_PROGRAM=/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/ninja
-DCMAKE_TOOLCHAIN_FILE=/Users/lizhangqu/AndroidNDK/android-ndk-r14b/build/cmake/android.toolchain.cmake
-DANDROID_PLATFORM=android-14
-DCMAKE_C_FLAGS=-fpic -fexceptions -frtti
-DCMAKE_CXX_FLAGS=-fpic -fexceptions -frtti
-DANDROID_STL=c++_static
jvmArgs :

当然我们可以直接在命令行调用之，生成cmake项目结构，如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/cmake \
-H"path/to/CMakeFiles Parent Dir" \
-B"path/to/moduleDir/.externalNativeBuild/cmake/debug/armeabi-v7a" \
-G"Android Gradle - Ninja" \
-DANDROID_ABI="armeabi-v7a" \
-DANDROID_NDK="/Users/lizhangqu/AndroidNDK/android-ndk-r14b" \
-DCMAKE_LIBRARY_OUTPUT_DIRECTORY="path/to/moduleDir/build/intermediates/cmake/debug/obj/armeabi-v7a" \
-DCMAKE_BUILD_TYPE="Debug" \
-DCMAKE_MAKE_PROGRAM="/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/ninja" \
-DCMAKE_TOOLCHAIN_FILE="/Users/lizhangqu/AndroidNDK/android-ndk-r14b/build/cmake/android.toolchain.cmake" \
-DANDROID_PLATFORM="android-14" \
-DCMAKE_C_FLAGS="-fpic -fexceptions -frtti" \
-DCMAKE_CXX_FLAGS="-fpic -fexceptions -frtti" \
-DANDROID_STL="c++_static"

其对应的gradle调用代码大致如下

1
2
3
4
5
// See whether the current build command matches a previously written build command.
String currentBuildCommand = processBuilder.toString();
boolean rebuildDueToMissingPreviousCommand = false;
File commandFile = new File(expectedJson.getParentFile(),
        String.format("%s_build_command.txt", getNativeBuildSystem().getName()));

就是将processBuilder对象中携带的参数，调用project.exec执行即可。

1
2
3
4
5
6
7
8
String buildOutput = executeProcess(processBuilder);

// Write the captured process output to a file for diagnostic purposes.
File outputTextFile = new File(
        expectedJson.getParentFile(),
        String.format("%s_build_output.txt", getNativeBuildSystem().getName()));
diagnostic("write build output %s", outputTextFile.getAbsolutePath());
Files.write(buildOutput, outputTextFile, Charsets.UTF_8);

executeProcess执行完之后，就会产生cmake_build_output.txt文件，该文件就是执行cmake_build_command.txt中的命令之后控制台输出的内容。大致如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
-- Check for working C compiler: /Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang
-- Check for working C compiler: /Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang++
-- Check for working CXX compiler: /Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: path/to/moduleDir/.externalNativeBuild/cmake/debug/armeabi-v7a

此外，其他文件也被一并产生，如android_gradle_build.json，build.ninja，cmake_insatll.cmake，CMakeCache.txt，rules.ninja，CMakefiles文件夹等等。

而executeProcess方法，最终调用的是GradleProcessExecutor的execute方法，然后通过其内部类ExecAction的execute方法构造ExecSpec对象，调用project.exec方法执行之。其大致源码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
@NonNull
@Override
public ProcessResult execute(
        @NonNull ProcessInfo processInfo,
        @NonNull ProcessOutputHandler processOutputHandler) {
    ProcessOutput output = processOutputHandler.createOutput();

    ExecResult result;
    try {
        result = project.exec(new ExecAction(processInfo, output));
    } finally {
        try {
            output.close();
        } catch (IOException e) {
            project.getLogger().warn("Exception while closing sub process streams", e);
        }
    }
    try {
        processOutputHandler.handleOutput(output);
    } catch (final ProcessException e) {
        return new OutputHandlerFailedGradleProcessResult(e);
    }
    return new GradleProcessResult(result, processInfo);
}

private static class ExecAction implements Action<ExecSpec> {

    @NonNull
    private final ProcessInfo processInfo;

    @NonNull
    private final ProcessOutput processOutput;

    ExecAction(@NonNull final ProcessInfo processInfo,
            @NonNull final ProcessOutput processOutput) {
        this.processInfo = processInfo;
        this.processOutput = processOutput;
    }

    @Override
    public void execute(ExecSpec execSpec) {

        /*
         * Gradle doesn't work correctly when there are empty args.
         */
        List<String> args =
                processInfo.getArgs().stream()
                        .map(a -> a.isEmpty()? "\"\"" : a)
                        .collect(Collectors.toList());
        execSpec.setExecutable(processInfo.getExecutable());
        execSpec.args(args);
        execSpec.environment(processInfo.getEnvironment());
        execSpec.setStandardOutput(processOutput.getStandardOutput());
        execSpec.setErrorOutput(processOutput.getErrorOutput());

        // we want the caller to be able to do its own thing.
        execSpec.setIgnoreExitValue(true);
    }
}

json文件生成了，之后就是生产so文件了，生成so文件由ExternalNativeBuildTask负责，其主要职责就是解析出android_gradle_build.json文件中libraries的各项中的的artifactName和buildCommand，传入对应的executeProcessBatch函数，执行buildCommand中的值，执行的方式也是通过GradleProcessExecutor的execute方法，最终产生so。

我们来看看android_gradle_build.json的大致内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

{
	"buildFiles" : 
	[
		"path/to/CMakeLists.txt"
	],
	"cleanCommands" : 
	[
		"/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/cmake --build path/to/.externalNativeBuild/cmake/debug/armeabi-v7a --target clean"
	],
	"cppFileExtensions" : ["cpp" ],
	"libraries" : 
	{
		"so名字-Debug-armeabi-v7a" : 
		{
			"abi" : "armeabi-v7a",
			"artifactName" : "so名字",
			"buildCommand" : "/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/cmake --build path/to/.externalNativeBuild/cmake/debug/armeabi-v7a --target so名字",
			"buildType" : "debug",
			"files" : 
			[
				
				{
					"flags" : "内容",
					"src" : "内容",
					"workingDirectory" : "path/to/.externalNativeBuild/cmake/debug/armeabi-v7a"
				},
				{
					"flags" : "内容",
					"src" : "内容",
					"workingDirectory" : "path/to/.externalNativeBuild/cmake/debug/armeabi-v7a"
				},
				{
					"flags" : "内容",
					"src" : "内容",
					"workingDirectory" : "path/to/.externalNativeBuild/cmake/debug/armeabi-v7a"
				}
			],
			"output" : "path/to/build/intermediates/cmake/debug/obj/armeabi-v7a/so名字.so",
			"toolchain" : "12644252315582812689"
		}
	},
	"toolchains" : 
	{
		"12644252315582812689" : 
		{
			"cCompilerExecutable" : "/Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang",
			"cppCompilerExecutable" : "/Users/lizhangqu/AndroidNDK/android-ndk-r14b/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang++"
		}
	}
}

没错解析的就是libraries下”so名字-Debug-armeabi-v7a”下的artifactName和buildCommand，我们可以试试直接将buildCommand中的命令复制到命令行执行，可以看到so就会编译产生。

除了直接复制buildCommand中的命令，也可以进入到cmake生成的文件目录，即-B指定的目录，调用ninja进行构建。如：

1
2
3
/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/ninja clean

/Users/lizhangqu/AndroidSDK/cmake/3.6.3155560/bin/ninja

ninja是chromium的核心构建工具，可以参考Ninja - chromium核心构建工具学习下相关的内容。

而clean操作，则由ExternalNativeCleanTask负责，其主要职责就是解析出android_gradle_build.json中的cleanCommands命令，然后执行。

ndkBuild

和cmake类似，首先就是ndkBuild_build_command.txt的生成，其生成所需的关键参数由NdkBuildExternalNativeJsonGenerator中的getProcessBuilder函数和getBaseArgs函数负责，其代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
@NonNull
@Override
ProcessInfoBuilder getProcessBuilder(@NonNull String abi, int abiPlatformVersion,
        @NonNull File outputJson) {
    checkConfiguration();
    // Discover Application.mk if one exists next to Android.mk
    // If there is an Application.mk file next to Android.mk then pick it up.
    File applicationMk = new File(getMakeFile().getParent(), "Application.mk");
    ProcessInfoBuilder builder = new ProcessInfoBuilder();
    builder.setExecutable(getNdkBuild())
            .addArgs(getBaseArgs(abi, abiPlatformVersion, applicationMk))
            // Disable response files so we can parse the command line.
            .addArgs("APP_SHORT_COMMANDS=false")
            .addArgs("LOCAL_SHORT_COMMANDS=false")
            .addArgs("-B") // Build as if clean
            .addArgs("-n");
    return builder;
}
/**
 * Get the base list of arguments for invoking ndk-build.
 */
@NonNull
private List<String> getBaseArgs(@NonNull String abi, int abiPlatformVersion,
        @NonNull File applicationMk) {
    List<String> result = Lists.newArrayList();
    result.add("NDK_PROJECT_PATH=null");
    result.add("APP_BUILD_SCRIPT=" + getMakeFile());

    if (applicationMk.exists()) {
        // NDK_APPLICATION_MK specifies the Application.mk file.
        result.add("NDK_APPLICATION_MK=" + applicationMk.getAbsolutePath());
    }

    // APP_ABI and NDK_ALL_ABIS work together. APP_ABI is the specific ABI for this build.
    // NDK_ALL_ABIS is the universe of all ABIs for this build. NDK_ALL_ABIS is set to just the
    // current ABI. If we don't do this, then ndk-build will erase build artifacts for all abis
    // aside from the current.
    result.add("APP_ABI=" + abi);
    result.add("NDK_ALL_ABIS=" + abi);

    if (isDebuggable()) {
        result.add("NDK_DEBUG=1");
    } else {
        result.add("NDK_DEBUG=0");
    }

    result.add("APP_PLATFORM=android-" + abiPlatformVersion);

    // getObjFolder is set to the "local" subfolder in the user specified directory, therefore,
    // NDK_OUT should be set to getObjFolder().getParent() instead of getObjFolder().
    String ndkOut = getObjFolder().getParent();
    if (CURRENT_PLATFORM == PLATFORM_WINDOWS) {
        // Due to b.android.com/219225, NDK_OUT on Windows requires forward slashes.
        // ndk-build.cmd is supposed to escape the back-slashes but it doesn't happen.
        // Workaround here by replacing back slash with forward.
        // ndk-build will have a fix for this bug in r14 but this gradle fix will make it
        // work back to r13, r12, r11, and r10.
        ndkOut = ndkOut.replace('\\', '/');
    }
    result.add("NDK_OUT=" + ndkOut);

    result.add("NDK_LIBS_OUT=" + getSoFolder().getAbsolutePath());

    for (String flag : getcFlags()) {
        result.add(String.format("APP_CFLAGS+=\"%s\"", flag));
    }

    for (String flag : getCppFlags()) {
        result.add(String.format("APP_CPPFLAGS+=\"%s\"", flag));
    }

    for (String argument : getBuildArguments()) {
        result.add(argument);
    }

    return result;
}
  • 设置可执行文件为ndk-Build
  • 设置NDK_PROJECT_PATH=null
  • 设置APP_BUILD_SCRIPT参数，其值指向Android.mk文件
  • 设置NDK_APPLICATION_MK参数，其值指向Application.mk文件（如果存在的话，不存在就不会设置该参数）
  • 设置APP_ABI参数，其值为armeabi，armeabi-v7a，arm64-v8a，x86，x86_64，mips，mips64中的一个。
  • 设置NDK_ALL_ABIS参数，其值等同于APP_ABI
  • 设置NDK_DEBUG参数，表示十分是debug构建，debug含符号信息，so很大，便于调试，release移除了debug信息，小很多。其值来源于build.gradle中的debuggable值。
  • 设置APP_PLATFORM参数，一般设成和项目的最小api版本一样即可，gradle会通过它和minSdk查找出合适的值
  • 设置NDK_OUT参数，其值为obj文件产生目录，一般指向项目的build路径下的intermediates/ndkBuild/$buildType/obj目录
  • 设置NDK_LIBS_OUT参数，其值为libs参数目录，用于so的存储，一般指向项目的build路径下的intermediates/ndkBuild/$buildType/lib目录
  • 设置可选项APP_CFLAGS参数，如果不为空，则设置，其值为编译C时的一些参数
  • 设置可选项APP_CPPFLAGS参数，如果不为空，则设置，其值为编译C++时的一些参数
  • 设置可选项arguments，其值为gradle传进来的arguments参数。
  • 设置APP_SHORT_COMMANDS=false
  • 设置LOCAL_SHORT_COMMANDS=false
  • 添加-B参数
  • 添加-n参数

最终生成的文件大致内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Executable : /Users/lizhangqu/AndroidSDK/ndk-bundle/ndk-build
arguments : 
NDK_PROJECT_PATH=null
APP_BUILD_SCRIPT=path/to/Android.mk
NDK_APPLICATION_MK=path/to/Application.mk
APP_ABI=armeabi
NDK_ALL_ABIS=armeabi
NDK_DEBUG=1
APP_PLATFORM=android-14
NDK_OUT=path/to/moduleDir/build/intermediates/ndkBuild/debug/obj
NDK_LIBS_OUT=path/to/moduleDir/build/intermediates/ndkBuild/debug/lib
APP_CFLAGS+="-fpic -fexceptions -frtti"
APP_CPPFLAGS+="-fpic -fexceptions -frtti"
APP_SHORT_COMMANDS=false
LOCAL_SHORT_COMMANDS=false
-B
-n
jvmArgs :

同理我们也可以直接在命令行调用他们执行

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
/Users/lizhangqu/AndroidSDK/ndk-bundle/ndk-build \
NDK_PROJECT_PATH=null \
APP_BUILD_SCRIPT=path/to/Android.mk \
NDK_APPLICATION_MK=path/to/Application.mk \
APP_ABI=armeabi \
NDK_ALL_ABIS=armeabi \
NDK_DEBUG=1 \
APP_PLATFORM=android-14 \
NDK_OUT=path/to/moduleDir/build/intermediates/ndkBuild/debug/obj \
NDK_LIBS_OUT=path/to/moduleDir/build/intermediates/ndkBuild/debug/lib \
APP_CFLAGS+="-fpic -fexceptions -frtti" \
APP_CPPFLAGS+="-fpic -fexceptions -frtti" \
APP_SHORT_COMMANDS=false \
LOCAL_SHORT_COMMANDS=false \
-B \
-n \

其代码调用过程同cmake，最终生成ndkBuild_build_output.txt，该文件内容就是调用ndkBuild_build_command.txt中的命令后控制台输出的内容。

而同cmake不同的是，android_gradle_build.json的文件，不再是由cmake构建系统产生，而是gradle解析ndkBuild_build_command.txt产生的。

其代码大致如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
NativeBuildConfigValue buildConfig = new NativeBuildConfigValueBuilder(
            getMakeFile(),
            projectDir)
        .addCommands(
                getBuildCommand(abi, abiPlatformVersion, applicationMk),
                variantName,
                buildOutput,
                isWindows())
        .build();

if (applicationMk.exists()) {
    diagnostic("found application make file %s", applicationMk.getAbsolutePath());
    Preconditions.checkNotNull(buildConfig.buildFiles);
    buildConfig.buildFiles.add(applicationMk);
}

String actualResult = new GsonBuilder()
        .registerTypeAdapter(File.class, new PlainFileGsonTypeAdaptor())
        .setPrettyPrinting()
        .create()
        .toJson(buildConfig);

// Write the captured ndk-build output to JSON file
File expectedJson = ExternalNativeBuildTaskUtils.getOutputJson(getJsonFolder(), abi);
Files.write(actualResult, expectedJson, Charsets.UTF_8);

/**
 * ExternalNativeBuildTaskUtils.getOutputJson
 * Utility function that gets the name of the output JSON for a particular ABI.
 */
@NonNull
public static File getOutputJson(@NonNull File jsonFolder, @NonNull String abi) {
    return new File(getOutputFolder(jsonFolder, abi), "android_gradle_build.json");
}

NativeBuildConfigValue的build方法如下，总而言之就是调用各个方法，获取对应的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/**
 * Builds the {@link NativeBuildConfigValue} from the given information.
 */
@NonNull
public NativeBuildConfigValue build() {
    findLibraryNames();
    findToolchainNames();
    findToolChainCompilers();

    NativeBuildConfigValue config = new NativeBuildConfigValue();
    // Sort by library name so that output is stable
    Collections.sort(outputs, (o1, o2) -> o1.libraryName.compareTo(o2.libraryName));
    config.cleanCommands = generateCleanCommands();
    config.buildFiles = Lists.newArrayList(androidMk);
    config.libraries = generateLibraries();
    config.toolchains = generateToolchains();
    config.cFileExtensions = generateExtensions(cFileExtensions);
    config.cppFileExtensions = generateExtensions(cppFileExtensions);
    return config;
}

生成的json文件内容就不贴了，同cmake。

坚持原创技术分享，您的支持将鼓励我继续创作！
区长 WeChat Pay

微信打赏