Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/acrocat/EverLayout
Reusable, downloadable, up-datable iOS layouts
https://github.com/acrocat/EverLayout
autolayout cocoapods interface-builder ios json swift ui xcode
Last synced: about 2 months ago
JSON representation
Reusable, downloadable, up-datable iOS layouts
- Host: GitHub
- URL: https://github.com/acrocat/EverLayout
- Owner: acrocat
- License: mit
- Created: 2017-02-04T14:16:52.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-11-24T17:28:08.000Z (almost 7 years ago)
- Last Synced: 2024-07-17T12:55:24.530Z (2 months ago)
- Topics: autolayout, cocoapods, interface-builder, ios, json, swift, ui, xcode
- Language: Swift
- Homepage: https://acrocat.github.io/EverLayout/
- Size: 2.36 MB
- Stars: 102
- Watchers: 5
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EverLayout
EverLayout translates JSON/XML data into iOS layouts which can be downloaded, reused and updated at runtime.
[](https://github.com/Carthage/Carthage)
[](https://cocoapods.org/)
## 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.
## Docs
More detailed documentation [here](https://acrocat.github.io/EverLayout/).
The documentation was most recently updated for version 0.9.3.
## Requirements
* iOS 8.0+
* Xcode 8.2
* Swift 3
# Installation
#### Cocoapods
Add EverLayout to your `Podfile`
```
platform :ios, '8.0'
use_frameworks!
pod 'Everlayout'
```
#### Carthage
Create a Cartfile that lists the framework and run carthage update.
```
github "acrocat/EverLayout"
```
#### EverLayout Bridge
EverLayout Bridge can be installed via Node Package Manager.
```
npm install -g ever-layout-bridge
```
More info [here](https://www.github.com/acrocat/everlayoutbridge)
## 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?.build(onView: self.view, viewEnvironment: self)
}
}
```
## Bridge 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.
## 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](https://hackernoon.com/building-and-distributing-ios-layouts-with-everlayout-c9ea41750f6#.b41s5bsh7)
[Downloading an iOS Layout](https://medium.com/@greatirl/downloading-an-ios-layout-a9b0ede80809)
## Contribute
Contributions to EverLayout are welcome! If you have feature requests please raise an issue, or contact me at [[email protected]](mailto:[email protected]), or [@greatirl](http://www.twitter.com/greatirl).