EverLayout 0.9.2

EverLayout 0.9.2

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

Maintained by Dale Webster.


Downloads

Total155
Week27
Month71

Installs

Apps22
Apps WeekApps This Week 4
Test Targets1
Test WeekTests This week 1
powered by Segment

GitHub

Stars69
Watchers5
Forks0
Issues1
Contributors1
Pull Requests0

Code

Files42
LOCLines of Code 2,091


  • By
  • Dale Webster

EverLayout

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

Contribute

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