Demo Swift Carthage
This demonstration shows:
The Carthage dependency manager.
The Prelude Swift micro-framework of simple functional programming tools.
To use this demo, you can clone this repo, or you can use this README to create your own project.
If you clone this repo, then be aware that there are multiple git branches, so pick the one you want.
swift-4-xcode-9: Swift version 4, Xcode version 9, iOS version 11.
swift-3-xcode-8: Swift version 3, Xcode version 8, iOS version 10.
Create the project
Launch Xcode and create a new Xcode project.
Use iOS template "Single View Application" and Product Name "Demo Swift Carthage".
To see if you have Carthage installed, and if the Carthage version is current, run this command:
$ carthage version 0.25.0
If Carthage is not installed, or the version is lower than 0.25.0:
- Use these Carthage instructions
Create a Cartfile
Create an empty text file named
Cartfile at the top level of the project.
You can add any framework you want.
For this demo, we add the "Prelude" framework, which is provides programming functions.
Add this text:
$ carthage update *** Fetching Prelude *** Downloading Prelude.framework binary at "2.0" *** xcodebuild output can be found in /var/folders/…
See the results if you like.
There is a new file
Cartfile.resolvedthat lists the framework and its exact version number.
There is a new directory
Carthage. This contains the
Builddirectory and the framework files.
$ ls -1 Cartfile Cartfile.resolved Carthage Demo Swift Carthage Demo Swift Carthage.xcodeproj Demo Swift CarthageTests Demo Swift CarthageUITests $ ls Carthage Build $ cat Cartfile.resolved github "robrix/Prelude" "2.0.0"
Link the framework
Go to the Xcode project "General" area.
Scroll down the section "Linked Frameworks and Libraries", with the text that says "Add frameworks & libraries here".
Tap the "+" icon.
A dialog opens that says "Choose frameworks and libraries to add".
Tap the button "Add Other..."
Choose the framework.
A file chooser opens.
Navigate up a folder, and you see the "Carthage" folder.
Open the folder "Carthage", then the folder "Build", then the folder "iOS".
Tap the file "Prelude.framework" to highlight it.
The section "Linked Frameworks and Libraries" now shows "Prelude.framework".
Create the Run Script
Go to the Xcode project "Build Phases" settings area.
Click the "+" icon, then choose "New Run Script Phase".
Click the triangle by the new "Run Script" list item.
The "Shell" field should say
The larger text field should say
Type a script or drag a script file from your workspace to insert its path.
Set the larger text field to say
Add input files.
In the area "Add input files here", click "+".
Set the "Input Files" to
Run the project.
- Xcode → Product → Run
The Simulator launches.
The app will launch normally.
This verifies that Carthage can connect the files.
Congratulations! You're successful!
- Package: demo_swift_carthage
- Version: 3.0.0
- Created: 2016-04-09
- Updated: 2017-09-22
- License: BSD, MIT, GPL
- Contact: Joel Parker Henderson (firstname.lastname@example.org)