mobile: pushFile doesn't escape paths of parent directories.

[jesse-r-s-hines]

The mobile: pushFile command automatically creates parent directories if they don't exist, which normally works fine. However if the parent directory contains a space, it isn't escaped causing errors like

[0-0] 2025-07-05T19:39:54.050Z ERROR webdriver: WebDriverError: An unknown server-side error occurred while processing the command. Original error: Error executing adbExec. Original error: 'Command '/home/jesse/Android/Sdk/platform-tools/adb -P 5037 -s emulator-5554 shell mkdir -p '/storage/emulated/0/Documents/my folder'' exited with code 1'; Command output: mkdir: 'folder': Read-only file system

If the file basename contains a space it works fine, it only if the parent directory contains a space.

Example to reproduce:

browser.execute("mobile: pushFile", {
    remotePath: "/storage/emulated/0/Documents/my folder/foo.txt",
    payload: "SEVMTE8=",
})

[mykola-mokhnach]

appium/appium-adb#807 should do the job

[jesse-r-s-hines]

Thanks! It seems that any special characters, not just space, can cause issues:

browser.execute("mobile: pushFile", {
    remotePath: "/storage/emulated/0/Documents/foo;bar/baz.txt,
    payload: "SEVMTE8=",
})

Fails with

[0-0] 2025-07-06T13:55:12.913Z INFO webdriver: [POST] http://127.0.0.1:4723/session/b618b944-2c39-40f7-a61d-6304f77cff18/execute/sync
[0-0] 2025-07-06T13:55:12.913Z INFO webdriver: DATA {
[0-0]   script: 'mobile: pushFile',
[0-0]   args: [
[0-0]     {
[0-0]       remotePath: '/storage/emulated/0/Documents/foo;bar/baz.txt',
[0-0]       payload: 'SEVMTE8='
[0-0]     }
[0-0]   ]
[0-0] }
[0-0] 2025-07-06T13:55:12.969Z ERROR webdriver: WebDriverError: An unknown server-side error occurred while processing the command. Original error: Error executing adbExec. Original error: 'Command '/home/jesse/Android/Sdk/platform-tools/adb -P 5037 -s emulator-5554 shell mkdir -p /storage/emulated/0/Documents/foo\;bar' exited with code 127'; Command output: /system/bin/sh: bar: inaccessible or not found
[0-0]  when running "execute/sync" with method "POST" and args "mobile: pushFile"

[mykola-mokhnach]

The patch should be present in UIA2 driver v 4.2.5+

[jesse-r-s-hines]

Thanks! Spaces work now, but other special shell characters are still causing errors, e.g.

browser.execute("mobile: pushFile", {
    remotePath: "/storage/emulated/0/Documents/foo;bar/baz.txt",
    payload: "SEVMTE8=",
});

[0-0] 2025-07-06T23:51:00.043Z INFO webdriver: [POST] http://127.0.0.1:4723/session/88b834ca-285f-4a48-8b23-b0301caff90d/execute/sync
[0-0] 2025-07-06T23:51:00.043Z INFO webdriver: DATA {
[0-0]   script: 'mobile: pushFile',
[0-0]   args: [
[0-0]     {
[0-0]       remotePath: '/storage/emulated/0/Documents/foo;bar/baz.txt',
[0-0]       payload: 'SEVMTE8='
[0-0]     }
[0-0]   ]
[0-0] }
[0-0] 2025-07-06T23:51:00.067Z ERROR webdriver: WebDriverError: An unknown server-side error occurred while processing the command. Original error: Error executing adbExec. Original error: 'Command '/home/jesse/Android/Sdk/platform-tools/adb -P 5037 -s emulator-5554 shell mkdir -p /storage/emulated/0/Documents/foo\;bar' exited with code 127'; Command output: /system/bin/sh: bar: inaccessible or not found
[0-0]  when running "execute/sync" with method "POST" and args "mobile: pushFile"