AzurLaneAutoScript 渠道服启动问题分析与解决方案

问题背景

近期，AzurLaneAutoScript（简称ALAS）用户反馈多个渠道服（包括应用宝、华为、4399等）出现无法正常启动游戏的问题。该问题表现为ALAS在执行重启设置后，持续输出"[Device Orientation] 0 (Normal)"日志但无法启动游戏，最终陷入死循环。

问题现象分析

通过用户反馈的日志和截图，可以观察到以下关键现象：

1. ALAS能够正常检测到模拟器设备并建立连接
2. 游戏包名识别正确（如com.tencent.tmgp.bilibili.blhx）
3. 系统检测到当前运行的是安卓启动器（com.android.launcher3）而非游戏
4. 重启任务启动游戏后，游戏进程并未真正运行

根本原因

经过技术分析，该问题的根本原因是：

游戏开发商在最新版本中修改了渠道服的Activity启动入口，从原来的"MainActivity"变更为"PrePermissionActivity"。而ALAS的默认配置仍使用旧版Activity名称，导致无法正确启动游戏。

解决方案

方法一：修改配置文件

1. 首先修改部署配置文件：

   • 打开/config/deploy.yaml
   • 找到第30行KeepLocalChanges: false
   • 修改为KeepLocalChanges: true

2. 然后修改服务器配置：

   • 打开/module/config/server.py
   • 找到DICT_PACKAGE_TO_ACTIVITY字典
   • 将对应渠道服的Activity名称从"MainActivity"改为"PrePermissionActivity"

   例如：

   • 华为服修改为：'com.bilibili.blhx.huawei': 'com.manjuu.azurlane.PrePermissionActivity'
   • 应用宝服修改为：'com.tencent.tmgp.bilibili.blhx': 'com.manjuu.azurlane.PrePermissionActivity'

方法二：等待官方更新

开发团队已经注意到此问题，预计会在后续版本中修复。用户可以关注项目更新，及时升级到最新版本。

技术细节说明

1. KeepLocalChanges参数：该参数控制ALAS是否保留本地修改。默认值为false会导致每次启动时覆盖本地修改，因此需要先将其设为true才能永久保存配置变更。

2. Activity机制：在Android系统中，Activity是应用的基本组成单元。游戏启动时需要指定正确的Activity名称才能成功启动。

3. 渠道服差异：不同渠道服可能使用不同的包名和Activity名称，需要针对各自渠道进行特定配置。

验证与测试

多位用户反馈该解决方案有效：

• 华为渠道服用户确认修改后问题解决
• 应用宝服用户测试通过
• 4399渠道服用户验证可行
• 360渠道服同样适用

注意事项

1. 修改配置文件前建议备份原文件
2. 确保ALAS完全关闭后再进行修改
3. 不同渠道服需要修改对应的包名配置
4. 如果问题仍然存在，可以尝试重启模拟器

总结

本文分析了ALAS渠道服启动失败的技术原因，并提供了详细的解决方案。该问题源于游戏启动入口变更，通过修改配置文件中Activity名称即可解决。建议用户按照指导步骤操作，或等待官方发布包含此修复的更新版本。

对于技术爱好者，理解Android应用的Activity机制和ALAS的配置管理方式，有助于更好地使用和维护自动化脚本工具。