Unity和Android的交互

Unity和Android的交互

一、前言二、Android导出jar/aar包到Unity2.1 版本说明2.2 拷贝Unity的classes.jar给Android工程2.2.1 classes.jar的位置2.2.2 Android Studio创建module2.2.3 拷贝classes.jar 到 Android工程并启用

2.3 编写Android工程代码2.3.1 创建 MainActivity2.3.2 MainActivity改继承 UnityPlayerActivity2.3.3 拷贝 UnityPlayerActivity2.3.4 编写Android工程代码2.3.5 编写AndroidManifest.xml

2.4 编写Unity工程代码2.4.1 搭建游戏物体GameObject

2.5 导出和构建APK2.5.1 导出Java文件2.5.2 导出Jar包2.5.2.1 构建Jar包2.5.2.2 新建Task任务构建和重命名Jar包

2.5.3 导出aar包2.5.3.1 构建aar和修改aar包2.5.3.2 压缩aar包细节2.5.3.3 解决Androidmainfest合并问题2.5.3.4 解决桌面2个启动图标

一、前言

Unity和Android原生交互的方式大概有2种，一种是Android导出jar/aar包给Unity，然后Unity来构建apk；另外一种是Unity勾选Export Project，导出为一个Android工程，然后用AndroidStudio构建APK；这里讲讲第一种方式

二、Android导出jar/aar包到Unity

2.1 版本说明

这里我用的Unity版本是 2020.3.33f1c2; AndroidStudio 用的版本是 2021.3.1 思路大致是一致的，但不同版本可能导出的文件路径不太一样或内容可能不太一样，这个要注意一下

2.2 拷贝Unity的classes.jar给Android工程

2.2.1 classes.jar的位置

classes.jar 位于 {Unity 安装位置}\Editor\Data\PlaybackEngines\AndroidPlayer\Variations{mono或il2cpp}\Release\Classes\ 目录下

这里主要涉及到2个变量，一个是Unity版本，一个是mono或il2cpp; 不同Unity版本的安装路径不一样，可以用UnityHub点击 设置按钮-在资源管理中显示。快速进入到对应版本的目录； 至于mono或il2cpp，主要看你选用哪种打包方式。由于是示例空工程，并且要快速构建，所以我这里选了mono;

2.2.2 Android Studio创建module

先用Android Studio新建一个Android Studio空工程，接着我们创建一个module模块来实现功能 点击 File-New-New Module，拉起创建面板 注意，这里要先切换到Android Library页签，然后可以输入你喜欢的module名字

2.2.3 拷贝classes.jar 到 Android工程并启用

拷贝第一步的classes.jar，并粘贴进模块的libs目录下 启用classes.jar 粘贴进来后，其实还没起作用。右键classes.jar，然后点击 Add as Library 然后你会发现classes.jar有个三角标了，这时才起作用了。 Add as Library 这一步操作等同于在module的build.gradle里添加 implementation files(‘libs\classes.jar’), 然后 点击 File - Sync Project with Gradle Files按钮； 我们也可以通过修改文件的方式来快速的添加和移除lib

2.3 编写Android工程代码

2.3.1 创建 MainActivity

在模块下创建MainActivity ，也不一定要这个名字，可以根据你喜欢的来

2.3.2 MainActivity改继承 UnityPlayerActivity

这里MainActivity 改继承自UnityPlayerActivity，不出意外，改继承后这里会报红。这是因为新版本的Unity（大概是2019和之后的版本），导出的 classes.jar 不再包含 UnityPlayerActivity了。所以我们需要再拷贝一个UnityPlayerActivity过来

2.3.3 拷贝 UnityPlayerActivity

这个路径在对应Unity版本的 Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player目录下。只要找到前面的classes.jar，相信这个对你来说也是轻松找到

拷贝进Android工程 如下图，可以保持和MainActivity同级，拷贝进来 然后修改package路径（可以从MainActivity.java里拷贝package路径粘贴进来）和 引入命名空间 代码如下，熟悉的朋友也可以在报红处按下Alt + Enter，手动引入

