unity版本2018.4.18。后续版本可能不同
unity打包说明
- unity通过使用jdk,ndk打包成Android资源,输出到\Temp\gradleOut中
- 使用gradle打包
unity打包的关键就在第一步。也就是第一部中可能有版本限制什么的。
- 如果是直接通过unity打包(不需要额外手动操作),就需要2步使用的环境能相同,下面版本说明将详细说明
- 如果只是使用unity生成产物,然后再用产物来打包,实际上就没有必要非要环境相同了。用最新的gradle+对应的AGP就行。
版本说明
由于该版本的jdk只支持1.8,
ps:如果用IL2CPP还需要指定使用R16B的NDK
所以,Android gradle 插件com.android.tools.build:gradle必须使用7.0.0以下的(7.0.0要求jdk11)
目前unity项目中使用的版本:
- JDK:1.8 (强制要求只能用这个版本)
- Grale:6.4.1 (配合jdk版本,只能使用7.0.0以下版本)
- Android 打包工具:4.0.0 (配合Grale)
classpath 'com.android.tools.build:gradle:4.0.0'
整体结构
- gradle版本指定问题
参考
版本对应关系
实际上真正用的目录是UR\gradle\lib中的版本
只要将这个lib替换为指定的版本就行 - 其他参数问题,主要是针对gradle.properties文件,比如支持AndroidX,
参考
在项目的Asset/Plugins/Editor下新建一个C#文件,命名为SupportAndroidXGradlePropertiesBuildProcessor.cs
using System.IO;
using UnityEditor.Android;
using UnityEngine;
#if UNITY_ANDROID
public class SupportAndroidXGradlePropertiesBuildProcessor : IPostGenerateGradleAndroidProject
{
public int callbackOrder
{
// 同种插件的优先级
get { return 999; }
}
public void OnPostGenerateGradleAndroidProject(string path)
{
Debug.Log("Bulid path : " + path);
string gradlePropertiesFile = path + "/gradle.properties";
if (File.Exists(gradlePropertiesFile))
{
File.Delete(gradlePropertiesFile);
}
StreamWriter writer = File.CreateText(gradlePropertiesFile);
writer.WriteLine("org.gradle.jvmargs=-Xmx4096M");
writer.WriteLine("android.useAndroidX=true");
writer.WriteLine("android.enableJetifier=true");
writer.Flush();
writer.Close();
}
}
#endif
构建
UR:unity安装根目录\Editor\Data\PlaybackEngines\AndroidPlayer\Tools
PR:项目根目录
- 通过 .UR\GradleTemplates中的几个模板是整体的根模板,可以改这里来更改所有的项目。
- PR\Assets\Plugins\Android\mainTemplate.gradle的修改来实现基本的依赖的调整
其他
1. google登录的google-services.json配置
可以在mainTemplate.gradle中直接添加任务。比如
task copyJsonFile {
copy {
delete("google-services.json")
from('E:/workdata/unity/GameHoursDemo/Assets/Plugins/Android/')
into('./')
include("google-services.json")
}
}
2. AndroidManifest配置
官方文档
参考
默认模板位置.\Editor\Data\PlaybackEngines\AndroidPlayer\Apk
- 可以用脚本插入的方式。但是并不直观
参考方案 - 直接覆盖,将自己的放入PR/Assets/Plugins/Android/AndroidManifest.xml中
注意要在原本模板上修改,主要是unity用的主activity不能动它的,必须是com.unity3d.player.UnityPlayerActivity
3. 如果由于特殊原因无法使用31来打包。
可以继续使用30来打包,然后强制指定androidx.appcompat版本
compileSdkVersion 30
configurations.all {
resolutionStrategy.eachDependency {
DependencyResolveDetails details ->
def requested = details.requested
if (requested.group == "androidx.appcompat") {
if (requested.name == "appcompat") {
details.useVersion "1.3.1"
}
}
}
}