AzurLaneAutoScript/doc/Installation_cn.md

傻瓜式安装教程

下面讲述如何使用傻瓜式安装包, 安装 Alas

1. 下载 傻瓜式安装包

   点击 这里 , 找到最新的傻瓜式安装包

   下载 AzurLaneAutoScript.zip, 不要下载 Source code.

   

2. 解压 解压到目录, 比如解压到 D:\AzurLaneAutoScript

   你会看到有一个名为 toolkit 的目录, 和一个名为 Easy_Install-V2.bat 的批处理文件

   

3. 右键 Easy_Install-V2.bat, 选择"以管理员身份运行"

   当看到这些提示时, 说明已经获取到管理员权限, 按下回车键继续

   

   这下面这个界面, 你需要启动你的模拟器

   

   准备完成后, 输入start, 然后按下回车键

   当看到如下信息时, 说明安装成功

   

   再次按下回车, 就会回到标题界面

   然后你就可以关掉这个窗口了

4. 运行 alas.bat

   在安装完成后, 你会看到刚才的目录下多出很多文件和文件夹

   

   现在右键点击 alas.bat, 选择 "以管理员身份运行"

   你将会看到一个黑色的命令行窗口

   

   在第一次运行的时候, 要求输入模拟器的SERIAL

   以下是一些常见模拟器的默认SERIAL

   模拟器	Emulator	serial
   蓝叠模拟器	BlueStacks	127.0.0.1:5555
   夜神模拟器	NoxPlayer	127.0.0.1:62001
   MuMu模拟器	MuMuPlayer	127.0.0.1:7555
   逍遥模拟器	MemuPlayer	127.0.0.1:21503
   雷电模拟器	LDPlayer	emulator-5554

   输入完成后, 按下回车

   你会看到一些一闪而过的信息

   

   接下来, 进入到主界面

   

   按下数字2, 也就是选择国服, 然后回车

   然后 Alas 的 GUI 就出来了

   

傻瓜式更新教程

右键点击 alas.bat, 选择 "以管理员身份运行", 进入 Alas.bat 的主界面.

按下数字4, 也就是更新, 再按下回车键, 进入到选择界面

国内用户按下数字键4, 选择从gitee镜像更新, 有能力的可以选择从github更新

然后按下回车键

看到以下信息时, 说明更新完成

再次按下回车, 就会回到标题界面

然后你就可以关掉这个窗口了

高级用户安装教程

这里的高级用户, 指对python有一定了解, 能使用搜索引擎独立解决问题的人.

傻瓜式安装包里有什么?

WinPython Winpython64-3.7.6.0dot 预安装的 requirements PortableGit Easy_Install-V2.bat, 用来执行 git pull

• Clone 本项目

创建虚拟环境

虚拟环境中的 python 版本必须为 3.7.6

激活虚拟环境, 并安装依赖

pip install -r requirements.txt

安装模拟器

设备	Device	模拟器版本	安卓版本	adb截图	u2截图	adb点击	u2点击
逍遥模拟器	MemuPlayer	7.1.3	5.1.1	0.308	0.275	0.294	0.146
雷电模拟器	LDPlayer	3.83	5.1.1	0.329	0.313	0.291	0.146
夜神模拟器	NoxPlayer	6.6.0.0	5.1.1	0.339	0.313	0.505	0.141
MuMu模拟器	MuMuPlayer	2.3.1.0	6.0.1	0.368	0.701	0.358	0.148
一加5	Oneplus5		7.1.1	1.211	0.285	0.447	0.160

这里给出了一些常见模拟器的性能测试结果, 测试平台 Windows 10, I7-8700k, 1080ti, nvme SSD, 模拟器分辨率1280x720, 碧蓝航线 60帧开启, 进入地图 7-2, 执行100次取平均, 单位秒.

2020.06, 对 aScreenCap 和 蓝叠模拟器(BlueStacks) 追加测试.

设备	Device	模拟器版本	安卓版本	aScreenCap截图	adb截图	u2截图	adb点击	u2点击
夜神模拟器	NoxPlayer	6.6.0.0	5.1.1	0.242	0.408	0.368	0.532	0.142
蓝叠模拟器(台湾)	BlueStacks (TW)	4.205.0.1006	5.1.1	0.129	0.280	0.458	0.234	0.151

结论

推荐使用 蓝叠模拟器国际版

推荐使用 aScreenCap 截图, uiautomator2点击

由于海图识别模块对截图质量有很高的要求, AzurLaneAutoScript 暂时不支持手机, 必须使用模拟器. (Alas其实是支持手机的, 远古版本的Alas也是在手机上测试的, 但是长时间运行会发热和假死, 就放弃了)

• 安装一款安卓模拟器
• 模拟器分辨率设置为 1280x720 .

配置ADB

• 获取 ADB

• 将ADB配置于系统的环境变量中, 并测试是否配置成功.

adb devices

安装 uiautomator2

uiautomator2, 是一个自动化测试的库, 可以加快截图和点击的速度. AzurLaneAutoScript 也可以使用ADB来执行截图和点击, 就是慢一点而已.

• 执行

python -m uiautomator2 init

这会在所有连接的设备上安装 uiautomator-server , atx-agent, minicap, minitouch . 如果设备是模拟器, uiautomator2 将跳过 minicap 的安装.

• 检查 uiautomator2 是否安装成功

  修改 module.dev_tools 下的 emulator_test.py 中的 SERIAL, 并在虚拟环境下执行

  python -m dev_tools.emulator_test
  

  一些模拟器的默认 serial:

  设备	Emulator	serial
  蓝叠模拟器	BlueStacks	127.0.0.1:5555
  夜神模拟器	NoxPlayer	127.0.0.1:62001
  MuMu模拟器	MuMuPlayer	127.0.0.1:7555
  逍遥模拟器	MemuPlayer	127.0.0.1:21503
  雷电模拟器	LDPlayer	emulator-5554

启动

• 快捷方式运行

  右键点击 alas.pyw, 创建快捷方式

  右键点击刚刚创建快捷方式, 点击属性, 将目标 更改为

  "<你的虚拟环境的绝对路径>\pythonw.exe" "<你的Alas安装目录的绝对路径>\alas_cn.pyw"
  

  点击 确定

  现在, 你可以把这个快捷方式移动到任意地方, 比如桌面

  这个启动方式是最好的, 不会像使用alas.bat那样出现命令行窗口, 双击即可运行

  但是如果 GUI 启动中出现错误, 不会出现任何窗口, 也不会有任何报错信息

• 多开运行

  复制 alas.pyw, 并重命名. 首次运行时会复制template.ini的设置. 脚本运行时会使用同名的ini配置文件.

  比如, 将alas.pyw复制为alas2.pyw, 创建快捷方式运行, 在运行时就会使用config\alas2.ini

• 其他运行方式 (不推荐)

  • 通过命令行运行. 虽然alas使用了 Gooey, 一个将命令行转为GUI的库, 但是Alas并不是先有命令行方法运行再用gooey的, Alas是为了使用gooey快速编写GUI而去拼凑命令行参数的. 因此使用命令行会很难受.
  • 修改配置文件 config/alas.ini , 在 alas.py 中调用相关函数