Appium操控Google TV模拟器启动应用报错求助

环境配置 #

使用Node配置的Appium Capabilities如下：

config.capabilities = [
    {
        platformName: 'Android',
        'appium:deviceName': 'Television_1080p_API_34',
        'appium:platformVersion': '14.0',
        'appium:orientation': 'LANDSCAPE',
        'appium:automationName': 'UiAutomator2',
    },
];

启动应用报错 #

尝试启动com.myapp.androidtv应用时，出现以下错误：

unknown error: An unknown server-side error occurred while processing the command. Original error: Cannot start the 'com.myapp.androidtv' application.
Consider checking the driver's troubleshooting documentation.
Original error: Error executing adbExec. Original error: 'Command '/Users/myname/Library/Android/sdk/platform-tools/adb -P 5037 -s emulator-5554 shell am start -W -S -a android.intent.action.MAIN -c android.intent.category.LAUNCHER -f 0x10200000' exited with code 1';
Command output: Error: Intent matches multiple activities; can't stop: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10200000 }

参考方案添加appActivity配置后：

'appium:appActivity': '.mainActivity',
'appium:appWaitActivity': '.mainActivity',

出现新错误：

Original error: Activity name '.mainActivity' used to start the app doesn't exist or cannot be launched! Make sure it exists and is a launchable activity

当前困境 #

执行adb shell dumpsys window windows | grep -E 'mCurrentFocus|mFocusedApp'命令无输出，无法通过该方式确定正确的Activity名称，但模拟器可正常运行，能看到应用并手动操作。

解决方法 #

1. 从APK包中提取正确的Launchable Activity #

使用Android SDK的aapt工具直接从APK中读取启动Activity信息：

aapt dump badging /path/to/your/com.myapp.androidtv.apk | grep launchable-activity

输出结果会包含完整的Activity路径，例如：launchable-activity: name='com.myapp.androidtv.MainActivity'，复制这个完整名称替换到appActivity配置中。

如果没有aapt，可以用Android Studio的APK Analyzer打开APK文件，查看AndroidManifest.xml里带有<intent-filter>包含android.intent.action.MAIN和android.intent.category.LEANBACK_LAUNCHER（TV应用常用）的Activity。

2. 修正Capabilities配置，使用完整Activity路径+指定包名 #

不要用相对路径.mainActivity，改用从APK中获取的完整Activity名称，并添加appPackage确保精准定位：

config.capabilities = [
    {
        platformName: 'Android',
        'appium:deviceName': 'Television_1080p_API_34',
        'appium:platformVersion': '14.0',
        'appium:orientation': 'LANDSCAPE',
        'appium:automationName': 'UiAutomator2',
        'appium:appPackage': 'com.myapp.androidtv',
        'appium:appActivity': 'com.myapp.androidtv.MainActivity', // 替换为实际完整路径
        'appium:appWaitActivity': 'com.myapp.androidtv.MainActivity'
    },
];

3. 指定TV应用专属的LEANBACK_LAUNCHER Intent #

Google TV应用通常使用android.intent.category.LEANBACK_LAUNCHER而非普通的LAUNCHER，可以在Capabilities中直接配置启动Intent：

config.capabilities = [
    {
        platformName: 'Android',
        'appium:deviceName': 'Television_1080p_API_34',
        'appium:platformVersion': '14.0',
        'appium:orientation': 'LANDSCAPE',
        'appium:automationName': 'UiAutomator2',
        'appium:appIntent': {
            action: 'android.intent.action.MAIN',
            category: 'android.intent.category.LEANBACK_LAUNCHER',
            package: 'com.myapp.androidtv'
        }
    },
];

4. 跳过自动启动，手动启动应用后连接Appium #

如果以上方法都无法确定Activity，可关闭Appium自动启动，手动启动应用后再建立会话：

1. 修改Capabilities添加autoLaunch: false：

config.capabilities = [
    {
        platformName: 'Android',
        'appium:deviceName': 'Television_1080p_API_34',
        'appium:platformVersion': '14.0',
        'appium:orientation': 'LANDSCAPE',
        'appium:automationName': 'UiAutomator2',
        'appium:autoLaunch': false,
        'appium:appPackage': 'com.myapp.androidtv'
    },
];

2. 启动Appium会话后，执行adb命令手动启动应用：

adb -s emulator-5554 shell monkey -p com.myapp.androidtv -c android.intent.category.LEANBACK_LAUNCHER 1

3. 之后即可正常进行Appium测试操作。

内容的提问来源于stack exchange，提问作者ebanster