Unofficial OneUI Design Library (OneUI 7 & 6)

This design lib is consists of custom components intended to complement and integrate with both SESL Android Jetpack Modules and SESL Material Components for Android.

Usage

• Declare the needed github maven and authentication for SESL Android Jetpack Modules and SESL Material Components for Android dependencies to your project following their usage guide. Then add the following next:

repositories {
  //other remote repositories
  
   maven {
      url = uri("https://maven.pkg.github.com/tribalfs/oneui-design")
      credentials {
          username = "<gh_username>"
          password = "<gh_access_token>"
      }
   } 
}

dependencies {
  //sesl and other dependencies

  //For OneUI 8 - must use sesl8 dependencies
  //coming soon
  
  //For OneUI 7 - must use sesl7 dependencies
  implementation("io.github.tribalfs:oneui-design:0.7.10+oneui7")
    
  //For OneUI 6 - must use sesl6 dependencies
  implementation("io.github.tribalfs:oneui-design:0.6.3+oneui6")
}

• Add the the following to your app's AndroidManifest file:

<application
        ...
        android:theme="@style/OneUITheme">

        <!-- This enables your app to apply the OneUI device's color pallete.
         Note: android:value corresponds to the filename of the xml file
         that needs to be added to the res/xml folder. Filename can be different.-->
        <meta-data
            android:name="theming-meta"
            android:value="meta_998_sesl_app" />

</application>

• Create theme mata data xml file (e.g. meta_998_sesl_app.xml) with the following content and add it to the app's res/xml folder:

<?xml version="1.0" encoding="utf-8"?>
<ThemeMetaData FormatVersion="1.3" GuideVersion="1.4">
  <AppMetaData Name="<Any name>" TargetApi="21" TargetPackageName="<app.package.name>" VersionCode="1" VersionName="">
    <Include RefName="SESL" />

  </AppMetaData>
</ThemeMetaData>

• API documentation (WIP)

Sample apps

• OneUI7 Sample (widgets showcase) | Download APK
• OneUI6 Sample (widgets showcase) | Download APK

Credits

• Google for their Jetpack and Material Components libraries.
• Samsung for their awesome OneUI Design.
• Yanndroid and Salvo Giangreco who created the OneUI4 Design library where this repository came from.