感谢使用 Woodpecker!

Woodpecker支持在真机和模拟器iOS9.0, macOS10.11 及以上使用,Objective-C and Swift.

在开始前,您需要导入一个framework到您的项目,它会自己启动并连接Woodpecker客户端,如果您使用真机调试,请确认您的应用和Woodpecker在同一网络内。

如果您正在开发Mac app,请访问Woodpecker for MacOS

1. CocoaPods:

pod 'WoodPeckeriOS', :configurations => ['Debug']

如果需要更新,请使用pod update WoodPeckeriOS

2. Carthage:

binary "https://raw.githubusercontent.com/appwoodpecker/woodpecker-ios/master/WoodPeckeriOS-Carthage.json"


3. 手动集成:

  1. 下载 WoodPeckeriOS.xcframework
  2. 导入 WoodPeckeriOS.xcframework 到您的项目
  3. 仅在Debug模式下使用,请使用动态链接方式


4. 越狱插件:

  1. TSCydia ,选择TSWoodPeckeriOSLoader,支持iOS 12.0+,感谢作者 manajay ,他同时提供了iOS调试工具Lookin和Flex的插件
  2. TinXie’s Repository ,感谢作者 TinXie


可能遇到的问题:

iOS 14设备不能正常使用


iOS 14系统增加了本地网络访问权限开关,请确认您App拥有此权限,如果您使用最新的Xcode 12+构建,请在Info.plist增加下面两项

  1. Privacy - Local Network Usage Description添加本地网络使用描述
  2. Bonjour services列表添加 _adhp._tcp

另外:如果上线时不需要此权限,理论上也不需要单独去删除(只要App没用调用Bonjour, multicast等local network api,是不会弹出权限弹框的)


dyld: Library not loaded: @rpath/WoodPeckeriOS.framework/WoodPeckeriOS Reason: image not found


请参考下图将WoodPeckeriOS.xcframework拖拽到Build Phases -> Embed Framworks中,选中Embed & Sign。



Mac端状态一直是waiting connect,连接不上

  1. 确认App和Mac在同一wifi下
  2. 请确认App集成的WoodPeckeriOS.xcframework版本为最新版
  3. 尝试手动连接Mac客户端,双指长按iOS App界面任意位置弹出连接界面,点击底部搜索找到Mac,然后连接即可
  4. 如果仍然有问题,请点击这里


经常连接到其他人电脑

你可以设置只连接特定的电脑,查看更多设置


您可以下载 demo 立即体验,或者加入 telegram群 QQ群(303015262) 开始讨论