{"id":22025474,"url":"https://github.com/getsidetrack/action-xcodeproj-spm-update","last_synced_at":"2025-05-07T09:34:47.584Z","repository":{"id":65159892,"uuid":"459650834","full_name":"getsidetrack/action-xcodeproj-spm-update","owner":"getsidetrack","description":"Update your Xcode project with the latest Swift Package dependencies","archived":false,"fork":false,"pushed_at":"2022-10-25T10:08:17.000Z","size":12,"stargazers_count":35,"open_issues_count":2,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T08:43:27.779Z","etag":null,"topics":["dependabot","dependencies","swift","swift-package-manager"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/getsidetrack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-15T16:05:01.000Z","updated_at":"2025-02-18T02:30:34.000Z","dependencies_parsed_at":"2023-01-04T12:37:25.576Z","dependency_job_id":null,"html_url":"https://github.com/getsidetrack/action-xcodeproj-spm-update","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsidetrack%2Faction-xcodeproj-spm-update","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsidetrack%2Faction-xcodeproj-spm-update/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsidetrack%2Faction-xcodeproj-spm-update/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getsidetrack%2Faction-xcodeproj-spm-update/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getsidetrack","download_url":"https://codeload.github.com/getsidetrack/action-xcodeproj-spm-update/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252851638,"owners_count":21814186,"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":["dependabot","dependencies","swift","swift-package-manager"],"created_at":"2024-11-30T07:17:18.810Z","updated_at":"2025-05-07T09:34:47.556Z","avatar_url":"https://github.com/getsidetrack.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Xcode Project Swift Package Dependencies Update Action\n\nThis action will resolve the Swift Package Manager dependencies within your Xcode project. This can be useful in workflows that want to detect outdated dependencies, or wish to automatically create pull requests updating dependencies.\n\nIt will respect the boundaries you defined on your dependency, such as only updating to the next minor or on a given branch.\n\nThis action requires that you have checked out the source code of the project first, for example using [actions/checkout](https://github.com/actions/checkout).\n\n```yaml\njobs:\n  dependencies:\n    runs-on: macos-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: GetSidetrack/action-xcodeproj-spm-update@main\n```\n\nBy default, this action will fail if one or more of your dependencies are outdated. This can be suppressed by setting the input parameter of `failWhenOutdated` to false. Regardless of this setting, you may use the output parameter `dependenciesChanged` to run further steps (see example workflow at bottom).\n\n```yaml\njobs:\n  dependencies:\n    runs-on: macos-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: GetSidetrack/action-xcodeproj-spm-update@main\n        with:\n          failWhenOutdated: false\n```\n\nNote that this action will change the `Package.resolved` file which should be checked in to your repository. However, this action will not itself commit or push changes to your repository. We recommend using a package such as [peter-evans/create-pull-request](https://github.com/peter-evans/create-pull-request) to achieve this automation.\n\nBy default this action is looking for an `.xcodeproj` file within the current directory (`.`). For projects where this is not true, you may provide a `directory` input parameter. This is helpful for monorepo projects which may contain multiple projects.\n\n```yaml\njobs:\n  dependencies:\n    runs-on: macos-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: GetSidetrack/action-xcodeproj-spm-update@main\n        with:\n          directory: 'iOS'\n```\n\nAlso, if your repository is using an `.xcworkspace` file then you can provide this through the `workspace` input. Note that you **must** also then specify the `scheme` input to be that of a shared scheme within your workspace.\n\n```yaml\njobs:\n  dependencies:\n    runs-on: macos-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: GetSidetrack/action-xcodeproj-spm-update@main\n        with:\n          workspace: 'Sidetrack.xcworkspace'\n          scheme: 'App-iOS'\n```\n\nIf the Package.resolved file has been built with an incompatible version of Xcode, or is in any way corrupted then `xcodebuild` is likely to fail. By setting `forceResolution` to true, it will force Xcode to resolve from nothing and can potentially avoid this problem.\n\nYou may specify the `xcodePath` input to a string specifying the path to the Xcode installation on your GitHub runner. This will most likely be one of the paths GitHub provides on their documentation [here](https://github.com/actions/runner-images/blob/main/images/macos/macos-12-Readme.md#xcode) but may also be your own path if using a self-hosted runner.\n\n## Full Workflow\n\nAn example workflow is provided below which will create a pull request which any updated dependencies once a week. Feel free to use, or adapt this in your own workflows.\n\n```yaml\nname: Xcode Dependencies\n\non: \n  schedule:\n    - cron: '0 6 * * 1' # Monday at 06:00 UTC\n\npermissions:\n  contents: write\n  pull-requests: write\n\njobs:\n  dependencies:\n    runs-on: macos-latest\n\n    steps:\n      - uses: actions/checkout@v2\n\n      - name: Resolve Dependencies\n        id: resolution\n        uses: GetSidetrack/action-xcodeproj-spm-update@main\n        with:\n          forceResolution: true\n          failWhenOutdated: false\n\n      - name: Create Pull Request\n        if: steps.resolution.outputs.dependenciesChanged == 'true'\n        uses: peter-evans/create-pull-request@v3\n        with:\n          branch: 'dependencies/ios'\n          delete-branch: true\n          commit-message: 'Update Xcode Dependencies'\n          title: 'Updated Xcode Dependencies'\n```\n\n## Similar Packages\n\n- [swift-package-dependencies-check](https://github.com/MarcoEidinger/swift-package-dependencies-check) is a GitHub Action which helps update dependencies for Swift Packages (as opposed to Xcode Projects with Swift Packages).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsidetrack%2Faction-xcodeproj-spm-update","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetsidetrack%2Faction-xcodeproj-spm-update","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetsidetrack%2Faction-xcodeproj-spm-update/lists"}