how to add existing local package to Xcode workspace
Generated on 7/30/2024
1 search
To add an existing local package to an Xcode workspace, you can follow these steps:
-
Open your Xcode workspace: Make sure you have your Xcode workspace open where you want to add the local package.
-
Add the package to the workspace:
- Drag and Drop: You can simply drag the folder containing your local package into the Xcode workspace navigator.
- File Menu: Alternatively, you can go to
File
>Add Files to [Your Workspace]...
and select the folder containing your local package.
-
Configure the package:
- Once the package is added, Xcode should recognize it as a Swift package. You may need to configure the package dependencies if it has any.
- Ensure that the package is correctly referenced in your project settings. You can do this by selecting your project in the navigator, then going to the
Swift Packages
tab and verifying that your local package is listed there.
-
Link the package to your targets:
- Select your project in the navigator.
- Go to the
General
tab of your target. - In the
Frameworks, Libraries, and Embedded Content
section, click the+
button and add your local package.
For more detailed guidance on working with packages in Xcode, you might find the session Xcode essentials helpful, which covers various aspects of working efficiently in Xcode, including managing dependencies and packages.
If you need more specific information on Swift packages, the session A Swift Tour: Explore Swift’s features and design discusses how to organize code into packages and manage dependencies.

Explore the Swift on Server ecosystem
Swift is a great language for writing your server applications, and powers critical services across Apple’s cloud products. We’ll explore tooling, delve into the Swift server package ecosystem, and demonstrate how to interact with databases and add observability to applications.

Extend your Xcode Cloud workflows
Discover how Xcode Cloud can adapt to your development needs. We’ll show you how to streamline your workflows, automate testing and distribution with start conditions, custom aliases, custom scripts, webhooks, and the App Store Connect API.

Xcode essentials
Edit, debug, commit, repeat. Explore the suite of tools in Xcode that help you iterate quickly when developing apps. Discover tips and tricks to help optimize and boost your development workflow.

Go small with Embedded Swift
Embedded Swift brings the safety and expressivity of Swift to constrained environments. Explore how Embedded Swift runs on a variety of microcontrollers through a demonstration using an off-the-shelf Matter device. Learn how the Embedded Swift subset packs the benefits of Swift into a tiny footprint with no runtime, and discover plenty of resources to start your own Embedded Swift adventure.

What’s new in Swift
Join us for an update on Swift. We’ll briefly go through a history of Swift over the past decade, and show you how the community has grown through workgroups, expanded the package ecosystem, and increased platform support. We’ll introduce you to a new language mode that achieves data-race safety by default, and a language subset that lets you run Swift on highly constrained systems. We’ll also explore some language updates including noncopyable types, typed throws, and improved C++ interoperability.

Demystify explicitly built modules
Explore how builds are changing in Xcode 16 with explicitly built modules. Discover how modules are used to build your code, how explicitly built modules improve transparency in compilation tasks, and how you can optimize your build by sharing modules across targets.

What’s new in StoreKit and In-App Purchase
Learn how to build and deliver even better purchase experiences using the App Store In-App Purchase system. We’ll demo new StoreKit views control styles and new APIs to improve your subscription customization, discuss new fields for transaction-level information, and explore new testability in Xcode. We’ll also review an important StoreKit deprecation.

A Swift Tour: Explore Swift’s features and design
Learn the essential features and design philosophy of the Swift programming language. We’ll explore how to model data, handle errors, use protocols, write concurrent code, and more while building up a Swift package that has a library, an HTTP server, and a command line client. Whether you’re just beginning your Swift journey or have been with us from the start, this talk will help you get the most out of the language.