面向Unity程序员的Android快速上手教程

接下来选择要开发什么类型的App，这里勾上Phone and Tablet就可以了。SDK的选择一般来说根据项目的需要， 最低一般不低于API 9: Android 2.3(Gingerbread)，这也是Unity能接受的最低SDK。如果有些插件不能运行在这么 低的Android SDK环境下的话可以酌情考虑提升到API 15: Android 4.3(IceCreamSandwich)，这个等级的API一般 也是可以兼容绝大多数近3-4年的机器。

因为我们要输出的内容是给Unity用的，这里可以先选择不带有Activity（就是承载游戏画面的基础部件），后续用 到再说。

点击OK以后Android Studio就会开始初始化当前的这个Android项目。初始化会需要一段时间，因为AndroidStudio有可能会去下载一些必要的框架或者更新Android工具的版本。初始化完成以后到左边按照图里面的步骤点 开就可以看到整个项目目录树的情况。

通过上图我们可以知道，一个Android Studio的项目（Project）可以由许多小的模块（Module）组成，这些模块 可以是带有Activity的应用类模块，也可以是不带有Activity的库模块等等。这些小的模块之间可以有引用关系。我 们可以把一些完成基础功能或者容易被复用的模块单独拆出来。

如果要新建一个模块我们可以在上图的列表中点右键选择New Module，在弹出的界面中我们可以选择要新建什么 样的模块，或者从Eclipse导入旧的项目也可以。一般来说给Unity游戏开发插件最常用的就是库模块（Android Library）。同样的，在接下来弹出的窗口中填写好模块名称、包名以及最低运行的SDK。

简单的看一下Android项目的目录结构。如下图所示：

● libs目录跟本文第一部分介绍的libs目录的功用是一样的，把依赖到的库放在这里面就可以了。

● src/main/res目录也是跟本文第一部分介绍的res目录的功能和结构是一样的，把对应资源放进去就可以了。

● 接下来是java代码所在的目录src/main/java，这个目录有点特殊，他的子路径跟java文件里面定义的包名（package name）要对应的上。

● AndroidManifest.xml也是跟第一部分介绍的AndroidManifest的功能是一样的。

● build文件夹是Android Studio动态生成的，打出的APK包（应用模块）或者AAR包（库模块）会被放到这里面 的output文件夹。需要注意的是这个文件夹不应该被放提交到svn里面，要不然会造成项目成员之间的冲突， 切记。

● src/test以及src/androidTest是做单元测试用的，本文不涉及。

至此，我们就可以开始动手写代码了，这里我们写一个可以弹出Android的Toast提示的Activity来替换掉Unity默认 的Activity。

首先，我们在Android Studio中找到src/main/java（如上图所示），然后点击右键，选择新建Empty Activity。

在弹出的窗口中给你的Activity取个符合Java代码规范的名字，然后再想个合理的包名（当然，也可以直接用默认项 目的包名也可以）。可以参考下图的配置：

其中的Generate Layout File，我们在制作给Unity游戏用的Activity是不需要勾上的。Launcher Activity勾上以后 Android Studio会帮你在当前模块的AndroidManifest.xml中声明本Activity是应用的入口之一。 作为一个库项目我们这边其实也不需要这个选项。 点击Finish之后 Android Studio就会帮我们在指定目录下创建一个很简单的Activity。里面的内容如下：

需要注意的是这只是一个最基础的Android Activity，他还不会去加载我们的Unity出来，所以我们要让他继承自Unity的Activity而不是默认的。为此，我们要先将Unity相应的jar包引入到我们的模块当中。首先找到Unity的安装 目录，然后找到以下子目录Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Release\Classes\里

面的classes.jar，这个就是被打包成jar包的Unity默认的Activity。我们把这个jar包复制到当前模块的libs目录下（可 以把这个jar包改成你想要的名字，便于管理）。（这个jar包的源码在 Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player这个目录下。感兴趣的同学可以翻阅一 下源码，就可以理解Unity播放器的加载机制。）

