From fc3deabd5d26f44580189f151e12ae9d3c0612e2 Mon Sep 17 00:00:00 2001
From: Horror Proton <107091537+horror-proton@users.noreply.github.com>
Date: Wed, 3 Jan 2024 23:33:11 +0800
Subject: [PATCH] docs: update instruction for waydroid

fix: https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/7701
(cherry picked from commit 8cfb7e0aa9008348e58c2f7ae2c7dacf51972a1b)
---
 docs/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX.md | 4 ++++
 docs/用户手册/模拟器和设备支持/Linux模拟器.md | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/docs/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX.md b/docs/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX.md
index 67737f72c9..18e5fc954a 100644
--- a/docs/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX.md
+++ b/docs/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX.md
@@ -81,6 +81,10 @@ waydroid prop set persist.waydroid.height 720
 
 After restarting, record `IP address` in `Setting` - `About phone` , fill `${IP address}:5555` to the adb IP address in `sample.py` .
 
+If you are using amdgpu, `screencap` command may write messages to stderr, causing image decoding error.
+Run `adb exec-out screencap | xxd | head` to check if there is something like `/vendor/etc/hwdata/amdgpu.ids: No such file...` in the output.
+Modify screencap commands in `resource/config.json` from `adb exec-out screencap` to `adb exec-out 'screencap 2>/dev/null'` as a workaround.
+
 ### ✅ [redroid](https://github.com/remote-android/redroid-doc)
 
 Arknights runs properly in Android 11 image. Do remember to expose port 5555 for adb.
diff --git a/docs/用户手册/模拟器和设备支持/Linux模拟器.md b/docs/用户手册/模拟器和设备支持/Linux模拟器.md
index 13ca0a7b1e..ae5487282c 100644
--- a/docs/用户手册/模拟器和设备支持/Linux模拟器.md
+++ b/docs/用户手册/模拟器和设备支持/Linux模拟器.md
@@ -88,6 +88,10 @@ waydroid prop set persist.waydroid.height 720
 
 设置 adb 的 IP 地址：打开 `设置` - `关于` - `IP地址` ，记录第一个 `IP` ，将 `${记录的IP}:5555` 填入`sample.py` 的 adb IP 一栏。
 
+如果使用 amdgpu, `screencap` 命令可能向 stderr 输出信息导致图片解码失败.
+可以运行 `adb exec-out screencap | xxd | head` 并检查输出中是否有类似 `/vendor/etc/hwdata/amdgpu.ids: No such file...` 的文本来确认这一点.
+尝试将 `resource/config.json` 中的截图命令由 `adb exec-out screencap` 改为 `adb exec-out 'screencap 2>/dev/null'`.
+
 ### ✅ [redroid](https://github.com/remote-android/redroid-doc)
 
 安卓 11 版本的镜像可正常运行游戏, 需要暴露 5555 adb 端口.