11 | 如何测试基于Unity3D引擎的游戏

转载：https://airtest.doc.io.netease.com/tutorial/0_automated_testing/

11 | 如何测试基于Unity3D引擎的游戏

由于游戏的界面是通过游戏引擎渲染出来的，游戏界面没有系统原生的控件信息，所以对于游戏，我们需要接入Poco-SDK才能获取到游戏界面中的控件信息。下面以Unity开发的手游为例，介绍如何在Android和iOS平台进行连接。

---

11.1 Android 平台

1. 从Poco SDK Repo将Unity3D这个文件夹克隆下来。 
   

2. 将克隆下来的Unity3D文件夹放置于你的Unity项目的Assets/Scripts文件夹下。 
   

3. 将Assets/Scripts/Unity3D目录下以未用到的UI系统命名的文件夹删除。例：假如您的项目使用的UI系统是UGUI，请将FairyGUI和NGUI两个文件夹删除，保留UGUI文件夹。

4. 在Unity3D中打开您的项目，并将Unity3D/PocoManager.cs作为一个script component添加到您的GameObject中，通常情况下是您的主相机。 举例：点击demo这个场景下的Main Camera，会在右方出现inspector界面，点击inspector界面当中的Add Component。在弹出的对话框中输入Poco，选择出现的Poco Manager这个选项。完成后会在inspector界面出现如图所示的component。

5. 点击界面左上角File->Build Settings, 生成一个合适的安卓包，并安装到您的手机上。 

6. 启动AirtestIDE，按照上文所述将AirtestIDE与您的手机链接，并启动对应的游戏。 

7. 在左下角的Poco辅助窗中选择Unity模式，即可看到当前界面的UI树结构：

8. 在选择Unity模式之后，Airtest IDE会自动插入Poco的初始化代码： 
   
   
   之后的脚本编写，就可以利用Poco提供的API对游戏界面上的元素进行操作了。 
   
   下面是一个简单的测试用例。您可以从这里下载这个简单的Unity3D小游戏。在安装完成后，打开游戏后点击Start再点击drag drop会出现如下所示的界面。每将一颗星星拖动到屏幕中心的贝壳上，将得到20分；如果将5颗星星依次拖动到贝壳上，那将获得100分。下面的脚本就是在测试依次拖动5颗星星是否会得到100分的分数。

from airtest.core.api import *

auto_setup(__file__)

from poco.drivers.unity3d import UnityPoco
poco = UnityPoco()

poco('btn_start').click()
time.sleep(1.5)


poco('drag_and_drop').click()

shell = poco('shell').focus('center')
for star in poco('plays').offspring('star'):
    star.drag_to(shell)
time.sleep(1)

assert poco('scoreVal').get_text() == "100", "score correct."
poco('btn_back', type='Button').click()

点击运行脚本按钮，就会得到如下所示的结果。

---

11.2 iOS平台

1. 同样的，先完成引擎SDK接入，然后通过Airtest IDE连接iOS手机； 
   
   

2. 与Android不同的是，iOS Unity Poco的连接需要启动两个proxy，8100端口用于连接iOS手机，5001端口用于连接Poco-SDK的RPC端口。

iproxy 8100 8100
iproxy 5001 5001

这里的iproxy相当于ADB中的forward。 

3. 连接好iOS手机之后，选择Poco辅助窗中的Unity模式，即可看到当前界面的UI树结构：

4. 之后即可通过Poco提供的API，对iOS上的游戏编写自动化测试脚本了。