接下来，我们可以在Android Studio左边的Project View中找到当前的模块以后点击右键，选择“Open ModuleSetting”或者直接按F4。在弹出的窗口中我们选到最右边的页签“Dependencies”，然后选择右边绿色的加号-Jar Dependency。

从项目的libs文件夹中找到刚刚导入的jar包，点击OK即可。接下来有一个比较关键的步骤就是，我们改变这个jar包 的scope属性，因为默认的scope属性（Compile）是会将该jar包里面的内容跟本模块里面Java代码合并到一起。这 在之后Unity打包这个模块的jar包的时候会报错，因为Unity里面内置了刚刚这个jar包。所以我们可以参考下图把这 个jar包的scope设置成provided。

然后删除上述列表的第一行，因为他会把所有libs文件夹下的jar包都打包到一起。跟我们刚刚做完的provided设置 会有冲突。

搞定了这步骤以后我们就可以回到刚刚新创建出来的Activity把他的父类改成UnityPlayerActivity，同时别忘记引用 一下相应的package，改完之后的代码是这样的：

到这一步，如果我们的Activity如果能被运行的话，他应该能够借助他的父类UnityPlayerActivity里面的代码来运行 Unity。接下来，我们来给这个Activity添加一方法，当这个方法被调用的时候会展示一个系统默认的Toast提示。

看得出来，里面最核心的一个方法其实就只是调用Android里面的Toast组件而已，没啥好解释的。相反，是外面的 runOnUiThread是值得大家注意的，在Android 编程中，所有涉及到对UI的操作必须要放在UI线程里面来做，否则会造成其他线程修改UI线程里面的数据然后崩 溃。由于我们写的这个ShowMessage方法最后会被Unity那边调用，而来自Unity的调用可能不是UI线程，所以我们 要给他做适当的保护。

在Android中有很多种调度方法可以把某段代码放到UI线程里面来跑。上面这段代码的 runOnUiThread的写法是最简便的一种写法。如果遇到比较复杂的逻辑可以考虑使用Messenger或者Handle来调 度线程，感兴趣的同学可以上网查一下。

完成Activity的代码编写之后就可以输出这个模块到Unity项目中去。在Android Studio中选择Build - Make Project 或者是在左边的项目视图中选中要导出的模块然后选择Build - Make Module。选择完了之后就可以看到下面有个 Gradle的进度条，待进度条完成了以后我们就可以到该模块的build/outputs/aar目录下去找输出的文件。打开这个 文件夹，可以看到有个*.aar的文件。这个就是该模块所编译出来的结果，如果你用解压缩软件去解压缩它，你会发 现他几乎就是一个完整的Android工程。根据本文第一部分所说的内容，我们只要在Unity工程中的 Plugins/Android目录下新建一个文件夹，然后把这个文件解压缩以后整个丢进去，再手写一个名字叫 project.properties，内容是android.library=true的文件放到新建的文件夹里面就可以了。

胜利在望，我们接下来只要把Unity工程里面的AndroidManifest.xml文件的入口Activity从Unity默认的的改成我们 刚刚写的这个就可以了。需要注意的是，如果是旧的Unity工程，可能已经有人写过相关的AndroidManifest文件放 在了Plugins/Android目录下，但是如果是全新的Unity项目的话，就没有这份文件了。在打包的时候，如果Unity发 现Plugins/Android目录下没有这份文件，他会复制一份默认的文件并且修改其中跟项目有关的内容。这里我们可以 从Unity的安装目录的Editor\Data\PlaybackEngines\AndroidPlayer\Apk文件夹内找到AndroidManifest.xml这份 文件，把它复制一份到Unity工程的Plugins/Android目录下。接下来就是修改里面的内容。

这里解释一下这份文件里面的一些关键内容。

● package="com.unity3d.player"这里的内容如果放着不动，打包的时候Unity会将其修改为Player Setting的Bundle Identifier。

● android:versionCode以及android:versionName这两部分的内容则在打包时会根据Player Setting里面的Version以及Bundle Version Code的内容来进行修改。

