Dynamico

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' }
}
}

2. 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/projects/dynamico/logo.png",
"cache":true
}
},
{ "class":"android.widget.TextView",
"attributes":{ "text":"Yo!",
"textColor":"#FF69B4"
}
}
]
}

2. 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>

3. Initialize Dynamico by passing it:

• URL = Link to JSON layout directory
• name = Name of JSON layout file
• layout = Wrapper layout that will contain loaded views

newDynamico("http://ecloga.org/projects/dynamico",
"activity_main",
findViewById(R.id.mainLayout))
.initialize();

3b. Initialize Dynamico by passing it:

• JSONStringBuilder = JSON string inside a StringBuilder directory
• name = Name of JSON layout so it can be use for cache porpuses file
• layout = Container layout that will contain the loaded views from the json

StringBuildersb = newStringBuilder("{\n" +
" \"views\":[\n" +
" { \n" +
" \"class\":\"android.widget.TextView\",\n" +
" \"attributes\":{ \n" +
" \"text\":\"Sample text\",\n" +
" \"textColor\":\"#FF69B4\"\n" +
" }\n" +
" },\n" +
" { \n" +
" \"class\":\"android.widget.ImageView\",\n" +
" \"attributes\":{\n" +
" \"src\": \"https://cdn69.picsart.com/186273671000202.jpg?r1024x1024\"\n" +
" }\n" +
" }\n" +
" ]\n" +
"}");
newDynamico(sb,
"activity_main",
findViewById(R.id.mainLayout))
.initialize();

Manual

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

Additional features

• Event listener

setListener(newLayoutStateListener() {
@OverridepublicvoidonSuccess(Stringmessage) {
// everything is okay
}
@OverridepublicvoidonError(Stringmessage) {
// 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/projects/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