{"id":19390909,"url":"https://github.com/vvsdevs/androiddynamiclayoutloader","last_synced_at":"2025-08-05T06:19:37.225Z","repository":{"id":165936624,"uuid":"641365676","full_name":"vvsdevs/AndroidDynamicLayoutLoader","owner":"vvsdevs","description":"🚀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.🚀","archived":false,"fork":false,"pushed_at":"2023-05-18T10:05:02.000Z","size":1523,"stargazers_count":6,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T17:51:41.033Z","etag":null,"topics":["android","androiddynamiclayoutloader","androidxml","dynamic","dynamicdesigns","dynamiclayout","dynamiclayoutloader","java","kotlin","remote","remoteandroidxml","remotedesign","remotexml","xml"],"latest_commit_sha":null,"homepage":"https://vvsdevs.github.io/AndroidDynamicLayoutLoader/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vvsdevs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-05-16T10:17:27.000Z","updated_at":"2025-01-09T21:58:33.000Z","dependencies_parsed_at":"2023-09-25T01:48:30.337Z","dependency_job_id":null,"html_url":"https://github.com/vvsdevs/AndroidDynamicLayoutLoader","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"e485a4110e0d7ecc88cf71da35f5683d14891ddc"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvsdevs%2FAndroidDynamicLayoutLoader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvsdevs%2FAndroidDynamicLayoutLoader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvsdevs%2FAndroidDynamicLayoutLoader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvsdevs%2FAndroidDynamicLayoutLoader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vvsdevs","download_url":"https://codeload.github.com/vvsdevs/AndroidDynamicLayoutLoader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248819350,"owners_count":21166472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","androiddynamiclayoutloader","androidxml","dynamic","dynamicdesigns","dynamiclayout","dynamiclayoutloader","java","kotlin","remote","remoteandroidxml","remotedesign","remotexml","xml"],"created_at":"2024-11-10T10:23:56.476Z","updated_at":"2025-04-14T03:51:12.561Z","avatar_url":"https://github.com/vvsdevs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![](https://jitpack.io/v/vvsdevs/AndroidDynamicLayoutLoader.svg)](https://jitpack.io/#vvsdevs/AndroidDynamicLayoutLoader)\n[![API](https://img.shields.io/badge/API-19%2B-orange.svg?style=flat)](https://android-arsenal.com/api?level=19)\n \n# DynamicLayoutLoader\n\nIntroducing the AndroidDynamicLayoutLoader library, a powerful solution for seamlessly inflating dynamic layouts at runtime using JSON configurations obtained from a server. This library proves invaluable in scenarios where layouts require modification without the need for updating the entire application.\n\nBy leveraging the DynamicLayoutLoader library, developers can effortlessly adapt their app's UI in real-time, ensuring a dynamic user experience. With the ability to fetch JSON configurations from a server, it becomes a breeze to incorporate layout changes on-the-fly without necessitating a full app update.\n\nStay ahead of the curve with this groundbreaking Android library, enabling you to effortlessly handle ever-changing layout requirements. Experience the ease and flexibility of runtime layout inflation, powered by the DynamicLayoutLoader library.\n\n## Advanced features\n\n* Targeting specific devices by brand, model and Android API version\n* Layout changes based on configuration fields\n\nSome of Designs\n\nResults | Login Screen\n--- | ---\n![LOGIN SCREEN](https://raw.githubusercontent.com/vvsdevs/AndroidDynamicLayoutLoader/master/DemoLayout/src/main/assets/results.jpg) | ![LOGIN SCREEN](https://raw.githubusercontent.com/vvsdevs/AndroidDynamicLayoutLoader/master/DemoLayout/src/main/assets/login_screen.jpg)\n\n## Installing\n\n1. Add repository in root ```build.gradle```\n\n```gradle\nallprojects {\n    repositories {\n        maven { url 'https://jitpack.io' }\n    }\n}\n```\n\n2. Add the dependency\n\n```gradle\n    implementation 'com.github.vvsdevs:AndroidDynamicLayoutLoader:v1.0.0'\n```\n\n3. Add below 2 permissions\n````\n    \u003cuses-permission android:name=\"android.permission.INTERNET\" /\u003e\n    \u003cuses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\" /\u003e\n````\n\n\n## Usage\n\n1. Create JSON layout and upload it somewhere\n\n```json\n{\n  \"views\":[  \n    {  \n      \"class\":\"android.widget.ImageView\",\n      \"attributes\":{  \n        \"layout_width\":\"wrap_content\",\n        \"layout_height\":\"wrap_content\",\n        \"src\":\"https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png\",\n        \"cache\":true\n      }\n    },\n    {  \n      \"class\":\"android.widget.TextView\",\n      \"attributes\":{  \n        \"text\":\"Yo!\",\n        \"textColor\":\"#FF69B4\"\n      }\n    }\n  ]\n}\n```\n\n2. Create XML wrapper layout that will contain loaded views\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n\u003cLinearLayout\n\txmlns:android=\"http://schemas.android.com/apk/res/android\"\n\tandroid:layout_width=\"match_parent\"\n\tandroid:layout_height=\"match_parent\"\n\tandroid:orientation=\"vertical\"\n\tandroid:id=\"@+id/mainLayout\"\u003e\n\t\t\n\t\u003c!-- Dynamic content will be added here --\u003e\n\u003c/LinearLayout\u003e\n```\n\n3. Initialize DynamicLayoutLoader by passing it:\n* URL = Link to JSON layout **directory**\n* name = Name of JSON layout **file**\n* layout = Wrapper layout that will contain loaded views\n\n```java\n   try {\n        new LayoutUpdater(\"https://raw.githubusercontent.com/vvsdevs/AndroidDynamicLayoutLoader/master/DemoLayout/src/main/assets/\",\n        \"login_screen\",\n        findViewById(R.id.mainLayout))\n        .initialize();\n        } \n        catch (DynamicException e) {\n        e.printStackTrace();\n      }\n```\n\n## Manual\n\nFor advanced usage, take a look at this awesome [manual](https://github.com/vvsdevs/AndroidDynamicLayoutLoader/blob/master/MANUAL.md).\n\n## Additional features\n\n* Event listener\n\n```java\nsetListener(new LayoutStateListener() {\n\t@Override\n\tpublic void onSuccess(String message) {\n\t\t// everything is okay\n\t}\n\t\n\t@Override\n\tpublic void onError(String message) {\n\t\t// notify user\n\t}\n})\n```\n\n* Loading from cache (skip layout fetching from server)\n\n```java\nsetOptions(CACHE_ONLY)\n```\n\n* Non-stop layout fetching\n\n```java\nsetOptions(NON_STOP) // use with setAsyncPause(long millis)\n```\n\n## Documentation\n\n###### `public DynamicLayoutLoader(String url, String name, ViewGroup layout) throws DynamicLayoutLoaderException`\n\nOne and only constructor\n\n * **Parameters:**\n   * `url` — URL of directory/folder where JSON layout file is located (for example, \"https://raw.githubusercontent.com/vvsdevs/AndroidDynamicLayoutLoader/master/DemoLayout/src/main/assets/\")\n   * `name` — JSON layout file name with or without extension (for example, \"login_screen\") (* Don't add example. \"login_screen.json\")\n   * `layout` — wrapper layout that will contain inflated layout from JSON file (for example, findViewById(R.id.mainLayout))\n * **Exceptions:** `DynamicLayoutLoaderException` — if any of passed parameters is null\n\n###### `public DynamicLayoutLoader setListener(DynamicLayoutLoaderListener listener)`\n\nAttaches event listener to DynamicLayoutLoader object\n\n * **Parameters:** `listener` — listener for success and error events caused by network, storage, etc.\n * **Returns:** DynamicLayoutLoader object ready for initialization\n\n###### `public DynamicLayoutLoader setOptions(DynamicLayoutLoaderOptions.Option ... options)`\n\nAttaches options to DynamicLayoutLoader object\n\n * **Parameters:** `options` — options for DynamicLayoutLoader (for example, ONLY_CACHE)\n * **Returns:** DynamicLayoutLoader object ready for initialization\n\n###### `public void initialize()`\n\nStarts layout fetching from cache/server depending on provided options\n\n## TODO\n\n* Support vector drawables\n* Support more views\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvsdevs%2Fandroiddynamiclayoutloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvvsdevs%2Fandroiddynamiclayoutloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvsdevs%2Fandroiddynamiclayoutloader/lists"}