XcodeGen

This is an example project to test XcodeGen and to present it to my colleagues. Have a look at the XcodeGen GitHub Repo. There you can find every information you need!

---

"XcodeGen is a command line tool written in Swift that generates your Xcode project using your folder structure and a project spec."

These are some of the main advantages why it could be a good idea to use XcodeGen. On their GitHub page you can see the full list.

• Generate projects on demand and remove your .xcodeproj file from git, which means no more merge conflicts!
• Groups and files in Xcode are always synced to your directories on disk
• Easy configuration of projects which is human readable and git friendly
• Easily copy and paste files and directories without having to edit anything in Xcode
• Automatically generate Schemes for different environments like test and production
• Easily create new projects with complicated setups on demand without messing around with Xcode
• Generate from anywhere including on CI

There is also a fastlane plugin for using xcodegen (see here).

---

Install

brew install xcodegen

Usage

xcodegen

Example

project.yml

name: xcodegenExample # The name of the App
options: # Some general settings for the projectproject.yml
  createIntermediateGroups: true # If the folders are nested, also nest the groups in Xcode
  indentWidth: 4 # indent by 4 spaces
  tabWidth: 4 # a tab is 4 spaces
  bundleIdPrefix: "de.adorsys.ios"
configs:
  Debug: debug
  integ: debug
  test: debug
  Release: release
targets:
  xcodegenExample:
    type: application
    platform: iOS
    deploymentTarget: "11.0"
    sources:  
      - path: xcodegenExample
    scheme: 
      testTargets:
        - xcodegenExampleTests
        - xcodegenExampleUITests
      gatherCoverageData: true
  xcodegenExampleTests:
    type: bundle.unit-test
    platform: iOS
    deploymentTarget: "11.0"
    sources:
      - path: xcodegenExampleTests
    dependencies:
      - target: xcodegenExample
    scheme: 
      testTargets:
        - xcodegenExample
        - xcodegenExampleTests
      gatherCoverageData: true
  xcodegenExampleUITests:
    type: bundle.ui-testing
    platform: iOS
    sources:
      - path: xcodegenExampleUITests
    dependencies:
      - target: xcodegenExample

Further information

• XcodeGen on GitHub
• XcodeGen-Article: Better iOS projects: Getting (nearly) rid of Xcodeproject - A (not so) short Introduction to Xcodegen ~ Number 42