EverLayout 0.6.0

EverLayout 0.6.0

DocsDocumented
TestsTested
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Apr 2017
SwiftSwift Version 3.0
SPMSupports SPM

Maintained by Dale Webster.


Downloads

Total83
Week1
Month20

Installs

Apps17
Apps WeekApps This Week 1
powered by Segment

GitHub

Stars69
Watchers6
Forks0
Issues0
Contributors1
Pull Requests0

Code

Files43
SizeIntegration Size 244 kb
FrameworkCreates Framework
LOCLines of Code 2,125


  • By
  • Dale Webster

EverLayout translates JSON/XML data into iOS layouts which can be downloaded, reused and updated at runtime.

Features

  • Create comprehensive layouts without the clumsiness of Interface Builder or view controllers bloated with layout code.
  • Downloadable layouts - Layouts written in JSON/XML can be downloaded from a web server, meaning an App UI can be updated without having to submit for App Review.
  • Build layouts with real-time update using a simple HTTP server (or EverLayout Bridge).
  • A/B Testing - Testing multiple UIs with your users is easy when building a layout is just loading a file.

Requirements

  • iOS 8.0+
  • Xcode 8.2
  • Swift 3

Installation

EverLayout Bridge

EverLayout Bridge can be installed via Node Package Manager.

npm install -g ever-layout-bridge

More info here

Usage Example

Layout file

{
    "name":"ViewController",
    "root":{
        "views":{
            "exampleButton":{
                "constraints":{
                    "center":"@super",
                    "width":"+120",
                    "height":"+80"
                },
                "properties":{
                    "text":"Tap Me!"
                }
            }
        }
    }
}

Swift

import UIKit
import EverLayout

class ViewController: UIViewController {
    private var layout : EverLayout?
    public let exampleButton : UIButton = UIButton()

    override func viewDidLoad() {
        super.viewDidLoad()

        let layoutData = NSData(contentsOfFile: Bundle.main.path(forResource: "ViewController", ofType: "json", inDirectory: "Layouts")!) as! Data
        self.layout = EverLayout(layoutData: layoutData)
        self.layout?.buildLayout(onView: self.view, viewEnvironment: self)
    }
}

Bridge Example

Basic example

{
    "name":"ViewController",
    "root":{
        "views":{
            "!redSquare":{
                "constraints": {
                    "width height":"+180",
                    "center":"@super <24"
                },
                "properties":{
                    "backgroundColor":"red"
                }
            }
        }
    }
}

Here I am running a blank application in the simulator side-by-side with a ViewController layout described in JSON, which is loaded by the default View Controller. The app has connected to EverLayout Bridge which is serving it layout updates ever time I save the layout file.

In the example I am just changing the properties of a UIView to show how layouts can be designed/built without having to re-compile the app.

Docs

More detailed documentation here.

Discussion

At the moment EverLayout is more of an experiment than a solution. The idea was born through frustration of Interface Builder and the existing alternative of clunky layout code.

The goal of this project is to find a middle ground which can offer the real-time 'visual' approach of IB, and the flexibility and re-usability of layouts described with code.

Further Reading

Building and distributing iOS Layouts with EverLayout

Dependencies

At the moment EverLayout uses Socket.IO for communication with EverLayout Bridge.

Contribute

Contributions to EverLayout are welcome! If you have feature requests please raise an issue, or contact me at [email protected], or @greatirl.