Skip to content
This repository was archived by the owner on Jan 11, 2024. It is now read-only.

Commit c51c8c9

Browse files
committed
docs: add manual installation guides
1 parent 9072d1e commit c51c8c9

File tree

2 files changed

+111
-9
lines changed

2 files changed

+111
-9
lines changed

README.md

Lines changed: 56 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[![API Docs](http://img.shields.io/badge/Read_the-docs-2196f3.svg)](https://swiftylab.github.io/DynamicCodableKit/documentation/dynamiccodablekit/)
44
[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/DynamicCodableKit.svg?label=CocoaPods&color=C90005)](https://badge.fury.io/co/DynamicCodableKit)
5-
[![Swift Package Manager Compatible](https://img.shields.io/github/v/tag/SwiftyLab/DynamicCodableKit?label=SPM&color=DE5D43)](https://badge.fury.io/gh/SwiftyLab%2FDynamicCodableKit)
5+
[![Swift Package Manager Compatible](https://img.shields.io/github/v/tag/SwiftyLab/DynamicCodableKit?label=SPM&color=orange)](https://badge.fury.io/gh/SwiftyLab%2FDynamicCodableKit)
66
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg)](https://github.com/Carthage/Carthage)
77
[![Swift](https://img.shields.io/badge/Swift-5-orange)](https://img.shields.io/badge/Swift-5-DE5D43)
88
[![Platforms](https://img.shields.io/badge/Platforms-all-sucess)](https://img.shields.io/badge/Platforms-all-sucess)
@@ -26,7 +26,7 @@ The data types, protocols, and property wrappers defined by **DynamicCodableKit*
2626

2727
| Platform | Minimum Swift Version | Installation | Status |
2828
| --- | --- | --- | --- |
29-
| iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+ | 5.1 | [CocoaPods](#cocoapods), [Carthage](#carthage), [Swift Package Manager](#swift-package-manager) | Fully Tested |
29+
| iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+ | 5.1 | [CocoaPods](#cocoapods), [Carthage](#carthage), [Swift Package Manager](#swift-package-manager), [Manual](#manually) | Fully Tested |
3030
| Linux | 5.1 | [Swift Package Manager](#swift-package-manager) | Fully Tested |
3131
| Windows | 5.1 | [Swift Package Manager](#swift-package-manager) | Not Tested but Supported |
3232

@@ -40,6 +40,12 @@ The data types, protocols, and property wrappers defined by **DynamicCodableKit*
4040
pod 'DynamicCodableKit'
4141
```
4242

43+
Optionally, you can also use the pre built XCFramework from the GitHub releases page by replacing `{version}` with the required version you want to use:
44+
45+
```ruby
46+
pod 'DynamicCodableKit', :http => 'https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip'
47+
```
48+
4349
### Carthage
4450

4551
[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate `DynamicCodableKit` into your Xcode project using Carthage, specify it in your `Cartfile`:
@@ -55,11 +61,56 @@ The [Swift Package Manager](https://swift.org/package-manager/) is a tool for au
5561
Once you have your Swift package set up, adding `DynamicCodableKit` as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift`.
5662

5763
```swift
58-
dependencies: [
59-
.package(url: "https://github.com/SwiftyLab/DynamicCodableKit.git", .upToNextMajor(from: "1.0.0"))
60-
]
64+
.package(url: "https://github.com/SwiftyLab/DynamicCodableKit.git", from: "1.0.0"),
65+
```
66+
67+
Optionally, you can also use the pre built XCFramework from the GitHub releases page by replacing `{version}` and `{checksum}` with the required version and checksum of artifact you want to use:
68+
69+
```swift
70+
.binaryTarget(name: "DynamicCodableKit", url: "https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip", checksum: "{checksum}"),
6171
```
6272

73+
### Manually
74+
75+
If you prefer not to use any of the aforementioned dependency managers, you can integrate `DynamicCodableKit` into your project manually.
76+
77+
#### Git Submodule
78+
79+
- Open up Terminal, `cd` into your top-level project directory, and run the following command "if" your project is not initialized as a git repository:
80+
81+
```bash
82+
$ git init
83+
```
84+
85+
- Add `DynamicCodableKit` as a git [submodule](https://git-scm.com/docs/git-submodule) by running the following command:
86+
87+
```bash
88+
$ git submodule add https://github.com/SwiftyLab/DynamicCodableKit.git
89+
```
90+
91+
- Open the new `DynamicCodableKit` folder, and drag the `DynamicCodableKit.xcodeproj` into the Project Navigator of your application's Xcode project or existing workspace.
92+
93+
> It should appear nested underneath your application's blue project icon. Whether it is above or below all the other Xcode groups does not matter.
94+
95+
- Select the `DynamicCodableKit.xcodeproj` in the Project Navigator and verify the deployment target satisfies that of your application target (should be less or equal).
96+
- Next, select your application project in the Project Navigator (blue project icon) to navigate to the target configuration window and select the application target under the `Targets` heading in the sidebar.
97+
- In the tab bar at the top of that window, open the "General" panel.
98+
- Click on the `+` button under the `Frameworks and Libraries` section.
99+
- You will see `DynamicCodableKit.xcodeproj` folder with `DynamicCodableKit.framework` nested inside.
100+
- Select the `DynamicCodableKit.framework` and that's it!
101+
102+
> The `DynamicCodableKit.framework` is automagically added as a target dependency, linked framework and embedded framework in build phase which is all you need to build on the simulator and a device.
103+
104+
#### XCFramework
105+
106+
You can also directly download the pre-built artifact from the GitHub releases page:
107+
108+
- Download the artifact from the GitHub releases page of the format `DynamicCodableKit-{version}.xcframework.zip` where `{version}` is the version you want to use.
109+
- Extract the XCFramework from the archive, and drag the `DynamicCodableKit.xcframework` into the Project Navigator of your application's target folder in your Xcode project.
110+
- Select `Copy items if needed` and that's it!
111+
112+
> The `DynamicCodableKit.xcframework` is automagically added in the embedded `Frameworks and Libraries` section, an in turn the linked framework in build phase.
113+
63114
## Usage
64115

65116
See the full [documentation](https://swiftylab.github.io/DynamicCodableKit/documentation/dynamiccodablekit/) for API details and articles on sample scenarios.

Sources/DynamicCodableKit/DynamicCodableKit.docc/DynamicCodableKit.md

Lines changed: 55 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The data types, protocols, and property wrappers defined by `DynamicCodableKit`
1313

1414
| Platform | Minimum Swift Version | Installation | Status |
1515
| --- | --- | --- | --- |
16-
| iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+ | 5.1 | CocoaPods, Carthage, Swift Package Manager | Fully Tested |
16+
| iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+ | 5.1 | CocoaPods, Carthage, Swift Package Manager, Manual | Fully Tested |
1717
| Linux | 5.1 | Swift Package Manager | Fully Tested |
1818
| Windows | 5.1 | Swift Package Manager | Not Tested but Supported |
1919

@@ -27,6 +27,12 @@ The data types, protocols, and property wrappers defined by `DynamicCodableKit`
2727
pod 'DynamicCodableKit'
2828
```
2929

30+
Optionally, you can also use the pre built XCFramework from the GitHub releases page by replacing `{version}` with the required version you want to use:
31+
32+
```ruby
33+
pod 'DynamicCodableKit', :http => 'https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip'
34+
```
35+
3036
### Carthage
3137

3238
[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate `DynamicCodableKit` into your Xcode project using Carthage, specify it in your `Cartfile`:
@@ -42,11 +48,56 @@ The [Swift Package Manager](https://swift.org/package-manager/) is a tool for au
4248
Once you have your Swift package set up, adding `DynamicCodableKit` as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift`.
4349

4450
```swift
45-
dependencies: [
46-
.package(url: "https://github.com/SwiftyLab/DynamicCodableKit.git", .upToNextMajor(from: "1.0.0"))
47-
]
51+
.package(url: "https://github.com/SwiftyLab/DynamicCodableKit.git", from: "1.0.0"),
52+
```
53+
54+
Optionally, you can also use the pre built XCFramework from the GitHub releases page by replacing `{version}` and `{checksum}` with the required version and checksum of artifact you want to use:
55+
56+
```swift
57+
.binaryTarget(name: "DynamicCodableKit", url: "https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip", checksum: "{checksum}"),
4858
```
4959

60+
### Manually
61+
62+
If you prefer not to use any of the aforementioned dependency managers, you can integrate `DynamicCodableKit` into your project manually.
63+
64+
#### Git Submodule
65+
66+
- Open up Terminal, `cd` into your top-level project directory, and run the following command "if" your project is not initialized as a git repository:
67+
68+
```bash
69+
$ git init
70+
```
71+
72+
- Add `DynamicCodableKit` as a git [submodule](https://git-scm.com/docs/git-submodule) by running the following command:
73+
74+
```bash
75+
$ git submodule add https://github.com/SwiftyLab/DynamicCodableKit.git
76+
```
77+
78+
- Open the new `DynamicCodableKit` folder, and drag the `DynamicCodableKit.xcodeproj` into the Project Navigator of your application's Xcode project or existing workspace.
79+
80+
> It should appear nested underneath your application's blue project icon. Whether it is above or below all the other Xcode groups does not matter.
81+
82+
- Select the `DynamicCodableKit.xcodeproj` in the Project Navigator and verify the deployment target satisfies that of your application target (should be less or equal).
83+
- Next, select your application project in the Project Navigator (blue project icon) to navigate to the target configuration window and select the application target under the `Targets` heading in the sidebar.
84+
- In the tab bar at the top of that window, open the "General" panel.
85+
- Click on the `+` button under the `Frameworks and Libraries` section.
86+
- You will see `DynamicCodableKit.xcodeproj` folder with `DynamicCodableKit.framework` nested inside.
87+
- Select the `DynamicCodableKit.framework` and that's it!
88+
89+
> The `DynamicCodableKit.framework` is automagically added as a target dependency, linked framework and embedded framework in build phase which is all you need to build on the simulator and a device.
90+
91+
#### XCFramework
92+
93+
You can also directly download the pre-built artifact from the GitHub releases page:
94+
95+
- Download the artifact from the GitHub releases page of the format `DynamicCodableKit-{version}.xcframework.zip` where `{version}` is the version you want to use.
96+
- Extract the XCFramework from the archive, and drag the `DynamicCodableKit.xcframework` into the Project Navigator of your application's target folder in your Xcode project.
97+
- Select `Copy items if needed` and that's it!
98+
99+
> The `DynamicCodableKit.xcframework` is automagically added in the embedded `Frameworks and Libraries` section, an in turn the linked framework in build phase.
100+
50101
## Topics
51102

52103
### Common Scenarios

0 commit comments

Comments
 (0)