From a0a5dff6093028fcaef866064126ab4acac2becd Mon Sep 17 00:00:00 2001
From: Yanndroid
Date: Tue, 21 Dec 2021 19:33:33 +0100
Subject: [PATCH 1/4] README.md update
---
README.md | 86 ++++++++++++++++++++-----------------------------------
1 file changed, 31 insertions(+), 55 deletions(-)
diff --git a/README.md b/README.md
index 142039cd..b3ba3afe 100644
--- a/README.md
+++ b/README.md
@@ -142,6 +142,8 @@ dependencies {
+If you encounter problems with Proguard (missing classes), see this [Issue](https://github.com/Yanndroid/OneUI-Design-Library/issues/53) by [AlirezaIvaz](https://github.com/AlirezaIvaz).
+
## Usage
In general, most of the views are styled automatically when you apply ```android:theme="@style/OneUITheme"``` in AndroidManifest.xml, the usage of the custom views in the library however is needed to achieve the best results.
@@ -200,7 +202,7 @@ In general, most of the views are styled automatically when you apply ```android
```
-The children of this view can be at four different location: on the **main screen**, in the **drawer**, in the **footer** (useful for views like BottomNavigationView) or in the **appbar header** as a custom title. To specify the location of each child you can set the attribute ```app:layout_location``` of the child to either ```main_content``` (default), ```drawer_panel```, ```footer``` or ```appbar_header```.
+The children of this view can be at five different location: on the **main screen**, in the **drawer**, in the **footer** (useful for views like BottomNavigationView), in the **appbar header** as a custom title or in the **root layout** (views like FAB). To specify the location of each child you can set the attribute ```app:layout_location``` of the child to either ```main_content``` (default), ```drawer_panel```, ```footer```, ```appbar_header``` or ```root```.
```app:toolbar_title``` and ```app:toolbar_subtitle``` can be used to set the title and subtitle of the AppBar and Toolbar. The AppBar status is set to expanded by default, you can simply set ```app:toolbar_expanded``` to false if you want it to be collapsed. On small screens/dpi the toolbar will not expand.
@@ -222,7 +224,7 @@ public void setDrawerButtonIcon(Drawable drawerIcon)
public void setDrawerButtonTooltip(CharSequence tooltipText)
public void setDrawerButtonOnClickListener(OnClickListener listener)
```
-Toolbar methods. (for more use ```getToolbarLayout()``` and it's methods)
+Toolbar methods. (for more, use ```getToolbarLayout()``` and it's methods)
```java
public void setToolbarTitle(CharSequence title)
public void setToolbarTitle(CharSequence expandedTitle, CharSequence collapsedTitle)
@@ -239,8 +241,6 @@ Open/close the drawer panel with an optional animation.
public void setDrawerOpen(Boolean open, Boolean animate)
```
-See [Advanced](#Advanced) for even more methods.
-
### ToolbarLayout
"Ready-to-go" Samsung's AppBar.
@@ -259,7 +259,7 @@ See [Advanced](#Advanced) for even more methods.
```
-The children of this view can be at three different location: on the **main screen**, in the **footer** (useful for views like BottomNavigationView) or in the **appbar header** as a custom title. To specify the location of each child you can set the attribute ```app:layout_location``` of the child to either ```main_content``` (default), ```footer``` or ```appbar_header```.
+The children of this view can be at four different location: on the **main screen**, in the **footer** (useful for views like BottomNavigationView), in the **appbar header** as a custom title or in the **root layout** (views like FAB). To specify the location of each child you can set the attribute ```app:layout_location``` of the child to either ```main_content``` (default), ```footer```, ```appbar_header``` or ```root```.
```app:title``` and ```app:subtitle``` can be used to set the title and subtitle of the AppBar and Toolbar. The AppBar status is set to expanded by default, you can simply set ```app:toolbar_expanded``` to false if you want it to be collapsed. You can also disable totally the CollapsingToolbar by setting ```app:toolbar_expandable``` to false. On small screens/dpi the toolbar will not expand anyway.
@@ -297,22 +297,12 @@ public void setNavigationButtonVisible(boolean visible)
public void setNavigationButtonBadge(int count)
public void setNavigationOnClickListener(OnClickListener listener)
```
-Manage the Toolbar Menu. In the Menu resource file use ```app:showAsAction="always"``` to show the item as a Action instead of in the popup menu. Changing the Icon or the Visibility won't do anything if this item isn't a Action.
+Manage the Toolbar Menu. In the Menu resource file use ```app:showAsAction="always"``` to show the item as a Action instead of in the popup menu.
```java
-public void inflateToolbarMenu(@MenuRes int resId)
+public void inflateToolbarMenu(Menu menu)
+public void inflateToolbarMenu(@MenuRes int menuRes)
public Menu getToolbarMenu()
public void setOnToolbarMenuItemClickListener(OnMenuItemClickListener listener)
-
-public void setOverflowMenuBadge(MenuItem item, Integer badge)
-public Integer getOverflowMenuBadge(MenuItem item)
-
-public void setToolbarMenuItemIcon(MenuItem item, Drawable drawable)
-public void setToolbarMenuItemIcon(MenuItem item, @DrawableRes int resId)
-public void setToolbarMenuItemTitle(MenuItem item, CharSequence title) //title = tooltip
-public void setToolbarMenuItemVisibility(MenuItem item, boolean visible)
-public void setToolbarMenuItemEnabled(MenuItem item, boolean enabled)
-
-public ToolbarImageButton getToolbarMenuItemView(MenuItem item)
```
SelectMode. Changes the layout of the Toolbar to the one you can see in any Samsung app, when you long click a list item. This will show a "All" checkbox, "x selected" counter as the title and a bottom menu (see [screenshot](readme-resources/screenshots/toolbarlayout_selectmode.png)). In the Menu resource file for the bottom menu use ```app:showAsAction="always"``` to show the item as a Action instead of in the "more" menu.
```java
@@ -323,28 +313,34 @@ public void setSelectModeCount(int count)
public void setSelectModeAllChecked(boolean checked)
public void setSelectModeAllCheckedChangeListener(CompoundButton.OnCheckedChangeListener listener)
+public void setSelectModeBottomMenu(Menu menu, OnMenuItemClickListener listener)
public void setSelectModeBottomMenu(@MenuRes int menuRes, OnMenuItemClickListener listener)
public Menu getSelectModeBottomMenu()
```
-SearchMode. Changes the layout of the Toolbar to a Search layout, with a text field and a voice input icon. (see [screenshot](readme-resources/screenshots/toolbarlayout_searchmode.png))
+SearchMode. Changes the layout of the Toolbar to a Search layout, with a text field and a voice input icon (see [screenshot](readme-resources/screenshots/toolbarlayout_searchmode.png)).
```java
public void showSearchMode()
public void dismissSearchMode()
public boolean isSearchMode()
public void setSearchModeListener(SearchModeListener listener)
-
-public void onSearchModeVoiceInputResult(ActivityResult result)
-
-//for the voice input to work you need to add this in your activity/fragment:
-private ActivityResultLauncher activityResultLauncher;
+```
+:warning: For the voice input to work, you need to add this in your activity/fragment:
+ ```java
+ private ActivityResultLauncher activityResultLauncher;
//onCreate:
activityResultLauncher = registerForActivityResult(new ActivityResultContracts.StartActivityForResult(), result -> toolbarLayout.onSearchModeVoiceInputResult(result));
//setSearchModeListener - onVoiceInputClick
activityResultLauncher.launch(intent);
+ ```
+Also add this in your manifest for api 30+:
+```xml
+
+
+
+
+
```
-See [Advanced](#Advanced) for even more methods.
-
### SplashView
The activity you are gonna use for SplashView has a different style than the rest of the application, so you need to add this ```android:theme="@style/OneUISplashTheme"``` to your splash activity in AndroidManifest.
@@ -393,8 +389,6 @@ Listener for the Splash Animation
public void setSplashAnimationListener(Animation.AnimationListener listener)
```
-See [Advanced](#Advanced) for even more methods.
-
2) A simple Splash View without animation. (Samsung apps use their own ```com.samsung.android.startingwindow.LAYOUT_RESID_FOR_MASS``` flag in manifest)
@@ -425,8 +419,6 @@ Returns the text of the Splash TextView
public String getText()
```
-See [Advanced](#Advanced) for even more methods.
-
### AboutPage
A layout that looks like and has the same functions as the About Screen in any Samsung app. Like the [SplashView](#SplashView), the activity you're gonna use has a different style than the rest of the application, so you need to add this ```android:theme="@style/OneUIAboutTheme"``` to your About Activity in AndroidManifest.
@@ -468,8 +460,6 @@ public void setUpdateButtonOnClickListener(OnClickListener listener)
public void setRetryButtonOnClickListener(OnClickListener listener)
```
-See [Advanced](#Advanced) for even more methods.
-
### SwitchBarLayout
This is a extended [ToolbarLayout](#ToolbarLayout) with [SwitchBar](#SwitchBar). Useful for creating inner preferences layouts in pair with [SwitchPreferenceScreen](#SwitchPreferenceScreen).
@@ -508,8 +498,6 @@ Expand or collapse the toolbar with an optional animation.
public void setToolbarExpanded(boolean expanded, boolean animate)
```
-See [Advanced](#Advanced) for even more methods.
-
### CoordinatorLayout
Samsung's CoordinatorLayout
```xml
@@ -739,7 +727,7 @@ Control the state (colored, bold text).
```java
public void setButtonSelected(Boolean selected)
public void toggleButtonSelected()
-public Boolean isButtonSelcted()
+public Boolean isButtonSelected()
```
Enable/disable the OptionButton.
```java
@@ -1100,21 +1088,21 @@ Samsung's Radio Preferences used in Light/Dark mode Settings and Resolution Sett
Create a PopupMenu with it's anchor.
```java
-//de.dlyt.yanndroid.oneui.view.PopupMenu
+//de.dlyt.yanndroid.oneui.menu.PopupMenu
PopupMenu popupMenu = new PopupMenu(view);
```
-Inflate a menu resource or a list of the items to show.
+Inflate a menu resource or a Menu (de.dlyt.yanndroid.oneui.menu.Menu).
```java
public void inflate(@MenuRes int menuRes)
-public void inflate(ArrayList
-
A library for Android, useful for creating Samsung's OneUI styled apps. This library contains a theme which will apply for most views (see [which](#Progress)) in your layout, and some custom OneUI views. The text which is in the custom views is translated to 90 languages, so you don't need to worry for these. Android 5.0 (api 21) and above are supported, the library also has Dark mode, Landscape, Tablet, DeX and RTL support. This library has been tested in Android Studio, but should work in other IDEs too. You can download and install the latest apk of the sample app [here](https://github.com/Yanndroid/OneUI-Design-Library/raw/master/app/release/app-release.apk). Suggestions, improvements and help are always welcome.
+
A library for Android, useful for creating Samsung's OneUI styled apps. This library contains a theme which will apply for most views (see [which](#Progress)) in your layout, and some custom OneUI views. The text which is in the custom views is translated to 90 languages, so you don't need to worry for these. Android 5.0 (api 21) and above are supported, the library also has Dark mode, Landscape, Tablet, DeX and RTL support. This library has been tested in Android Studio, but should work in other IDEs too. You can download and install the latest apk of the sample app [here](https://github.com/Yanndroid/OneUI-Design-Library/raw/master/app/release/app-release.apk). You can also check out my other apps for more examples on how to use this library. Suggestions, improvements and help are always welcome.
Huge thanks to [BlackMesa123](https://github.com/BlackMesa123) who has contributed a lot to this project.
-Excuse my bad english, feel free to correct it. :)
-
- [Screenshots](#Screenshots)
- [Installation](#Installation)
-- [Usage](#Usage)
+- [Documentation](#Documentation)
- [Progress](#Progress)
- [Changelog](#Changelog)
- [More info](#More-info)
@@ -36,7 +34,7 @@ v2.0.0 and future versions are (and only will be) available on mavenCentral. For
1. Add the dependency to build.gradle (Module: ...)
```gradle
dependencies {
- implementation 'io.github.yanndroid:oneui:2.1.1'
+ implementation 'io.github.yanndroid:oneui:2.2.0'
...
}
```
@@ -144,7 +142,7 @@ dependencies {
If you encounter problems with Proguard (missing classes), see this [Issue](https://github.com/Yanndroid/OneUI-Design-Library/issues/53) by [AlirezaIvaz](https://github.com/AlirezaIvaz).
-## Usage
+## Documentation
In general, most of the views are styled automatically when you apply ```android:theme="@style/OneUITheme"``` in AndroidManifest.xml, the usage of the custom views in the library however is needed to achieve the best results.
- [DrawerLayout](#DrawerLayout)
@@ -1242,7 +1240,7 @@ The sample app icon for example:
### OneUI 4
-Starting with v2.1.0, the new OneUI 4 design is being added to this library. Since Samsung hasn't released a stable version yet and still has a lot of stuff to fix, only some views are (partly) using the new style. As long as OneUI 4 is beta, this feature will also be, so don't expect too much. All the views which don't have the new style yet will use the old one (OneUI 3) instead. If you already want to use the OneUI 4 style, instead of ```@style/OneUITheme```, ```@style/OneUIAboutTheme``` and ```@style/OneUISplashTheme``` use ```@style/OneUI4Theme```, ```@style/OneUI4AboutTheme``` and ```@style/OneUI4SplashTheme``` in your manifest file.
+Starting with v2.1.0, the new OneUI 4 design is being added to this library and v2.2.0 makes it the default theme of the library. If you still want to use the OneUI 3 style, instead of ```@style/OneUITheme```, ```@style/OneUIAboutTheme``` and ```@style/OneUISplashTheme``` use ```@style/OneUI3Theme```, ```@style/OneUI3AboutTheme``` and ```@style/OneUI3SplashTheme``` in your manifest file. All the views which don't have the new style yet will use the old one (OneUI 3) instead.
## Progress
@@ -1276,6 +1274,22 @@ Starting with v2.1.0, the new OneUI 4 design is being added to this library. Sin
## Changelog
+
+2.2.0
+
+- OneUI4++ (huge thanks to [BlackMesa123](https://github.com/BlackMesa123))
+ - AppBar/Toolbar
+ - Edge effect
+ - TabLayout/BottomNavigationView
+ - SwipeRefreshLayout
+ - EditText
+ - and more...
+- ToolbarLayout & PopupMenu/Menu improvements
+- icons++ (OneUI4)
+- fixes & minor changes
+
+
+
2.1.1
diff --git a/app/release/app-release.apk b/app/release/app-release.apk
index 007e8562ab1096e941788d454d471f78031c8e94..b2f7f7cc08cac52749f201f0c4ff4a766336685c 100644
GIT binary patch
literal 5733111
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