Unity和Android的交互
- 一、前言
- 二、Android导出jar/aar包到Unity
- 2.1 版本说明
- 2.2 拷贝Unity的classes.jar给Android工程
- 2.2.1 classes.jar的位置
- 2.2.2 Android Studio创建module
- 2.2.3 拷贝classes.jar 到 Android工程并启用
- 2.3 编写Android工程代码
- 2.3.1 创建 MainActivity
- 2.3.2 MainActivity改继承 UnityPlayerActivity
- 2.3.3 拷贝 UnityPlayerActivity
- 2.3.4 编写Android工程代码
- 2.3.5 编写AndroidManifest.xml
- 2.4 编写Unity工程代码
- 2.4.1 搭建游戏物体GameObject
- 2.5 导出和构建APK
- 2.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 {@Overrideprotected 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,这里记得替换为你自己的包名和类名
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"><applicationandroid:allowBackup="true"android:supportsRtl="true"><activity android:name="com.example.linklibrary.MainActivity" android:exported="true"> <!--包名和类名,这里换成你自己的包名和类名--><intent-filter><action android:name="android.intent.action.MAIN" /> <!--主入口Activity--><category android:name="android.intent.category.LAUNCHER" /> <!--添加到桌面--></intent-filter><meta-data android:name="unityplayer.UnityActivity" android:value="true" /></activity></application></manifest>
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 updatevoid Start(){u2a_add(100,200);}/// <summary>/// Unity调用Android/// </summary>void u2a_add(int a, int b){//标准操作,获取MainActivity对象AndroidJavaClass javaClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer");AndroidJavaObject javaObject = javaClass.GetStatic<AndroidJavaObject>("currentActivity");//调用方法var result = javaObject.Call<int>("u2a_add", a, b);Txt1.text = $"UnityCallAndroid {a} + {b} = {result}";}/// <summary>/// 给android调用的方法/// </summary>/// <param name="objs"></param>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种导出方式