MaaFramework icon indicating copy to clipboard operation
MaaFramework copied to clipboard

Python集成文档

Open Cassy-Lee opened this issue 1 year ago • 3 comments

期待Python的文档,毕竟python算是最常用的解释语言之一了 话说以后会不会有插件形式的支持?就是启动后通过python、js、lua这样的简单解释语言来添加复杂action和复杂recognition 另外,AdbController似乎有一个用于extras设置的config参数,能不能直接包装成参数,或者直接做成一个拓展(毕竟extras实际上和adb关系不大,并且似乎可以用于点击屏幕)?或者至少json不要套那么多层?

Cassy-Lee avatar Aug 19 '24 21:08 Cassy-Lee

如果单独写文档麻烦,也可以直接用python的文档功能,给每一个类和函数加上详细标注,然后通过某种方式生成或者直接指出可以用pydoc查看

Cassy-Lee avatar Aug 19 '24 21:08 Cassy-Lee

话说以后会不会有插件形式的支持?就是启动后通过python、js、lua这样的简单解释语言来添加复杂action和复杂recognition

目前MaaFw应该是不会计划直接嵌入某一个特定语言的解释器; 现阶段, ExecAgent可以视为一个替代品, 即通过启动指定进程作为自定义任务的载体.

另外,AdbController似乎有一个用于extras设置的config参数,能不能直接包装成参数,或者直接做成一个拓展(毕竟extras实际上和adb关系不大,并且似乎可以用于点击屏幕)?

AdbController的配置中的config参数, 目前用于两个方向;

  • 对于非EmulatorExtra模式, 该部分可以覆盖特定操作的进程命令(例如, 针对某种模拟器, 需要用特殊的进程命令才能连接, 而不是普通的adb connect)
  • 对于EmulatorExtra模式, 该部分提供了模拟器特定的配置参数;
    • 例如, 对于Mumu, 需要通过这个参数来指定目标模拟器的一些信息, 比如多开

通常情况下, 这个参数只需要直接透传从toolkit侧获取的信息即可.

这个不是用于点击屏幕, 而是点击屏幕的命令可以用这个参数进行覆盖替换.

或者至少json不要套那么多层?

没看懂什么套那么多层.

如果单独写文档麻烦,也可以直接用python的文档功能,给每一个类和函数加上详细标注,然后通过某种方式生成或者直接指出可以用pydoc查看

目前文档确实很欠缺, 倒不是某种语言缺失, 主要是目前MaaFw整体逻辑结构比较缺; 各个语言的binding基本还是和C接口保持同步的.

可以看看等一下 #283 (虽然也不一定有用)

neko-para avatar Aug 20 '24 03:08 neko-para

https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/2.2-%E9%9B%86%E6%88%90%E6%8E%A5%E5%8F%A3%E4%B8%80%E8%A7%88.md 算多少有点作用 后续可能会放到 py 源码里 方便开发者直接在 IDE 中查看

weinibuliu avatar Sep 29 '25 13:09 weinibuliu

已经加了

MistEO avatar Nov 27 '25 18:11 MistEO