Skip to content

Document ArtifactBundleIndex usage for binary dependencies #9544

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Viditgupta-official wants to merge 1 commit into
base: main
Choose a base branch
from
+13 −0
Open

Document ArtifactBundleIndex usage for binary dependencies #9544

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions Sources/PackageManagerDocs/Documentation.docc/AddingDependencies.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,19 @@ To add a dependency on a precompiled binary target, specify a `.binaryTarget` in
[binarytarget(name:url:checksum:)](https://developer.apple.com/documentation/packagedescription/target/binarytarget(name:url:checksum:)) for a downloadable target,
or [binarytarget(name:path:)](https://developer.apple.com/documentation/packagedescription/target/binarytarget(name:path:)) for a local binary.
After adding the binary target, you can add it to the list of dependencies for any other target.
### ArtifactBundleIndex

Swift Package Manager supports binary targets distributed as artifact bundles.
An artifact bundle may include an `ArtifactBundleIndex` file, which describes
the artifacts contained in the bundle and the platforms or variants they support.

The `ArtifactBundleIndex` is required when an artifact bundle contains multiple
artifacts or supports multiple platforms. SwiftPM uses this index to determine
which artifact to select during dependency resolution.

For full details on the structure and semantics of artifact bundles and
`ArtifactBundleIndex`, see the Swift Evolution proposal
[SE-0305: SwiftPM Binary Target Improvements](https://github.com/swiftlang/swift-evolution/blob/main/proposals/0305-swiftpm-binary-target-improvements.md).

For more information on identifying and verifying a binary target, see [Identifying binary dependencies](https://developer.apple.com/documentation/xcode/identifying-binary-dependencies).
For more information on creating a binary target, see [Creating a multiplatform binary framework bundle](https://developer.apple.com/documentation/xcode/creating-a-multi-platform-binary-framework-bundle).
Expand Down