{"id":25236719,"url":"https://github.com/swiftlang/swift-build","last_synced_at":"2026-04-15T00:02:10.883Z","repository":{"id":275308663,"uuid":"923737552","full_name":"swiftlang/swift-build","owner":"swiftlang","description":"A high-level build system based on llbuild, used by Xcode, Swift Playground, and the Swift Package Manager","archived":false,"fork":false,"pushed_at":"2026-04-12T00:10:14.000Z","size":15090,"stargazers_count":2198,"open_issues_count":111,"forks_count":165,"subscribers_count":97,"default_branch":"main","last_synced_at":"2026-04-12T02:20:52.683Z","etag":null,"topics":["build","build-system","build-tool","build-tools","swift","swift-package-manager"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/swiftlang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-28T18:53:28.000Z","updated_at":"2026-04-12T00:10:26.000Z","dependencies_parsed_at":"2025-05-29T20:21:36.255Z","dependency_job_id":"8aa3119c-1f25-4b94-a402-b79d0de3539c","html_url":"https://github.com/swiftlang/swift-build","commit_stats":null,"previous_names":["swiftlang/swift-build"],"tags_count":190,"template":false,"template_full_name":null,"purl":"pkg:github/swiftlang/swift-build","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swiftlang","download_url":"https://codeload.github.com/swiftlang/swift-build/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-build/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31820369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["build","build-system","build-tool","build-tools","swift","swift-package-manager"],"created_at":"2025-02-11T15:03:09.495Z","updated_at":"2026-04-15T00:02:10.837Z","avatar_url":"https://github.com/swiftlang.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"Swift Build\n=======\n\nSwift Build is a high-level build system based on [llbuild](https://github.com/swiftlang/swift-llbuild) with great support for building Swift. It is used by Xcode to build Xcode projects and Swift packages, and by Swift Playground. It can also be used as the Swift Package Manager build system in preview form when passing `--build-system swiftbuild`.\n\nUsage\n-----\n\n### With SwiftPM\n\nWhen building SwiftPM from sources which include Swift Build integration, passing `--build-system swiftbuild` will enable the new build-system. This functionality is not currently available in nightly toolchains.\n\n### With Xcode\n\nChanges to swift-build can also be tested in Xcode using the `launch-xcode` command plugin provided by the package. Run `swift package --disable-sandbox launch-xcode` from your checkout of swift-build to launch a copy of the currently `xcode-select`ed Xcode.app configured to use your modified copy of the build system service. This workflow is generally only supported when using the latest available Xcode version.\n\n### With xcodebuild\n\nChanges to swift-build can also be tested in xcodebuild using the `run-xcodebuild` command plugin provided by the package. Run `swift package --disable-sandbox run-xcodebuild` from your checkout of swift-build to run xcodebuild from the currently `xcode-select`ed Xcode.app configured to use your modified copy of the build system service. Arguments followed by `--` will be forwarded to xcodebuild unmodified. This workflow is generally only supported when using the latest available Xcode version.\n\n### Debugging\n\nWhen using the Xcode or xcodebuild workflows above, you can easily set breakpoints and debug. First, open the swift-build package containing your changes in Xcode and choose the \"Debug \u003e Attach to Process by PID or Name…\" menu item. In the panel that appears, type \"SWBBuildServiceBundle\" as the process name and click \"Attach\". The debugger will wait for the process to launch. Run the relevant command shown above to launch Xcode or xcodebuild, and once you open a workspace the swift-build process will launch and the debugger will attach to it automatically.\n\nDocumentation\n-------------\n\n[SwiftBuild.docc](SwiftBuild.docc) contains additional technical documentation.\n\nTo view the documentation in browser, run the following command at the root of the project:\n```bash\ndocc preview SwiftBuild.docc\n```\n\nOn macOS, use:\n```bash\nxcrun docc preview SwiftBuild.docc\n```\n\nTesting\n-------------\nBefore submitting the pull request, please make sure you have tested your changes. You can run the full test suite by running `swift test` from the root of the repository. The test suite is organized into a number of different test targets, with each corresponding to a specific component. For example, `SWBTaskConstructionTests` contains tests for the `SWBTaskConstruction` module which plan builds and then inspect the resulting build graph. Many tests in Swift Build operate on test project model objects which emulate those constructed by a higher level client and validate behavior at different layers. You can learn more about how these tests are written and organized in [Project Tests](SwiftBuild.docc/Development/test-development-project-tests.md).\n\n\nContributing to Swift Build\n------------\n\nContributions to Swift Build are welcomed and encouraged! Please see the\n[Contributing to Swift guide](https://swift.org/contributing/).\n\nBefore submitting the pull request, please make sure that they follow the Swift project [guidelines for contributing\n code](https://swift.org/contributing/#contributing-code). Bug reports should be\n filed in [the issue tracker](https://github.com/swiftlang/swift-build/issues) of\n `swift-build` repository on GitHub.\n\nTo be a truly great community, [Swift.org](https://swift.org/) needs to welcome\ndevelopers from all walks of life, with different backgrounds, and with a wide\nrange of experience. A diverse and friendly community will have more great\nideas, more unique perspectives, and produce more great code. We will work\ndiligently to make the Swift community welcoming to everyone.\n\nTo give clarity of what is expected of our members, Swift has adopted the\ncode of conduct defined by the Contributor Covenant. This document is used\nacross many open source communities, and we think it articulates our values\nwell. For more, see the [Code of Conduct](https://swift.org/code-of-conduct/).\n\nLicense\n-------\nSee https://swift.org/LICENSE.txt for license information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiftlang%2Fswift-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswiftlang%2Fswift-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiftlang%2Fswift-build/lists"}