[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77181":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":16,"starSnapshotCount":16,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},77181,"idb","facebook\u002Fidb","facebook","idb is a flexible command line interface for automating iOS simulators and devices",null,"https:\u002F\u002Fgithub.com\u002Ffacebook\u002Fidb","Swift",5128,496,116,170,0,5,21,56,39.09,false,"main","2026-06-12 02:03:42","![idb logo](website\u002Fstatic\u002Fimg\u002Fidb_logo.jpg)\n\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F770978552698896394?style=flat-square)](https:\u002F\u002Fdiscord.gg\u002FSF26Yqw)\n\nThe \"iOS Development Bridge\" or `idb`, is a command line interface for automating iOS Simulators and Devices. It has three main principles:\n\n* *Remote Automation*: `idb` is composed of a \"companion\" that runs on macOS and a python client that can run anywhere. This enables scenarios such as a \"Device Lab\" within a Data Center or fanning out shards of test executions to a large pool of iOS Simulators.\n* *Simple Primitives*: `idb` exposes granular commands so that sophisticated workflows can be sequenced on top of them. This means you can use `idb` from an IDE or build an automated testing scenario that isn't feasible with default tooling. All of these primitives aim to be consistent across iOS versions and between iOS Simulators and iOS Devices. All the primitives are exposed over a cli, so that it's easy to use for both humans and automation.\n* *Exposing missing functionality*: Xcode has a number of features that aren't available outside its user interface. `idb` leverages many of Private Frameworks that are used by Xcode, so that these features can be in GUI-less automated scenarios.\n\n`idb` is built on top the `FBSimulatorControl` and `FBDeviceControl` macOS Frameworks, contained within this repository. These Frameworks can be used independently of `idb`, however `idb` is likely to provide the simplest install and the most sensible defaults for most users.\n\nWe've given a talk about `idb` at F8, so that you can learn more about what `idb` is and why we built it. A [recording of the talk is available here](https:\u002F\u002Fdevelopers.facebook.com\u002Fvideos\u002F2019\u002Freliable-code-at-scale\u002F).\n\n## Quick Start\n\n`idb` is made up of 2 major components, each of which needs to be installed separately.\n\n### `idb` companion\n\nEach target (simulator\u002Fdevice) will have a companion process attached allowing `idb` to communicate remotely.\n\nThe `idb` companion can be installed via brew or built from [source](https:\u002F\u002Fgithub.com\u002Ffacebook\u002Fidb)\n\n```\nbrew tap facebook\u002Ffb\nbrew install idb-companion\n```\nNote: Instructions on how to install brew can be found [here](https:\u002F\u002Fbrew.sh)\n\n### `idb` client\n\nA cli tool and python client is provided to interact with `idb`.\n\nIt can be installed via pip:\n\n```\npip3.6 install fb-idb\n```\nNote: The idb client requires python 3.6 or greater to be installed.\n\nPlease refer to [fbidb.io](https:\u002F\u002Fwww.fbidb.io\u002F) for detailed installation instructions and a guided tour of idb.\n\nOnce installed, just run the list-targets command which will show you all the simulators installed on your system:\n\n```\n$ idb list-targets\n...\niPhone X | 569C0F94-5D53-40D2-AF8F-F4AA5BAA7D5E | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone Xs | 2A1C6A5A-0C67-46FD-B3F5-3CB42FFB38B5 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone Xs Max | D3CF178F-EF61-4CD3-BB3B-F5ECAD246310 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone Xʀ | 74064851-4B98-473A-8110-225202BB86F6 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\n...\n```\n\n`list-apps` will show you all the apps installed in a simulator:\n\n```\n$ idb list-apps --udid 74064851-4B98-473A-8110-225202BB86F6\ncom.apple.Maps | Maps | system | x86_64 | Not running | Not Debuggable\ncom.apple.MobileSMS | MobileSMS | system | x86_64 | Not running | Not Debuggable\ncom.apple.mobileslideshow | MobileSlideShow | system | x86_64 | Not running | Not Debuggable\ncom.apple.mobilesafari | MobileSafari | system | x86_64 | Not running | Not Debuggable\n```\n\n`launch` will launch an application:\n\n```\n$ idb launch com.apple.mobilesafari\n```\n\nHead over [to the main documentation](https:\u002F\u002Fwww.fbidb.io) for more details on what you can do with idb and the full list of commands. There are also instructions on how to [make changes to `idb` including building it from source](https:\u002F\u002Fwww.fbidb.io\u002Fdocs\u002Fdevelopment).\n\n## Building from Source\n\n### Prerequisites\n\n- **Xcode 14.0+**\n- **XcodeGen**: `brew install xcodegen`\n- **For idb_companion**: protobuf and gRPC Swift plugins\n  ```\n  brew install protobuf swift-protobuf grpc-swift\n  ```\n\n### Building\n\n```bash\n# Build everything (frameworks + idb_companion)\n.\u002Fbuild.sh build\n\n# Build only the frameworks\n.\u002Fbuild.sh build frameworks\n\n# Build only idb_companion\n.\u002Fbuild.sh build idb_companion\n\n# Build a specific framework\n.\u002Fbuild.sh build FBControlCore\n```\n\nThe idb_companion binary will be at `Build\u002FProducts\u002FRelease\u002Fidb_companion`.\n\n### Running Tests\n\n```bash\n# Run all tests\n.\u002Fbuild.sh test\n\n# Test a specific framework\n.\u002Fbuild.sh test FBSimulatorControl\n```\n\n### Regenerating Xcode Projects\n\nThe Xcode project files are generated from `project.yml` using XcodeGen. To regenerate without building:\n\n```bash\n.\u002Fbuild.sh generate\n```\n\n### Build Script Reference\n\n```bash\n.\u002Fbuild.sh help                      # Show all options\n.\u002Fbuild.sh generate                  # Regenerate Xcode projects\n.\u002Fbuild.sh build                     # Build all targets\n.\u002Fbuild.sh build frameworks          # Build all frameworks\n.\u002Fbuild.sh build idb_companion       # Build idb_companion\n.\u002Fbuild.sh build FBControlCore       # Build specific framework\n.\u002Fbuild.sh test                      # Run all tests\n.\u002Fbuild.sh test FBSimulatorControl   # Test specific framework\n```\n\n## Documentation\n\nFind the full documentation for this project at [fbidb.io](https:\u002F\u002Fwww.fbidb.io\u002F)\n\nWe also have a [public Discord Server that you can join](https:\u002F\u002Fdiscord.gg\u002FSF26Yqw)\n\n## Contributing\n\nWe've released `idb` because it's a big part of how we scale iOS automation at Facebook. We hope that others will be able to benefit from the project where they may have needs that aren't currently serviced by the standard Xcode toolchain.\n\n## Code of Conduct\n\nFacebook has adopted a Code of Conduct that we expect project participants to adhere to. Please [read the full text](https:\u002F\u002Fcode.fb.com\u002Fcodeofconduct) so that you can understand what actions will and will not be tolerated.\n\n## Contributing Guide\n\nRead our [contributing guide](.github\u002FCONTRIBUTING.md) to learn about our development process.\n\n## License\n\n[`idb` is MIT-licensed](LICENSE).\n","idb是一个用于自动化iOS模拟器和设备的灵活命令行接口。其核心功能包括远程自动化、简单的原始命令以及暴露Xcode中不可用的功能，支持跨iOS版本和设备类型的一致性操作。通过macOS上的“伴侣”程序与可运行于任何地方的Python客户端配合工作，idb能够实现数据中心内的设备实验室或大规模iOS模拟器测试执行等场景。适用于需要对iOS应用开发过程中的测试、调试进行高度定制化控制的情况，尤其是当标准工具无法满足需求时。基于FBSimulatorControl和FBDeviceControl框架构建，提供了简单安装与合理默认设置。",2,"2026-06-11 03:55:08","trending"]