{"id":13616500,"url":"https://github.com/xing/calabash-launcher","last_synced_at":"2025-06-23T18:05:22.335Z","repository":{"id":25895934,"uuid":"106830902","full_name":"xing/calabash-launcher","owner":"xing","description":"iOS Calabash Launcher is a macOS app that helps you run and manage Calabash tests on your Mac.","archived":false,"fork":false,"pushed_at":"2024-08-02T12:52:18.000Z","size":2873,"stargazers_count":30,"open_issues_count":37,"forks_count":6,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-14T09:21:18.466Z","etag":null,"topics":["calabash","calabash-ios","integration-tests","ios","mobile-automation","swift","tests","xcode"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xing.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-13T13:55:01.000Z","updated_at":"2024-08-21T08:59:45.000Z","dependencies_parsed_at":"2024-11-08T00:32:30.032Z","dependency_job_id":"0fd07d86-e4b6-4e1c-9db3-349dbc212ad6","html_url":"https://github.com/xing/calabash-launcher","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/xing/calabash-launcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xing%2Fcalabash-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xing%2Fcalabash-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xing%2Fcalabash-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xing%2Fcalabash-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xing","download_url":"https://codeload.github.com/xing/calabash-launcher/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xing%2Fcalabash-launcher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261528653,"owners_count":23172749,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calabash","calabash-ios","integration-tests","ios","mobile-automation","swift","tests","xcode"],"created_at":"2024-08-01T20:01:29.383Z","updated_at":"2025-06-23T18:05:22.309Z","avatar_url":"https://github.com/xing.png","language":"Swift","funding_links":[],"categories":["HarmonyOS","Applications","Development"],"sub_categories":["Windows Manager","Development","iOS / macOS","👨‍💻 Development (9)"],"readme":"# Calabash Launcher\n\nCalabash Launcher is a macOS app that helps you run and manage Calabash iOS tests on your Mac.\n- Instead of having to run and configure test runs in console, you can use a simple user interface which helps you to pick up needed devices, languages, tags, builds and other parameters.\n- Instead of having to search elements by quering view hierarchy again and again, you can click on the element under search and get its class name, accessibility label and/or accessibility id.\n\n## Test Runner\n\nThe Test Runner runs tests on a variety of configurations. It supports:\n\n- Running tests on a simulator\n- Running tests on a physical device\n- Running tests in different languages\n- Test tags\n- Console output\n\n## Element Inspector\n\nWith the Element Inspector you can inspect your apps view hierarchy to get elements query strings in hierarchy tree representation.\n\nIt supports:\n\n- Device element highlighting\n- Accessing an element's address\n- Accessing an element's localized object (by reading all .strings and .json files in the project)\n- The visual representation of the device\n\n## Project Status\n\nThis project is under active development, and it is heavily used at [XING SE](https://xing.com).\n\n## Prerequisites\nIn order to run the application you have to make sure that your machine meets the following requirements.\n\n- MacOS Sierra or newer\n- Xcode 9.0 or newer\n- iOS Simulators \u003e= 10.1\n- Ruby \u003e= 2.2.0 (2.3.1 is preferred)\n- `bundler` \u003e= 1.15.0\n- `calabash-ios` \u003e= 0.20.5\n\n## Xcode Configuration\n\nAfter you have cloned the project to your mac, open the project in Xcode. Before you start to build the project you need to add a developer team to the project. Use your Apple ID to sign in and to create a personal team.\n\n![XCode - Adding a developer team](https://user-images.githubusercontent.com/4619244/32549703-b6356bfc-c48a-11e7-92f0-1e24a985f0dd.png)\n\nOnce the team is added, hit the build button and the calabash launcher will start in a few seconds.\n\n## Using the Test Runner\n\nWhen opening Calabash Launcher the first time, it will ask you to give the path to the repository with your Calabash tests and (optionally) your Cucumber profile.\n\n![Calabash Launcher Setup](https://user-images.githubusercontent.com/18147900/32609402-e9b05aa2-c55f-11e7-99d6-c2c1b5b8195d.png)\n\nProvide the required data and press save. After a restart of the Calabash Launcher, you will be able to configure your testrun by choosing a simulator, the language and the Cucumber tag to execute.\n\n![Test Runner](https://user-images.githubusercontent.com/18147900/34467506-8ca05b50-eef4-11e7-9ca0-1373ba7ddd19.png)\n#### Running on physical devices\n\nTo run tests on physical devices, the device's IP and app's bundle ID should be provided in the `device configuration` dialog:\n\n\u003cimg width=\"586\" alt=\"screen shot 2017-11-11 at 23 55 00\" src=\"https://user-images.githubusercontent.com/18147900/32694248-d8c2d7c8-c73b-11e7-8803-81590d61fbf9.png\"\u003e\n\n\n## Using the Element Inspector\n\n⚠️ **Currently the Element Inspector is limited to iPhone 6, iPhone 7 and iPhone 8. Please make sure that one of these devices is launched when you search for elements.** ⚠️\n\n![Element Inspector](https://user-images.githubusercontent.com/18147900/32503133-c04ee05e-c3dc-11e7-8394-3c0eb5b0105b.gif)\n\n- Clicking on the right window in the view will sync the Inspector with the simulator (and it will be automatically synced every 5 seconds)\n- Clicking on an element in the synchronised window will show the element's `class`, `accessibility id` and `accessibility label`.\n- Clicking on a nested menu of an element will show you the element hierarchy.\n\n## Troubleshooting\n\n- Calabash Launcher will not work if you cannot run `bundle exec calabash-ios console` from your terminal.\nSometimes the problem could live in the Ruby installation and/or conflicts with `readline`. To fix the problem, please re-install Ruby.\n- You can reset Calabash Launcher's settings via the `Reset to Defaults Settings` menu item.\n\n## Contributing\nWant to help improving Calabash Launcher? We could really use your help!\n\nOpen source isn't just writing code. You can help by doing any of the following:\n\n- Reporting bugs\n- Reviewing pull requests\n- Bringing ideas for the new features\n- Answering questions on issues\n- Documentation improvements\n- Fixing bugs\n- Adding new features\n\nThis project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant code](http://contributor-covenant.org/) of conduct.\n\n## License\n\nCalabash Launcher is released under an MIT license. See [LICENSE](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxing%2Fcalabash-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxing%2Fcalabash-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxing%2Fcalabash-launcher/lists"}