Infrared

Introduction

Infrared is library for iOS development which allows control of app's UI, Interaction and resources.
How is this achieved:

• UI:
  instead of defining it in ObjC code and Storyboard, Infrared uses JSON description files
• Interaction:
  handling user's interaction is done in JavaScript
  (Interaction can also be handled in ObjC.)
• Resources:
  all resources used by app can be updated at any time. This includes localization, images, files, fonts, etc.

JSON UI example

Label component:

{
  "id" : "label_id",
  "type" : "label",
  "backgroundColor" : "#ff000080",
  "text" : "IR Label",
  "textAlignment" : "NSTextAlignmentCenter",
  "textColor" : "#ffffffaa",
  "font" : "SystemBold, 16"
}

JavaScript example

IR.controller({
    "data" : {
        "text_1" : 'value 1',
        "text_2" : 'value 2',
        "color"  : '#ffffff'
    },
    "actionMethod" : function () {
        // do some UI/Interaction/Data manipulation
    }
});

App Structure

Entry point for Infrared based app is App.json where files for defining UI, Interaction and Resources are listed.

App.json Example

{
  "id": "app_name",
  "screens": [
    {
      "deviceType": "phone",
      "path": "lending_screen.json",
      "controller" : "lending_screen_plugin.js"
    },
    {
      "deviceType": "phone",
      "path": "signin_and_singup_screen.json",
      "controller" : "signin_and_singup_screen_plugin.js"
    }
  ],
  "jsLibraries" : [
    "data_storage.js", "data_processing.js", "network_communication.js"
  ],
  "mainScreenId": "lending_screen_id",
  "i18n" : {
    "default" : "en",
    "languages" : {
      "en" : "en.json",
      "fr" : "fr.json"
    }
  },
  "version": 2
}

Setup

Simplest way is to use podfile and initiate library in AppDelegate.

Podfile

pod "Infrared"

###Code in AppDelegate

If whole app should be as Infrared app (rootViewController automatically set with mainScreenId as indicated in app.json) use following method:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds];

    [[Infrared sharedInstance] buildInfraredAppFromPath:@"app.json"];

    return YES;
}

If Infrared View Controllers are just part of whole iOS app user following method:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds];

    [[Infrared sharedInstance] buildInfraredAppFromPath:@"app.json" setRootViewController:NO];

    return YES;
}

Documentation

Detailed documentation can be find in project's wiki page

---

IMPORTANT:

• master branch is for development
• tags are for stable versions

---

License

Infrared iOS libarary (infrared_ios) is released under the Apache License, Version 2.0. See LICENSE.