【Unity游戏开发】Android中如何集成Unity3D项目——入门级踩坑

最近的学习之路真的是波折，先是想学Kotlin，结果赶上了算法比赛，恶补了几天算法，然后回归Kotlin，这周又需要调研一下Unity3D，需要把Unity项目嵌入到我们的Android项目中。
今天，就在今天，老子经过3天的折磨终于把demo跑起来了，此刻的心情真的是比发工资都爽，这可能就是学习的乐趣吧，期间遇到了无数多的问题，再加上关于Android中集成Unity项目的文档也没有帮我解决这些问题，所以总结一下吧，以后复习，也相当于帮以后有这方面需求的人踩雷了吧。我们话不多说开始了。

涉及到的IDE

• Android studio 4.0.2版本
• UnityHub 2.4.3版本
• Unity 2019.4.14版本

环境配置

Android Studio环境配置

这个相信Android开发应该熟悉的不能再熟悉了，网上教程也有很多，在这里面就不赘述了，如果有什么问题可以私信我（建议大家还是通过自己上网查询解决）

UnityHub

先说一下Unity Hub在这里面的作用吧

Unity Hub 它是Unity官方提供的工具，作用的话就是帮助我们管理Unity，以及项目啊，还有一些其他的配置，为什么会把它提出来呢，事情是这个样子的
话说，那是一个月黑风高的日子（咳咳，跑题了）。。。UnityHub可以协助我们再下载Unity的时候顺便将相关联的环境也都下载下来，如Android相关的SDK, NDK等。这样就省去了我们自己下载的遍历，当然虽然之前你可能也有了这个环境，但是我还要建议你去勾选下载对应的版本。
举个例子 Unity2020稳定版本，要求NDK的版本是19.0.5232133版本，反正这个版本我是找了半天都没找到，官网都没有，很是奇葩，所以为了别像我一样浪费时间还是乖乖按照我说的直接通过Hub下载吧

Unity

• 登录Unity官网下载UnityHub
• 安装之后打开Hub
• 通过下边的步骤进行安装想要的版本（建议新手选择跟我一样的版本吧，Unity各版本之间界面和相关设置都有差别，对新手不友好）
  
• 随后一直下一步就可以了（注意，这个过程别忘了勾选上Android环境的 SDK和NDK）
• 等待安装完成即可。

现在万事俱备，准备开始吧

集成步骤

1. Unity中导出项目
2. Android Studio中引入Unity项目

Unity中导出项目

确认JDK，SDK，NDK配置

打开路径：菜单栏Edit -> Preferences… -> External Tools

如果按照我说的从Hub直接下载的SDK和NDK直接勾选上SDK和NDK选项就可以了，如果不是的话就指向本机上的SDK和NDK路径即可，

注意，如果SDK和NDK版本不对可能会报错

切换Android平台

打开路径：菜单栏File -> Build Settings

• 左侧Platform选中Android（我这个已经切换到Android了）
• 点击右下角的Switch Platform切换平台
• 等待切换进度条走完即可
• 切换之后的界面应该跟下边的图片一致（版本不同可能有偏差）
  

配置导出的项目

这一步相当关键，我就在这一步骤上卡了好久

• 勾选Export Project
• 点击Platform Settings
  
• 选择Android 配置中的Other Settings
  
• 填写Package Name （与Android中的包名保持一致）
• Mininum API Level：最小支持版本，根据实际情况填写即可，建议与图中一致
• Scripting Backend： 选择图中的IL2CPP，如果不选择会报Tombstone问题，非常棘手
• Target Architectures 选择项目支持的CPU, 将ARM64勾选，v7默认会勾选

• 一切准备妥当，关闭Platform Setttings，返回到Build Settings，点击Export按钮，选择你想要把导出项目放到的文件夹即可。
  
• 等待进度条结束即可。

Unity项目结构介绍

• Launcher 里面包含一些界面相关的东西，本次演示用不上
• unityLibrary 这个是本次引入的重点，重点讲解 unityLibrary结构如下
  
• libs 其中包括了一个jar包
• src中包含了我们需要引入的so以及我们需要继承的Activity
• jniLibs:里面的arm64-v8a包含了我们需要引入的so文件，如果没有该文件，你需要回头看一下是否 哪一步错误了。没有 so文件，会crash。
  
• 我们需要继承的Unity相关的Activity——UnitPlayerActivity.java
  

Android Studio中引入Unity项目

创建Android项目

与正常Android项目没有区别，不再描述，不会的可以自行查询或者私信我

创建Unity相关的Module

• 在项目中切换到project视图，然后右键点击，创建新的Module
  

• 选择 Import Gradle Project

• 点击Next
  

• 选择导入项目的文件夹，选择到之前说的unityLibrary 层级即可，点击finish完成导入。

• 在主项目app下的build.gradle中添加主Module对unity的依赖

dependencies {
    ...
    // 添加下方代码
	implementation project(':unityLibrary')
	implementation fileTree(dir: project(':unityLibrary').getProjectDir().toString() + ('\\libs'), include: ['*.jar'])
}

• 同步Android项目
  两种方式：

  • 修改了gradle文件，会在上方提示让你同步，点击同步即可
    

  • 菜单栏点击同步
    

编写跳转到Unity界面的逻辑

在主界面创建一个按钮，点击按钮跳转到继承于上述说的UnityPlayerActivity.java即可。

• 主界面 MainActivity.java

package com.example.hellounity;

import androidx.appcompat.app.AppCompatActivity;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button unity = findViewById(R.id.go_unity);
        unity.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Intent intent = new Intent(MainActivity.this, SecondActivity.class);
                startActivity(intent);
            }
        });
    }
}

• MainActivity的xml文件

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/go_unity"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Go Unity"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

• 实现了Unity的Activity——SecondActivity.java

package com.example.hellounity;

import com.unity3d.player.UnityPlayerActivity;

public class SecondActivity extends UnityPlayerActivity {
	// 是的 什么也没有实现，继承就完事儿了，跑通了其他的逻辑就简单了。
}

大功告成!!!

运行，项目没有问题，但是桌面会出现两个图标，这个只需要把UnityLibrary中的AndroidManifest中的Launch去掉就可以了

本来以为这周这个任务完成不了了呢，下午居然成功了，开心，快乐，愉快滴过周末了，祝大家周末愉快，所有bug都不是你的问题！

淦就完事儿了。我是张诺然。