UE4安卓打aab包时,同时存在“gradle”、“arm64/gradle”两个Gradle工程的原因
两个Gradle工程的现象
在出安卓aab包时,观察到存在以下两个Gradle工程:
1、Intermediate\Android\arm64\gradle (称为arm64的Gradle)
2、Intermediate\Android\gradle(称为根下的Gradle)
它们存在一些小的差异。下面是“为何有两个Gradle工程”的结论。
原因
1、假设指定了若干种架构,那么就会有多个子目录。在我们的例子中,仅存在 arm64目录。(以及根部的 gradle目录,这是你所知道的)
2、如果“差异不大”,UE4就会统一采用 gradle目录来打aab,来作为所有架构的aab。我们的例子中,就属于这种情况。代码里叫做“bCombinedBundleOK”,即统一打根部gradle来打出aab。
3、下面情况属于“差异大”:
● arm64目录缺乏它的gradle目录。代码搜“Source directory missing”
● arm64目录/Gradle目录的 “AndroidManifest.xml”在某些属性上存在差异,细节太细不用管。代码搜“AndroidManifest.xml files differ too much”
● arm64目录/Gradle目录的 “gradle.properties”在某些属性上存在差异,细节太细不用管。代码搜“Gradle projects differ too much”
● 有更加多的未知差异。代码搜“Gradle projects differ too much”
4、上面四种情况对应的日志都没搜到,说明 bCombinedBundleOK (差异不大)
结论:最终打出aab时,确实没用上 arm64 架构目录。打包只使用了gradle目录。
代码示意图
关键代码与日志
请打开UEDeployAndroid.cs:MakeApk() 方法,针对上图的一些代码,做下面的解释:
1、UnrealBuildTool.UEDeployAndroid.MakeApk()
打aab|apks 或打apk的入口函数。
2、foreach (Tuple<string, string, string> build in BuildList)
在我的项目案例中,只有 arm64 。接下来的若干代码要点,处在该循环中,实际上只跑了一次(即arm64)。
3、(在循环中)
string UE4BuildPath = Path.Combine(IntermediateAndroidPath, Arch.Substring(1).Replace("-", "_"));
// 这个值是:{项目}\Intermediate\Android\arm64
4、(在循环中)
// check to see if libUE4.so needs to be copied
if (BuildListComboTotal > 1 || FilesAreDifferent(SourceSOName, FinalSOName))
{ // 没有执行
Log.TraceInformation("\nCopying new .so {0} file to jni folder...", SourceSOName);
Directory.CreateDirectory(JniDir);
// copy the binary to the standard .so location
File.Copy(SourceSOName, FinalSOName, true);
Log.TraceWarning("// *Gradle* SourceSOName {0} copy to ->> FinalSOName {1}", SourceSOName, FinalSOName);
// SourceSOName D:\项目\Binaries\Android\项目-Android-Test-arm64.so 拷贝给:
// D:\项目\Intermediate\Android\arm64\jni\arm64-v8a\libUE4.so ✔
// 案例中,没有拷贝,被增量跳过了。
File.SetLastWriteTimeUtc(FinalSOName, File.GetLastWriteTimeUtc(SourceSOName));
}
// remove any read only flags
FileInfo DestFileInfo = new FileInfo(FinalSOName);
DestFileInfo.Attributes = DestFileInfo.Attributes & ~FileAttributes.ReadOnly;
File.SetLastWriteTimeUtc(FinalSOName, File.GetLastWriteTimeUtc(SourceSOName));
Log.TraceWarning("// *Gradle* SourceSOName {0} DestApkName {1}, FinalSOName {2}", SourceSOName, DestApkName, FinalSOName);
// 实际是:2024-10-28 21:17:08:726 : WARNING:
// // *Gradle* SourceSOName D:\项目\Binaries\Android\项目-Android-Test-arm64.so
// DestApkName D:\项目\Binaries\Android\项目-Android-Test-arm64.apk,
// FinalSOName D:\项目/Intermediate\Android\arm64/jni/arm64-v8a/libUE4.so
拷贝libUE4.so,这是一个重要的符号表文件。
5、 (在循环中)
File.Copy(Path.Combine(UE4BuildPath, "AndroidManifest.xml"), GradleManifest, true);
// 应该是指: 项目\Intermediate\Android\arm64/AndroidManifest.xml 拷贝给 项目\Intermediate\Android\arm64\gradle\app\src\main\AndroidManifest.xml
AndroidManifest.xml 是什么?下面是AI的解答:
`AndroidManifest.xml` 文件是 Android 应用程序项目中的一个关键配置文件。它位于应用项目的根目录下,并定义了应用的元数据、组件、所需权限、硬件和软件功能需求等信息。以下是 `AndroidManifest.xml` 文件通常包含的内容:
1. **包名** (`package`): 应用程序的唯一标识符,通常是反向的域名格式。
```xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.myapp">
```
2. **应用标签** (`<application>`): 这是 `AndroidManifest.xml` 的主要部分,包含应用的所有组件和属性。
- **应用名称** (`android:label`): 显示给用户的应用名称。
- **应用图标** (`android:icon`): 应用的图标资源。
- **主题** (`android:theme`): 应用的主题样式。
3. **活动** (`<activity>`): 应用中的一个界面屏幕,通常用于与用户交互。
- **意图过滤器** (`<intent-filter>`): 定义了哪些意图可以启动该活动,例如默认启动的 `MAIN` 动作和 `LAUNCHER` 类别。
4. **服务** (`<service>`): 执行后台操作的组件。
5. **广播接收器** (`<receiver>`): 用于响应系统级广播的组件。
6、(在循环中)
CleanCopyDirectory(Path.Combine(UE4BuildPath, "assets"), Path.Combine(UE4BuildGradleMainPath, "assets")); // D:\项目\Intermediate\Android\arm64 /assets 等 拷贝给 项目\Intermediate\Android\arm64 / gradle/src/main
CleanCopyDirectory(Path.Combine(UE4BuildPath, "res"), Path.Combine(UE4BuildGradleMainPath, "res"));
CleanCopyDirectory(Path.Combine(UE4BuildPath, "src"), Path.Combine(UE4BuildGradleMainPath, "java")); // Path.Combine(UE4BuildGradleAppPath, "src", "main");
Intermediate\Android\arm64/assets (res,src) 等 拷贝给
Intermediate\Android\arm64/gradle/src/main/assets (res,java)
7、
foreach (string Filename in SourceFiles) // 这些文件是 D:\项目\Intermediate\Android\arm64\gradle 中的文件
{
……
Log.TraceWarning("// *Gradle* (4016), Filenam: {0}", Filename);
// 几乎遍历了每一个arm64里的文件 D:\项目\Intermediate\Android\arm64\gradle\app\src\main\libs\x86_64\libtgpa.so
if (!File.Exists(DestFilename))
{
File.Copy(Filename, DestFilename);
}
// 其中
// Source是 Intermediate/Android\arm64\gradle 中的文件
// Dest是 Intermediate/Android\gradle 中的同名文件
if (Filename.EndsWith("AndroidManifest.xml"))
{
... 某些关键点的比对,省略
bCombinedBundleOK = false; // 若确认差异很大,就认定为“不可CombindBundle”
Log.TraceInformation("AndroidManifest.xml files differ too much to combine for single AAB: '{0}' != '{1}'", Filename, DestFilename);
break;
}
…… gradle.properties的比对,同上,若差异很大,可能认定为“不可CombindBundle”。
…… 其它原因差异很大,可能认定为“不可CombindBundle”。省略
……
}
从 arm64\gradle 复制文件给 根gradle。并判断是否“差异大”。
8、
if (bCombinedBundleOK)
{UnrealBuildTool.UEDeployAndroid.CreateRunGradle()
创建 rungradle.batRunCommandLineProgramWithExceptionAndFiltering()
打印 Making .aab with Gradle..
调用Gradle打包} else { 略 }
在我的项目案例中,根gradle和arm64/gradle “差异不大”,将会打在根gradle文件夹。