AndroidSurfaceImgui

介绍

• 支持RPC进行多进程/远程绘制。
• 支持鼠标滚轮
• 支持物理键盘输入
• 支持横/竖屏自动切换
• 支持防录屏

在Android使用上API创建Surface并进行Dear ImGui的绘制。

注意：如果拥有Surface的进程的用户权限在shell之下，则你的Surface不会被系统添加到根视图，也就是不会显示出来，详情请看：SurfaceFlinger.cpp

支持系统版本

仅标注大版本，小版本没特别说明的都是支持的。

| 古董版本 | 过渡版本 | 中间版本 | 新版本 | | ------------ | ----------- | ------------ | ------------ | | ✅ Android5 | ✅ Android8 | ✅ Android9 | ✅ Android12 | | ✅ Android6 | | ✅ Android10 | ✅ Android13 | | ✅ Android7 | | ✅ Android11 | ✅ Android14 | | | | | ✅ Android15 | | | | | ✅ Android16 |

目前所有版本都能正常被录屏，如果有发现不兼容的版本请提交 issue。

编译

0. 确保在项目根目录打开命令行终端 。
1. 执行git submodule init 。
2. 执行git submodule update 。
3. 执行cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=${NDK_PATH}build/cmake/android.toolchain.cmake -DANDROID_PLATFORM=android-23 -DANDROID_ABI=${PLATFORM} -S . -B build -G Ninja，其中${NDK_PATH}需要替换为你的NDK路径，${PLATFORM}替换成你想要编译出的目标平台。
4. 执行cmake --build build --config Release。
5. 编译完成。

你也可以直接使用build.bat来进行批量编译，默认编译armeabi-v7a arm64-v8a x86 x86_64四个版本，可修改脚本中的ANDROID_ABIS变量来进行更改。

脚本有三个可选参数分别为：NDK路径、最低支持SDK版本、CMake程序路径，不设置则脚本自动检测NDK_PATH与CMake工具链，如果都没有则使用脚本默认内置路径。

使用

例子请看：src/test-ui/main.cc

<img src="https://github.com/Bzi-Han/AndroidSurfaceImgui/blob/main/screenshot.jpg" height="500px" />

RPC使用

1. Server：src/test-ui/canvas.cc
2. Client：src/test-ui/render.cc

screenshot.webm

TODO

• [ ] 重构 AImGui 与 ATouchEvent，完全分离事件处理逻辑并规范导入与 include_directories。
• [ ] 整理一下Android在PC(Windows)上的远程绘制Demo。

特别鸣谢赞助

感谢以下赞助者对本项目的支持(不分先后)：

• 不解释
• barry-ran

谢谢大家的支持！❤️