package com.example.linkunitylibrary; //这里拷贝你MainActivity的package

//import导入依赖

import com.unity3d.player.IUnityPlayerLifecycleEvents;

import com.unity3d.player.MultiWindowSupport;

import com.unity3d.player.UnityPlayer;

然后 MainActivity就不报红了

题外话 记得好像有些教程是放在com.unity3d.player目录下，并保持原包名，如下图的层级和package路径。我有测试过，但在最后构建apk会报错。 原因我觉得是这样：因为最终我们要把android studio构建出来的jar包或aar包，放回unity。那如果这里保持一样的包名，到时放回unity,就相当于有2个一样的 com.unity3d.player.UnityPlayerActivity 类了，那就会报错。所以我觉得这种方式应该不可行…

2.3.4 编写Android工程代码

这里我们分别 写一个方法给Unity调用 和 调用Unity里的一个方法 代码如下

package com.example.linkunitylibrary;

import android.os.Bundle;

import com.unity3d.player.UnityPlayer;

/**

* Created by super41 on 2024/4/5.

*/

public class MainActivity extends UnityPlayerActivity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

//调用Unity的方法

a2u_add(1,5);

}

//写一个方法给Unity调用

public int u2a_add(int a,int b){

return a + b;

}

//调用unity里的方法

public void a2u_add(int a,int b){

sendMsg2Unity("a2u_add",a+"|"+b);

}

private static final String LinkGameObjectName = "UnityLinkAndroidGo";

/**

* 给Unity发消息

* @param methodName 方法名

* @param params 参数

*/

private void sendMsg2Unity(String methodName,String params){

//依次传入 GameObjectName, GameObject里的方法，参数

//因为这里 GameObjectName 一般固定，所以封装起来

//只能传递一个参数，多个参数拼接在params里

UnityPlayer.UnitySendMessage(LinkGameObjectName,methodName,params);

}

}

2.3.5 编写AndroidManifest.xml

修改AndroidManifest.xml，这里记得替换为你自己的包名和类名

android:allowBackup="true"

android:supportsRtl="true">

2.4 编写Unity工程代码

2.4.1 搭建游戏物体GameObject

创建2个Text文本，一个显示Unity_Call_Android的加法结果，一个显示Android_Call_Android的加法结果 创建UnityLinkAndroidGo物体，这里游戏名字要跟Android代码里的物体名字一致。 创建任意名字的脚本，如UnityLinkAndroidScript，代码如下

using System.Collections;

using System.Collections.Generic;

using UnityEngine;

using UnityEngine.UI;

public class UnityLinkAndroidScript : MonoBehaviour

{

public Text Txt1;

public Text Txt2;

// Start is called before the first frame update

void Start()

{

u2a_add(100,200);

}

///

void u2a_add(int a, int b)

{

//标准操作，获取MainActivity对象

AndroidJavaClass javaClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer");

AndroidJavaObject javaObject = javaClass.GetStatic("currentActivity");

//调用方法

var result = javaObject.Call("u2a_add", a, b);

Txt1.text = $"UnityCallAndroid {a} + {b} = {result}";

}

///

///

void a2u_add(string objs)

{

var arrays = objs.Split('|');

var a = int.Parse(arrays[0]);

var b = int.Parse(arrays[1]);

var result = a + b;

Txt2.text = $"AndroidCallUnity {a} + {b} = {result}";

}

}

然后把2个Text附上

2.5 导出和构建APK

一切准备就绪，接下来就是导出和构建APK了

2.5.1 导出Java文件

我们一般是导出jar包和aar包文件。其实也可以用导出java文件的方式 如下图，3个文件导出到Unity的Assets/Plugins/Android/目录下，如没有目录则创建 接着就是常规的构建apk了。我们来看运行结果。可以看到成功运行了起来

2.5.2 导出Jar包

2.5.2.1 构建Jar包

