Android Studio 如何导出 Jar 给 Unity 使用

大致步骤如下:
1.创建新的 Android Studio 工程
2.为此 Android Studio 工程创建 Android Library 类库(也就是一个 Module)(后面就是用它生成 jar)
3.生成 Jar
4.将 jar 导入 Unity 工程中的 Assets/Plugins/Android/
5.使用 AndroidJavaObject.Call 等方式调用

创建新的 Android Studio 工程#

1. 设置好 名称 、 路径 、 包名
这里的 Package name 只是这个 Android Studio 工程的包名,而我们需要的并不是这个工程,我们后面会在这个工程内新建一个 Android Library 类库,这个类库才是我们要导出 Jar 的对象。所以,这个 Android Studio 工程的 Application name 、Company Domain 、Package name 这三个参数可以随意填写,并不需要与正式工程相同。

2. 选择 SDK 版本
这里的意思是选择一个可兼容的最低的 Android 系统版本。自行选择,随意。

3. 选择 Empty Activity
直接选择空的 Activity 就可以了,因为这个是本工程的 Activity,并不是我们要导出的 Jar 的 Activity。

4. 给此 Activity 定义参数
同样,因为这个是本工程的 Activity,并不是我们要导出的 Jar 的 Activity。所以随意填写,和要导出的 Jar 无关。

5. 新建 Module

6. 选择 Android Library

7. 输入 Module 的参数
这里的参数就是要导出 jar 的 Android Library 类库参数。Package name 与正式工程一致。 Application/Library name 就是就填你要导出的 jar 插件的名称。Module name 自动填写就不用管了。

8.找到 Unity 中的 classes.jar 导入到这个 Module 的 libs 中。classes.jar 在安装路径的相对路径如下:
\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jar
(Project 视图下可以看到 libs 文件夹)

9.把 classes.jar 加入依赖。点击 File->Project Structure

Modules 选择自己新建的 Android Library,中间栏点 Dependencies 标签,然后点击右侧加号+,选择 File Dependency,然后找到自己拷贝进来的在 libs 目录下的 classes.jar 点击OK

9.给 Module 添加 Activity Class

给新建的 Class 命名。输入 Name 然后点击 OK。


package com.example.myjar;

import android.content.Intent;
import android.os.Bundle;

import com.unity3d.player.UnityPlayerActivity;

public class MyActivity  extends UnityPlayerActivity {
    @Override
    protected void onCreate(Bundle bundle) {
        super.onCreate(bundle);
    }

    public void ShareText(String message, String body) {
        Intent sharingIntent = new Intent(android.content.Intent.ACTION_SEND);
        sharingIntent.setType("text/plain");
        sharingIntent.putExtra(android.content.Intent.EXTRA_SUBJECT, message);
        sharingIntent.putExtra(android.content.Intent.EXTRA_TEXT, body);
        startActivity(Intent.createChooser(sharingIntent, "Share via"));
    }

}

10. 修改 build.gradle

双击 build.gradle,修改代码,注意修改的是自己新建的 Library 的build.gradle,不是整个 project 的 build.gradle

在 build.gradle 末尾添加以下代码,表示添加了一个 Task 任务

//task to delete the old jar
task deleteOldJar(type: Delete) {
    delete 'release/AndroidPlugin.jar'
}

//task to export contents as jar
task exportJar(type: Copy) {
    from('build/intermediates/bundles/release/')
    into('release/')
    include('classes.jar')
    ///Rename the jar
    rename('classes.jar', 'AndroidPlugin.jar')
}

exportJar.dependsOn(deleteOldJar, build)

11. 刷新 gradle

一般情况下修改了 build.gradle 后,系统上方会让你 SyncNow,还可以手动刷新一下,右侧点击 Gradle 标签,选中自己的 Library,右击选择Refresh external project

12. 生成 Jar
在上一步的窗口中(Gradle projects窗口)往下翻,可以在自己的 Library 展开项的 other 的展开项中找到 exportJar ,双击,然后等待完成。

然后就可以在 release 目录下面找到生成好的 jar 包了,右击这个 jar 包选择 Show in Explorer 就可以拿到这个 jar 包了。

13. 导入 Unity
将拿到的 jar 放到 unity 工程的 Asset/Plugins/Android/ 目录下。没有的话就手动创建目录。

**14. 修改或添加 AndroidManifest.xml **
**(重要,请仔细阅读,真正理解 AndroidManifest 才是最快的方式) **

如果你是新工程,没有使用过其他 android 的 sdk(指的是 unity 的插件),应该是没有AndroidManifest.xml文件的,这样可以在 Asset/Plugins/Android/ 目录下新建一个 AndroidManifest.xml。

先介绍新加一个 AndroidManifest.xml