● android:icon以及android:label这两个对应的是应用的图标以及应用名称。如果不改的话，Unity也会自动根据Player Setting里面的内容来进行修改。

● android:debuggable="true"这个在打包的时候Unity也会自动根据Build Setting里面的Development Build选项自动进行修改。

● activity里面的android:name，这个name只的是该activity需要运行的哪个Java的Activity的类。如果不修改， 加载的就是Unity默认Activity的类。这篇文章需要把默认的Activity改成刚刚我们的实现，所以，我们把刚刚写 好的那个Activity的完整名称写上去（包括包名还有类名）。

● activity里面的android:label，这个是在桌面上图标下面写的那一行文字，也是应用的名称。不修改的话Unity会帮你维护。

● meta-data的这一行的name值是key，value值就是这个key对应的内容。meta-data可以根据需要自定义多个，但是key值不能重复，上面代码里面的unityplayer.UnityActivity应该是写给Unity看的，让Unity知道他自 己是运行在这个Activity上。

这里我们基本上只要修改activity里面的android:name这一项。修改完成后，我们就可以通过Unity自带Build功能来出Android包了。出包之前请检查一下Player Setting里面的Bundle Identifier，不能留默认的包名在这里，会造 成编译失败。编译过程中，可能会出现一些错误， 下面罗列几个常见的错误，可以尝试解决：

1. 合并Manifest文件出错，一般来说是在合并所有的AndroidManifest文件的时候出的错，常见的有重复定义了 activity、里面的最低sdk写错了。模块的最低sdk不可低于项目的最低sdk。

2. jar文件dex错误，当你的项目中不小心存在了一个以上的相同的jar文件，就会出这个错误，把重复的删掉，只 留一个就好了。

3. 找不到Android SDK里面的工具，这个一般来讲是Unity自己的bug，Unity一般不能兼容最新的Android SDK 的工具，所以要手动降级才行。

除了上述这些之外，在打包Android项目的过程中还会出现这些那些的错误，大家看到以后不要慌张，会报错总是 好的，而且一般的错误你把错误信息贴在万能的Google上，都能找到解决方案。

文章到这里为止，说清楚了怎么把Android这边写成的插件打包到Unity的项目中去。但其实并没有涉及到Unity中 怎么调用刚刚写好在Android的Activity中的代码。这一部对于一个Unity开发来说其实非常简单，只要以Unity提供 的AndroidJavaClass还有AndroidJavaObject来做为中介就可以在Unity和Java中互传数据。这两个类的调用给人一 种通过反射来调用Java代码的感觉。只要你能通过包名和类名拿到某个Java对象，就可以直接通过成员变量名称或 者方法名称直接调用到Java那边的代码。举个例子，假如要在Unity中调用刚刚我们写的那个类的ShowMessage类 的话我们需要在Unity中准备以下代码。

简单介绍一下这段代码的几个关键点：

1. 通过UnityPlayer可以很方便的拿到当前Activity的Java对象实例。

2. 对Java对象实例的方法的调用实际上很简单，只要调用Call就可以了。

3. 注意用宏来区隔Native代码。UNITY_ANDROID && !UNITY_EDITOR这个推荐的写法，如果不过滤掉UNITY_EDITOR会在运行的时候报错。

4. 推荐在new出AndroidJavaClass还有AndroidJavaObject的地方用using来进行保护，确保执行结束后Unity会自动回收相应的代码。

其他的部分在这篇文章里面我们不展开。

本文到这里差不多把Unity Android的开发过程描述了一遍，如果有不清楚，欢迎留言。

针对手游的性能优化，腾讯WeTest平台的Cube工具提供了基本所有相关指标的检测，为手游进行最高效和准确的测试服务，不断改善玩家的体验。

目前功能还在免费开放中。，欢迎点击链接： http://wetest.qq.com/product/cube 使用。

如果对使用当中有任何疑问，欢迎联系腾讯WeTest企业qq：800024531