dynamico

Project Url: jelic98/dynamico
Introduction: Android library for inflating dynamic layouts in runtime based on JSON configuration fetched from server
More: Author   ReportBugs   
Tags:

License

Android library for inflating dynamic layouts in runtime based on JSON configuration fetched from server. Useful in situations when layouts need to change without updating the app.

Advanced features

  • Targeting specific devices by brand, model and Android API version
  • Layout changes based on configuration fields

Installing

  1. Add repository in root build.gradle
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
  1. Add the dependency
dependencies {
    compile 'com.github.jelic98:dynamico:1.2.0'
}

Usage

  1. Create JSON layout and upload it somewhere
{
  "views":[  
    {  
      "class":"android.widget.ImageView",
      "attributes":{  
        "layout_width":"wrap_content",
        "layout_height":"wrap_content",
        "src":"http://ecloga.org/dynamico/logo.png",
        "cache":true
      }
    },
    {  
      "class":"android.widget.TextView",
      "attributes":{  
        "text":"Yo!",
        "textColor":"#FF69B4"
      }
    }
  ]
}
  1. Create XML wrapper layout that will contain loaded views
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:id="@+id/mainLayout">

    <!-- Dynamic content will be added here -->
</LinearLayout>
  1. Initialize Dynamico by passing it:
  2. URL = Link to JSON layout directory
  3. name = Name of JSON layout file
  4. layout = Wrapper layout that will contain loaded views
new Dynamico("http://ecloga.org/dynamico",
    "activity_main",
    findViewById(R.id.mainLayout))
    .initialize();

Done. For advanced usage, take a look at this awesome manual.

Additional features

  • Event listener
setListener(new LayoutStateListener() {
    @Override
    public void onSuccess(String message) {
        // everything is okay
    }

    @Override
    public void onError(String message) {
        // notify user
    }
})
  • Loading from cache (skip layout fetching from server)
setOptions(CACHE_ONLY)
  • Non-stop layout fetching
setOptions(NON_STOP) // use with setAsyncPause(long millis)

Documentation

public Dynamico(String url, String name, ViewGroup layout) throws DynamicoException

One and only constructor

  • Parameters:
    • url — URL of directory where JSON layout file is located (for example, "http://ecloga.org/dynamico")
    • name — JSON layout file name with or without extension (for example, "activity_main")
    • layout — wrapper layout that will contain inflated layout from JSON file (for example, findViewById(R.id.mainLayout))
  • Exceptions: DynamicoException — if any of passed parameters is null
public Dynamico setListener(DynamicoListener listener)

Attaches event listener to Dynamico object

  • Parameters: listener — listener for success and error events caused by network, storage, etc.
  • Returns: Dynamico object ready for initialization
public Dynamico setOptions(DynamicoOptions.Option ... options)

Attaches options to Dynamico object

  • Parameters: options — options for Dynamico (for example, ONLY_CACHE)
  • Returns: Dynamico object ready for initialization
public void initialize()

Starts layout fetching from cache/server depending on provided options

TODO

  • Support vector drawables
  • Support more views
Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea