前言
项目之前使用Eclipse导出的jar文件来做与Android交互,最近因为工作需要需使用Android Studio的aar文件,网上参考了部分文章,也结合自己的理解重新整理一下具体的方法,通过写一个测试Demo来表述Android Studio创建aar的过程与及Unity如何使用aar文件,希望对刚好有这个需求的人能起到部分帮助与引导,同时如果文中有误希望也能不吝赐教。
版本信息
Unity 5.3.1f1,
Android Studio 2.2.3
Android Studio导出可供Unity使用的aar插件
一、 创建Android Studio工程
1)第一步,点击File->New->New Project,打开"Create New Project"对话框,选择合适的Application name与Company Domain,保证Package name与Unity项目中的Bundle Idenifier一致
2)第二步,选择Phone and Tablet,并选择合适的Minimum SDK(也可以在创建后的build.gradle中设置)
3)第三步,选择“Empty Activity”
4)第四步,保持默认的Activity Name与Layout Name即可
5)最后,点击"Finish"创建工程
二、添加Unity的classes.jar引用
1)把Unity引擎目录下中的”Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jar“文件拷贝至Android Studio工程中的libs目录
2)右击"Project"视图,打开"Open Module Settings", 添加“classes.jar”依赖
三、编写Android侧代码(修改MainActivity代码)
import android.os.Bundle;
import android.widget.Toast;
import com.unity3d.player.UnityPlayer;
import com.unity3d.player.UnityPlayerActivity;
public class MainActivity extends UnityPlayerActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
}
// 显示Toast消息
public void ShowToast(final String message){
runOnUiThread(new Runnable() {
@Override
public void run() {
Toast.makeText(getApplicationContext(), message, Toast.LENGTH_LONG).show();
}
});
}
// 返回一个字符串(静态方法)
public static String GetInformation()
{
return "This is a Plugin's content!";
}
}
四、修改build.gradle,设置工程导出为aar
1)apply plugin: 'com.android.application' 修改为 apply plugin: 'com.android.library'
2)删除 applicationId "com.zcode.unityandroidplugindemo"
3)修改后的build.gradle为
apply plugin: 'com.android.library' android { compileSdkVersion 24
buildToolsVersion "24.0.1"
defaultConfig {
minSdkVersion 18
targetSdkVersion 24
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:24.1.1'
testCompile 'junit:junit:4.12'
compile files('libs/classes.jar')
}
五、修改AndroidManifest.xml
1)修改样式
我们需要在 AndroidManifest 中的 application 结点修改应用的主样式为系统样式,因为导出的 AAR 文件将不带自定义的样式,在我们的 Unity 项目中生成最终 apk 的时候会出现样式找不到的错误。
同时需要删除res\Values目录下的styles.xml文件
2)在主 activity 结点下添加<meta-data>信息,否则在 Unity 导出 APK 时会报找不到manifest 文件的错误信息
六、导出供Unity使用的*.aar文件
1)点击“Build -> Build APK”,生成aar文件
2)由于Unity在打包APK时会自动包含自身的classes.jar,所以需使用压缩软件打开aar文件删除libs目录下的classes.jar文件
Unity导入插件,并调用
一、创建Unity工程
二、导入插件到Unity工程中
1)新建Plugins目录与Android子目录
2)拷贝aar文件与AndroidManifest.xml文件至Android目录下
三、编写测试代码
1)新建一个“Call.cs”的脚本文件
2)在“Call.cs”脚本中编写调用Android侧代码
using UnityEngine;
using System.Collections;
public class Call : MonoBehaviour {
string information_ = null;
void OnGUI() {
//调用显示一个文本为“Hello World!”的Toest
if(GUI.Button(new Rect(0, 0, 200, 20), "Show Toest - Hello World!")) {
//Unity侧调用Android侧代码
using (AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) {
using (AndroidJavaObject jo = jc.GetStatic<AndroidJavaObject>("currentActivity")) {
//调用成员方法
jo.Call("ShowToast", "Hello World!");
}
}
}
//获得插件侧的返回字符串
if (GUI.Button(new Rect(0, 40, 200, 20), "Get Plugin's Information")) {
//Unity侧调用Android侧代码
using (AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) {
using (AndroidJavaObject jo = jc.GetStatic<AndroidJavaObject>("currentActivity")) {
//调用静态方法
information_ = jo.CallStatic<string>("GetInformation");
}
}
}
//显示返回的字符串
GUI.Label(new Rect(220, 40, Screen.width - 220, 20), information_);
}
}
四、导出APK
1)设置Bundle Identifier(保持与插件PackageName一致)
2)设置合适的Minimum API Level(保持与插件)
五、测试
Demo地址
http://pan.baidu.com/s/1dFxc7JF
结尾
Android侧调用Unity侧的方式在此就不多做赘述,网上相关的文章也很多。
Android插件工程中使用第三方的aar库中遇到的Bug解决方案
1.需手动拷贝至Unity项目Plugin/Android目录下,不然会找不到该库引起NoClassDefFoundError的错误,导致项目真机引起宕机(PS:Unity打包APk时并不会检查Android插件中是否完整包含其它aar库)
2.确定所有的aar库中的android:minSdkVerion与android:targetSdkVersion一致