Package: fb-idb
The "iOS Development Bridge" oridb, is a command line interface for automating iOS Simulators and Devices. It has three main priniciples:Remote Automation:idbis 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.Simple Primitives:idbexposes granular commands so that sophisticated workflows can be sequenced on top of them. This means you can useidbfrom 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 easy to use for both humans and automation.Exposing missing functionality: Xcode has a number of features that aren't available outside it's user interface.idbleverages many of Private Frameworks that are used by Xcode, so that these features can be in GUI-less automated scenarios.idbis built on top theFBSimulatorControlandFBDeviceControlmacOS Frameworks, contained within this repository. These Frameworks can be used independently ofidb, howeveridbis likely to provide the simplest install and the most sensible defaults for most users.We've given a talk aboutidbat F8, so that you can learn more about whatidbis and why we built it. Arecording of the talk is available here.Quick Startidbis made up of 2 major components, each of which needs to be installed separately.idbcompanionEach target (simulator/device) will have a companion process attached allowingidbto communicate remotely.Theidbcompanion can be installed via brew or built fromsourcebrew tap facebook/fb
brew install idb-companionNote: Instructions on how to install brew can be foundhereidbclientA cli tool and python client is provided to interact withidb.It can be installed via pip:pip3.6 install fb-idbNote: The idb client requires python 3.6 or greater to be installed.Please refer tofbidb.iofor detailed installation instructions and a guided tour of idb.Once installed, just run the list-targets command which will show you all the simulators installed on your system:$ idb list-targets
...
iPhone X | 569C0F94-5D53-40D2-AF8F-F4AA5BAA7D5E | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected
iPhone Xs | 2A1C6A5A-0C67-46FD-B3F5-3CB42FFB38B5 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected
iPhone Xs Max | D3CF178F-EF61-4CD3-BB3B-F5ECAD246310 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected
iPhone Xʀ | 74064851-4B98-473A-8110-225202BB86F6 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected
...list-appswill show you all the apps installed in a simulator:$ idb list-apps --udid 74064851-4B98-473A-8110-225202BB86F6
com.apple.Maps | Maps | system | x86_64 | Not running | Not Debuggable
com.apple.MobileSMS | MobileSMS | system | x86_64 | Not running | Not Debuggable
com.apple.mobileslideshow | MobileSlideShow | system | x86_64 | Not running | Not Debuggable
com.apple.mobilesafari | MobileSafari | system | x86_64 | Not running | Not Debuggablelaunchwill launch an application:$ idb launch com.apple.mobilesafariHead overto the main documentationfor more details on what you can do with idb and the full list of commands. There are also instructions on how tomake changes toidbincluding building it from source.DocumentationFind the full documentation for this project atfbidb.ioWe also have apublic Discord Server that you can joinContributingWe've releasedidbbecause 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.Code of ConductFacebook has adopted a Code of Conduct that we expect project participants to adhere to. Pleaseread the full textso that you can understand what actions will and will not be tolerated.Contributing GuideRead ourcontributing guideto learn about our development process.Licenseidbis MIT-licensed.