Skip to content

CKAndroidProject/AndroidSurfaceImgui

 
 

Repository files navigation

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。

编译

  1. 确保在项目根目录打开命令行终端 。
  2. 执行git submodule init
  3. 执行git submodule update
  4. 执行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}替换成你想要编译出的目标平台。
  5. 执行cmake --build build --config Release
  6. 编译完成。

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

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

使用

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

RPC使用

  1. Server:src/test-ui/canvas.cc
  2. Client:src/test-ui/render.cc
screenshot.webm

TODO

  • 重构ANativeWindowCreator.h使得逻辑更加清晰,目前所有版本的兼容实现都挤在一起导致代码和日志都难以阅读(一坨)。
  • 设计一个宏用来更清晰的按版本路径调用对应的API。
  • 整理一下AndroidPC(Windows)上的远程绘制Demo。

特别鸣谢赞助

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

谢谢大家的支持!❤️

About

Example for Android Dear ImGui, support the remote draw.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 95.9%
  • CMake 2.1%
  • Batchfile 1.6%
  • C 0.4%