一、watcher 是什么
watcher 是一个观察者，它可以检测到设备页面中的变化，比如某个文本/描述/类名等的出现或者改变，然后进行下一步的点击/按钮操作

二、watcher 怎么用
Step.1 注册一个 watcher
d.watcher("WATCHER_NAME").when(text="确认").click(text="确认")
//Same as
d.watcher("WATCHER_NAME").when(text="确认").click()
这句话表示：注册一个名字为 “WATCHER_NAME” 的 watcher，当存在 UiSelector 满足 “text='确认'” 的时候，执行点击操作

d.watcher("WATCHER_NAME2").when(text="OK").when(text="Wait").press("back", "home")
下面这句则表示：注册一个名字为 “WATCHER_NAME2” 的 watcher，当满足两个条件时，依次按 back 与 home 键

Step.2 watcher 注册了，并不代表已经生效，需要手动开启它
开启方法（1）
//enable auto trigger watchers
d.watcher("WATCHER_NAME").watched = True
d.watchers.watched = True
使用这种方法，则会启动所有的观察者，并一直运行在手机后台，在你不想使用它的时候，需要使用 d.watchers.watched = False 手动关闭；
当然，你也可以使用下方的 remove 方法移除某个 watcher，如此它便不会再生效

开启方法（2）
//force to run all registered watchers
d.watcher("WATCHER_NAME").run()
d.watchers.run()
使用 d.watchers.run()，则与方法（1）不同，它是在这条命令执行后启动一次，watcher 结束后便不会再触发

三，总结

1. 查看当前所有 watcher
   d.watchers
   //a list of all registered watchers

2. 从已注册的 watchers 移除某个/全部观察者
   //remove the named watcher
   d.watcher("watcher_name").remove()

//or this way
d.watchers.remove("watcher_name")

//remove all registered watchers
d.watchers.remove()

1. 判断 某个/所有观察者中的某个 是否已经被触发过 d.watcher("watcher_name").triggered //true in case of the specified watcher triggered, else false

d.watchers.triggered
//true in case of any watcher triggered
如果一个 watcher 被触发过，这个信息是被存储在手机后台的，判断当前 watcher 或 watchers 是否触发成功时，需要对上一个存储在后台的监听
使用 d.watcher("watcher_name").reset() 或 d.watchers.reset() 进行状态重置，才能准确获取当前 watcher 或 watchers 的状态

//reset all triggered watchers, after that, d.watchers.triggered will be false.
d.watcher("watcher_name").reset()
d.watchers.reset()

如果你想要这个 watcher 失效，需要执行 d.watchers.watched=False，或者移除 d.watcher("DECLINE").remove()

尊重原著，Watcher 官方文档内容如下：（源自：https://github.com/openatx/uiautomator2）