Dynamic Support

A complete library to build apps for Android 14+ (ICS or above) devices with a built-in theme engine. It is built on top of the latest app compat library to provide best compatibility.

Dynamic-Supportv

Since v2.0.0, it uses AndroidX so, first migrate your project to AndroidX.

Installation

It can be installed by adding the following dependency to your build.gradle file:

dependencies {
    // For AndroidX enabled projects.
    implementation 'com.pranavpandey.android:dynamic-support:2.2.0'

    // For legacy projects.
    implementation 'com.pranavpandey.android:dynamic-support:1.3.0'
}

Usage

It is a collection of activities, fragments, widgets, views and some utility functions required to
build a standard Android app. It also provides some in-built use cases like an intro screen,
drawer activity, about screen, collapsing app bar, bottom navigation, color picker, multiple
locales, runtime permissions, etc. which can be used and customised according to the need.

For complete reference, please read the documentation.

Theme engine

Each activity and widget can be themed by using the in-built theme engine with background aware
functionality to avoid any visibility issues. Colors can be selected by using the provided
material design colors or by selecting a custom
color from the in-built picker which supports HEX, HSV and ARGB values.

Background aware

Below are the same colors applied on the light and dark backgrounds respectively. But the final
color is adjusted according to the colored view background to provide best visibility.

Dynamic-Supportvv

Sample

This library is fully commented so, please check the individual classes or files for the
documentation. Basic documentation will be available soon.

Checkout the sample to know more about the basic implementation.

Proguard

This library uses reflection at some places to theme widgets at runtime. So, their original name
must be preserved to theme them properly. It will automatically apply the appropriate rules if
proguard is enabled in the project.

The following rules will be applied by this library:

dependencies {
    # Keep application class.
    -keep public class * extends android.app.Application
    
    # Keep methods in Activity that could be used in the XML.
    -keepclassmembers class * extends android.app.Activity {
       public void *(android.view.View);
    }
    
    # Keep support library classes.
    #-keep class androidx.appcompat.widget.** { *; }
    #-keep class android.support.v4.widget.** { *; }
    #-keep class android.support.v7.widget.** { *; }
    #-keep class android.support.design.widget.** { *; }
    #-keep class android.support.design.internal.** { *; }
    
    # Keep AndroidX classes.
    -keep class androidx.core.widget.** { *; }
    -keep class androidx.appcompat.view.menu.** { *; }
    -keep class androidx.recyclerview.widget.** { *; }
    -keep class androidx.viewpager.widget.** { *; }
    
    # Keep Material Components classes.
    -keep class com.google.android.material.internal.** { *; }
    -keep class com.google.android.material.navigation.** { *; }
    -keep class com.google.android.material.textfield.** { *; }
    
    # Keep all the Dynamic Support models.
    -keep class com.pranavpandey.android.dynamic.support.model.** { *; }
    
    # Gson uses generic type information stored in a class file when working with fields.
    # Proguard removes such information by default, so configure it to keep all of it.
    -keepattributes Signature
    
    # For using GSON @Expose annotation
    -keepattributes *Annotation*
    
    # Gson specific classes
    -keep class sun.misc.Unsafe { *; }
    -keep class com.google.gson.** { *; }
}

Apps using Dynamic Support

All of my apps are using some or all part of this library. You can download them from Play Store.
Please email me if you are using this library and want to feature your app here. Also, please
checkout the Rotation app to experience the full potential of this library.

Translations

  • German (de) - Flubberlutsch
  • Indonesian (in) - Gamal Kevin A
  • Italian (it) - Nicola
  • Spanish (es) - Dave
  • Turkish (tr) - Fatih Fırıncı
  • Chinese (Simplified) (zh-rCN) - John Canny

GitHub