**需要注意 **的就是主 activity 的 android:name 需要为 用于导出 jar 的 Library 的包名 + 我们导出的 jar 的主类名(就像下方第4行:"com.example.myjar.MyActivity")(这个包名,其实也就是 unity 工程 Player Settings 中填写的包名,因为他们需要一致)

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-permission android:name="android.permission.VIBRATE"></uses-permission>
  <application android:icon="@drawable/app_icon" android:label="@string/app_name">
    <activity android:name="com.example.myjar.MyActivity"
          android:label="@string/app_name"
          android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>
  </application>
</manifest>

修改 AndroidManifest.xml
如果你之前的工程有使用过其他的 Android 的 SDK(指的是 unity 的插件),那么在 Asset/Plugins/Android/ 目录下应该已经有一个 AndroidManifest.xml,那么你就需要将这次导出的 jar 的 activity 添加到这个 AndroidManifest.xml 中进行注册。

一个 AndroidManifest.xml 只有一个主 activity (直接的观察就是这个 activity 标签中包含了下面这段标签)。

      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>

(这里需要强调一下,本文是基于 unity 的 Android 平台的)
而 unity 工程,需要将继承了 UnityPlayerActivity 或者 UnityNativePlayerActivity 的 Activity (见上面第9步)为启动 Activity ,才可以在 Android 平台(说白了就是手机等等)启动你的 unity 工程。而这个 “设置为启动 Activity ” 的步骤,就是在 AndroidManifest.xml 中完成的,也就是在 AndroidManifest.xml 中将这个 Activity 注册为主 Activity 。

还有,你在 unity 中做的所有东西,发布到 Android 上,就只有一个 Activity,你如果在 unity 中唤起了其他的 Activity,就会像手机后台切应用一样的切换到你唤起的这个 Activity。所以,进行 unity 的 android 插件开发,只有一个入口,也就是继承 UnityPlayerActivity 或者 UnityNativePlayerActivity (UnityNativePlayerActivity 其实就是继承UnityPlayerActivity 的一个类,并没有进行任何操作)。

理解了这些之后,就能理解为什么一般的 unity 插件,并不会将自己的 Activity 注册成主 Activity,所以你只需要将他们的 Activity 标签复制粘贴到你的 AndroidManifest.xml(Asset/Plugins/Android/ 目录下,一个工程只需要一个 AndroidManifest.xml(多个的用法本文不涉及,你只需要知道,Asset/Plugins/Android/ 目录下仅有一个 AndroidManifest.xml 文件))中就可以了(如果他们的 Activity 标签有上面提到的 “intent-filter” 标签 也就是被标记成主 Activity,你就要考虑,他们的功能是需要在 unity 的这个主 Activity 启动就响应的,还是切换另外一个 Activity 才进行操作的)。

所以,综上,如果是你自行开发的多个 unity Android 插件(jar),就需要尽量先在 Android 层合并成一个 jar 插件包,以保证只有一个入口,一个主 Activity 。不光是自行开发的,使用其他 sdk 的时候,也要想,如果可以直接在 Android 层进行合并操作(统一一个 Activity 入口,然后所有调用其他 sdk 功能的接口全部放在这个 Activity 中)的,就尽量在 Android 层进行。

多个 unity Android 插件(jar)合并的时候,难的部分其实也不难,就是理解他们的功能,然后合并 AndroidManifest.xml 的操作。

(下次我会介绍一些特殊情况,比如如何合并 Vuforia 的 AR SDK 和 其他 SDK 插件)

15.调用 jar 插件中的接口
unity 中调用 android 层的接口基本都是通过 AndroidJavaClass 、AndroidJavaObject 的方式。
比如,上面我导出的 jar 插件中,在 MyActivity 类中我写了一个 ShareText(String , String ) 的接口(第9步),那么我在 unity 中就可以通过以下代码调用这个接口。

  AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
  AndroidJavaObject jo = jc.GetStatic<AndroidJavaObject>("currentActivity");
  string message = "this is my title";
  string body = "this is my content";
  jo.Call("ShareText", message, body);

如果你需要唤起其他的 Activity,就在上方第二行,将 "currentActivity" 改成你在 AndroidManifest.xml 中注册的 Activity 名字,然后就可以通过 AndroidJavaObject.Call 的方式调用那个 Activity 类里的接口。如果这个接口在这个 Activity 类里被标记成了 static,还可以通过AndroidJavaObject.CallStatic 的方式调用。

第一行的 "com.unity3d.player.UnityPlayer" 是需要调用的接口所在的 Activity 所在的包名,如果是 unity 主 Activity ,就可以直接使用 "com.unity3d.player.UnityPlayer",如果是其他插件包,就使用那个包的包名。

16. 效果

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,298评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,701评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,078评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,687评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,018评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,410评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,729评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,412评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,124评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,268评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,894评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2 260

推荐阅读更多精彩内容