/LicenseGenerator-iOS

Xcode build script that recursively searches for LICENSE files and generates a Settings.bundle friendly plist.

Primary LanguageSwiftOtherNOASSERTION

LicenseGenerator iOS

Build Version Swift Platform Downloads

Recursively finds all LICENSE.* files in a directory and generates a plist that can be displayed in Settings.bundle or the provided view controller.

Screenshot

The script can help ensure that the license section of your app is always up to date. Since it searches recursively the script works well with cocoapods projects.

Inspired by JosephH and Sean's comments on stackoverflow.

Build Script

The build script recursively searches the project for LICENSE files and generates a plist that can be used in a Settings.bundle. The script assumes that the parent directory of the LICENSE file is also the name of the library to be credited.

Usage

  • Copy credits.py to the your project root
  • Open your project, select your Target and select Build Phases
  • Add a new Run Script Phase after target dependencies
  • Add something like: ./credits.py -s "$SRCROOT" -o "$SRCROOT/Project/Settings.bundle/Credits.plist"
  • Build & profit

Excluding Directories

You can optionally tell the generator to ignore certain paths. To do so use the -e option and pass it a comma separated list of path fragments.

View Controller

If your app doesn't use a Settings.bundle you can use the provided view controller to show the licenses.

Installation

Add LicensesViewController to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

pod 'LicensesViewController', '~> 0.6.3'

Then tell Pod to install it:

$ pod install

Grab credits.py from this repo and add it to your project.

Usage

Add the build script as described above and make sure the resulting plist is included in the app target.

import LicensesViewController

// ...

let licensesController = LicensesViewController()
licensesController.loadPlist(NSBundle.mainBundle(), resourceName: "Credits")

// ...

Example Project

git clone https://github.com/carloe/LicenseGenerator-iOS.git
cd LicenseGenerator-iOS/Example
pod install
open LicensesViewControllerExample.xcworkspace

Requirements

  • iOS 8.0
  • tvOS 9.0
  • Swift 4.0

Contact

Twitter: @carloeugster Email: carlo@relaun.ch

License

MIT