Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cybertk/generator-swift-framework

Scaffolds out a Xcode Embedded Framework project with Swift 2
https://github.com/cybertk/generator-swift-framework

Last synced: about 2 months ago
JSON representation

Scaffolds out a Xcode Embedded Framework project with Swift 2

Awesome Lists containing this project

README

        

# generator-swift-framework

> Scaffolds out a Xcode Embedded Framework project with Swift 2.0

[![Build Status](http://img.shields.io/travis/cybertk/generator-swift-framework.svg?style=flat)](https://travis-ci.org/cybertk/generator-swift-framework)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
[![Dependency Status](https://david-dm.org/cybertk/generator-swift-framework.svg)](https://david-dm.org/cybertk/generator-swift-framework)
[![devDependency Status](https://david-dm.org/cybertk/generator-swift-framework/dev-status.svg)](https://david-dm.org/cybertk/generator-swift-framework#info=devDependencies)
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

generator-swift-framework is used to create a Xcode [Embedded Framework](https://developer.apple.com/library/ios/documentation/General/Conceptual/ExtensibilityPG/ExtensionScenarios.html) project with the following features:

- Embedded Framework template
- Unit Test template based on [Nimble](https://github.com/quick/nimble)
- Example App template
- Swift 2.0 syntax
- Manage dependencies with [Carthage][]
- Support distribution via [CocoaPods](http://cocoapods.com) and [Carthage][]
- MIT License
- Test suites to cover distributions and fundamentals with `make test`
- [Scripts](https://github.com/cybertk/ios-build-scripts) for working on CLI and CI integration
- Optional Travis CI integration
- Optional Apple Development Certification provisioning

[Carthage]: https://github.com/carthage/carthage

## Getting Started

To install the latest stable version of generator-swift-framework from npm, run:

```bash
npm install -g generator-swift-framework
```

Make a new directory for the framework, and cd into it:

```bash
mkdir my-new-framework && cd $_
```

Then, initiate the generator via [Yeoman][]:

```bash
yo swift-framework
```

generator-swift-framework is actually a [Yeoman Generator](#yeoman-generators).

[Yeoman]: http://yeoman.io

### What is Yeoman?

Trick question. It's not a thing. It's this guy:

![](http://i.imgur.com/JHaAlBJ.png)

Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.

Not every new computer comes with a Yeoman pre-installed. He lives in the [npm](https://npmjs.org) package repository. You only have to ask for him once, then he packs up and moves into your hard drive. *Make sure you clean up, he likes new and shiny things.*

```bash
npm install -g yo
```

### Yeoman Generators

Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.

## Contributions

To install the development branch

```
npm install -g github:cybertk/generator-swift-framework#branch/name
```

See [Contribution Guide](CONTRIBUTING.md) for more details.

## License

generator-swift-framework is available under the MIT license.