Swift Package Manager

Let’s make dependency manager great, Finally!

Transcript

1. Swift Package Manager or Let’s make dependency manager great, Finally!
2. Kostiantyn Koval @Agens AS • Swift from day 1 • Swift Hight Performance • Swift Package Manager • @KostiaKoval
3. pod install
4. How it used to be ! ... • Static libraries lib.a • Copied source • Subproject + Workspace • Submodules
5. The problems ! • Closed code / Precompiled • Hard to discover • No versioning • Duplicate Symbols a->c, b->c App ->(a, b) Duplicate 'c'
6. CocoaPods - Easy • Centralized • Podspec • Static Libs + Frameworks • Modifies Xcode projects + workspace Res: Workspace
7. Carthage - Simple • Decentralized • No Podspec • Git + Xcode • Frameworks Res: Frameworks
8. Happy
9. Problems • Not integrated with ! • Xcode private API and Format • Custom scripts • Limited
10. SwiftPM
11. Why it was built? iOS Linux
12. SwiftPM Cross platform, Convention approach, Decentralized is a tool to automate the process of downloading, compiling, and linking dependencies. — Swift .org
13. SwiftPM Fetch Build Test swift package swift build swift test
14. "swift package" clean Delete build artifacts describe Describe the current package dump-package Print parsed Package.swift as JSON fetch Fetch package dependencies generate-xcodeproj Generates an Xcode project init Initialize a new package reset Reset the complete cache/build directory show-dependencies Print the resolved dependency graph update Update package dependencies
15. What is a Swift Package ?
16. What is a Swift Package ? Package.swift import PackageDescription let package = Package( name: "Empty" )
17. What is a Swift Package ? • Swift, C, C++, Objective-C, Objective-C++ One language per module • library (static, dynamic), executable, system-module
18. Package Convention Source in - /Sources Tests in - /Tests Executable - main.swift Lib - SomeLib.swift C headers - /include/Baz.h
19. Package //executable lib with tests . . ├── Package.swift ├── Package.swift ├── Sources ├── Sources └── main.swift │ └── Lib.swift └── Tests ├── LibTests │ └── LibTests.swift └── LinuxMain.swift
20. Package // 2 Modules system-module . . ├── Package.swift ├── Package.swift └── Sources └── module.modulemap ├── A │ └── A.swift └── B └── someCode.swift
21. system-module // module.modulemap module Clibgit [system] { header "/usr/local/include/git2.h" link "git2" export * }
22. ! ship IT
23. Package + Git = ! • Step N1: git init, commit, tag 0.1.0, push
24. Package + Git = ! • Step N2: There is no Step N2 !
25. Package + Git = ! let package = Package( name: "Empty" dependencies: [ .Package(url: "https://github.com/MyAwesomePackage", majorVersion: 0), ] ) semver, semver, semver -> Semver.org
26. Package Dependency let package = Package( name: "Empty" dependencies: [ .Package(url: "https://github.com/MyAwesomePackage", majorVersion: 0), .Package(url: "https://github.com/MyAwesomePackage", majorVersion: 1, minor: 4), .Package(url: "ssh://git@example.com/Greeter.git", versions: Version(1,0,0)..<Version(2,0,0)), .Package(url: "../StringExtensions", "1.0.0-alpha+001"), .Package(url: "../Package", version: Version(0, 1, 0), .Package(url: "../AwesomePackage", version: Version(0, 1, 0, prereleaseIdentifiers: ["alpha"], buildMetadataIdentifier: "001"), ] )
27. Package Power Package( name: String, dependencies: [Package.Dependency] = [], targets: [Target] = [], exclude: [String] = [] pkgConfig: String? = nil, providers: [SystemPackageProvider]? = nil, )
28. Package Targets 3 Targets: Core, Network, Login . ├── Package.swift └── Sources ├── Core │ └── core.swift ├── Login │ └── loginAPI.swift └── Network └── coreNetwork.swift
29. Package Targets 3 Targets: Core, Network, Login let package = Package( name: "App", targets: [ Target(name: "Login", dependencies: ["Core", "Network"]), ] )
30. Package exclude let package = Package( name: "Lib", exclude: ["Sources/mocJSON", "Sources/LibAReadme.md", "Tests/FooTests/images"] )
31. Package pkg-config // module.modulemap module Clibgit [system] { header "/usr/local/include/git2.h" link "git2" export * } swift build -Xcc -I.. -Xlinker -L/usr/local/lib/
32. Package pkg-config swift build -Xcc -I.. -Xlinker -L/usr/local/lib/ let package = Package( name: "Clibgit", pkgConfig: "libgit2" )
33. Package pkg-config swift build let package = Package( name: "Clibgit", pkgConfig: "libgit2" )
34. Package pkg-config //libgit2.pc file ... Cflags: -I${includedir}/libgit2 Libs: -L${libdir} -llibgit2
35. What if the system package is not there? !"
36. Package Providers let package = Package( name: "Clibgit", pkgConfig: "libgit2", providers: [ .Brew("libgit2"), .Apt("libgit2") ] )
37. Coming Soon ... Product Definitions let package = Package( name: "MyServer", ... products: [ .Library(name: "ClientLib", type: .static, targets: ["ClientAPI"]), .Library(name: "ServerLib", type: .dynamic, targets: ["ServerAPI"]), .Executable(name: "myserver", targets: ["ServerDaemon"]), ] ) "Package Manager Product Definitions"
38. Xcode Integration swift package generate-xcodeproj . ├── Package.swift └── Sources ├── A │ └── A.swift └── B └── Code.swift
39. Xcode Integration swift package generate-xcodeproj --xcconfig-overrides Config.xcconfig . ├── Package.swift └── Sources ├── A │ └── A.swift └── B └── Code.swift
40. But is it ready for Production and big Projects?
41. SwiftPM uses SwiftPM to "build and test" SwiftPM
42. SwiftPM • 19 Modules • 31 Targets • 13 Test Modules • A lot of Code an Tests
44. It does handle the Scale
45. The iOS !
46. Does the SwiftPM solves the issue? YES!, kind off, it will. ! • Painless config • Right Xcode project integration • Full Build & Tests control • Open Source • Many, many more ...
47. swift build The new -
48. Thanks @KostiaKoval