上面的导出java文件一般不是主流的方式，还是导出成一个压缩包的形式更好管理一点。我们来看看怎么导出jar包 选中你的module，然后点击 Build - Make Module xxx. 然后打开资源管理器，就可以看到这里生成了一个build目录 进入build\intermediates\aar_main_jar\debug\目录（这里不同Android版本可能输出路径不一样，思路是一致的） 可以找到classes.jar 拷贝这里的classes.jar拷贝到Plugins/Android/目录下，并删除掉原来的java文件。如下图 然后就是构建apk了，也可以得到我们想要的效果；

2.5.2.2 新建Task任务构建和重命名Jar包

一般我们需要重命名我们的jar包，不然叫classes.jar不太好，手动改每次都要来一遍不太好。我们可以添加task任务来实现这一步骤。打开module的build.grade,在文件的最后添加任务

代码如下：

//删除旧jar包

task tryDeleteOldJar(type:Delete){

delete('release/HelloWorld.jar')

}

//导出并重命名jar包

task exportJar(type : Copy){

from('build\\intermediates\\aar_main_jar\\debug')//从这个路径拷贝

into('release') //拷贝到这个路径

include('classes.jar')

rename('classes.jar','HelloWorld.jar')

}

//添加依赖

exportJar.dependsOn(tryDeleteOldJar,build)

然后Sync刷新一下 点击右侧的Gradle,然后点击Task/other 就可以看到exportJar任务了 双击执行它，我们可以得到一个重命名好的HelloWorld.jar 如果看不到Task任务，那是一些版本的AndroidStudio隐藏掉了，可以进入File-Setting-Experimental,然后取消勾选这个Do not build… 选项，然后点击OK后你就可以看到Task了（当然不同版本可能设置不一样，这里主要介绍一种解决思路） 到此，导出Jar包的形式也好了

2.5.3 导出aar包

我们还可以导出aar包，aar和jar包的区别是，jar包一般只包含java文件，而aar包除此之外，还可以包含res和AndroidMainfest.xml

2.5.3.1 构建aar和修改aar包

接下来我们来实现导出aar包； 和之前一样，我们选中Module,点击Build-Make Module来构建 可以在build/outputs/aar里面找到aar aar包本质上是一个压缩包，我们改为.zip格式，然后用压缩文件打开。目录大致如下 还记得我们从unity拷贝了一个classes.jar过来嘛，这个文件也会被构建进aar包，然后当我们把aar包放回unity,那么就会有重名的类。所以我们需要删除掉这个classes.jar 具体的操作方式是： 把libs里的classes.jar删掉，然后箭头的classes.jar拖进libs目录

2.5.3.2 压缩aar包细节

然后接下来就是重新压缩成一个aar包了。压缩这里有2点很关键，我当时自己也是踩坑了好几个小时。 现在说一下：

选中你的文件列表，然后右键进行压缩，如下图。注意不要在外层目录压缩，不然会多嵌套一层文件夹，导致Unity识别不到； 压缩格式这里选zip，不要选默认的rar… 当时就是选rar，然后就进坑了… 然后把得到的压缩包改为aar后缀 然后放回Unity，因为aar包已经有了AndroidMainfest.xml，所以可以把之前的删掉，只留下aar包 接下来就是构建出APK了，也可以得到我们想到的效果；

2.5.3.3 解决Androidmainfest合并问题

如果构建过程中提示AndroidMainfest 合并失败，如下图。是因为最小sdk版本要改一下 这里你可以对aar包里的minSdkVersion进行修改，改成提示的版本，比如我这里是改成19，然后导出为压缩包 也可以对Modudle的build.gradle改下minsdk版本，我这里是改成19，这种方式更好一点。然后重新构建aar包

2.5.3.4 解决桌面2个启动图标

使用导出aar的方式构建出的apk，桌面上可能会有2个程序入口，也就是2个图标。 我们需要修改下AndroidMainfest.xml 进入PlayerSetting,勾选 CustomMainfest.xml 然后会自动生成AndroidMainfest.xml 进入AndroidMainfest.xml，把这个activity整段删掉，然后再构建apk即可

最后导出APK就可以了。至此我们就完成了3种导出方式

相关阅读

 您阅读本篇文章共花了：