Introduction

Infrared is library for iOS development which allows control of app's UI, Interaction and resource.
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.