Merge pull request #16 from bow-swift/tomas/integration

Documentation for integration in Xcode

Author: truizlop

Documentation.app/Contents/MacOS/Consuming generated code.playground/Pages/Adding the module to your project.xcplaygroundpage/Contents.swift

@@ -7,4 +7,17 @@
 /*:
  # Adding the module to your project
 
+ After generating a network client using Bow OpenAPI, you will get a folder that contains all files together with the Swift Package manifest that describes the provided artifacts. Adding it to your Xcode Project is as easy as dragging the folder to the left panel in Xcode, and Xcode will automatically trigger the Swift Package Manager to download the dependencies.
+ 
+ ![](/assets/project-tree.png)
+ 
+ Then, you need to add the dependency to the target where you want to use the generated code:
+ 
+ ![](/assets/add-frameworks.png)
+ 
+ Finally, you can import it in your Swift files as:
+ 
+ ```swift
+ import SampleAPI
+ ```
  */

Documentation.app/Contents/MacOS/Quick start.playground/Pages/Integration in Xcode.xcplaygroundpage/Contents.swift

@@ -7,4 +7,27 @@
 /*:
  # Integration in Xcode
 
+ Bow OpenAPI can be integrated in Xcode easily to regenerate your network client whenever the specification changes. Assuming you have already installed Bow OpenAPI in your computer, you can follow these steps.
+ 
+ ## Add the specification file
+ 
+ Add the OpenAPI/Swagger specification file to the root of your project, as depicted in the image.
+ 
+ ![](/assets/spec-file.png)
+ 
+ ## Create an Aggregate
+ 
+ Add a new target to your project and select Aggregate, giving it the name you prefer.
+ 
+ ![](/assets/aggregate.png)
+ 
+ ## Run script
+ 
+ Select your recently created Aggregate and go to its Build Phases tab. Add a New Run Script Phase. There, you can invoke the Bow OpenAPI command, passing the values you need for your project.
+ 
+ ![](/assets/build-phase.png)
+ 
+ ## Build
+ 
+ From now on, if you run the scheme corresponding to this Aggregate, it will regenerate the network client based on the specification file. Drag the folder containing the generated code and drop it onto your project, and Swift Package Manager will start fetching your dependencies.
  */