Need help with SDTheme?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

SlashDevelopers
136 Stars 32 Forks MIT License 15 Commits 0 Opened issues

Description

一款轻量级的iOS皮肤主题切换方案

Services available

!
?

Need anything else?

Contributors list

SDTheme

Build Status https://github.com/SlashDevelopers/SDTheme/blob/master/LICENSE codebeat badge

效果图

Demo运行效果图

Demo做的有点丑,大家多忍耐一下😅

使用方法非常简单:

初始化:

[[SDThemeManager sharedInstance] setupThemeNameArray:@[@"SDTheme-White", @"SDTheme-Black"]];

SDTheme-White
SDTheme-Black
是资源主题Bundle的名称,下面会说到资源Bundle的引入方法。

切换主题:

[[SDThemeManager sharedInstance] changeTheme:@"SDTheme-Black"];

具体设置皮肤:

具体调用非常简单,比如需要换肤的视图控件原本是调用

backgroundColor
设置颜色,只需要换成调用扩展方法
theme_backgroundColor
即可,例如:
self.view.theme_backgroundColor = @"block_bg";
self.textField.theme_textColor = @"text_h1";
self.image.theme_image = @"icon_face";
富文本需要用
SDThemeForegroundColorAttributeName
替换
NSForegroundColorAttributeName
,例如:
navBar.theme_titleTextAttributes = @{SDThemeForegroundColorAttributeName:@"text_h1"};

另外有些常用的属性在XIB等可视化视图也可以直接设置,例如:

如果直接设置属性的方式不满足需求,还可以自己监听通知

SDThemeChangedNotification
,收到通知之后自行做颜色图标等切换。

资源管理

颜色字符串和图片是放在单独的Bundle里面进行管理的,所以刚开始要新建自己的主题Bundle. Bundle中 新建

ColorsMap.plist
Images.xcassets
* 图片:就放在相应的主题bundle中的Images.xcassets管理,图片在不同主题下名字要保证一致。 * 颜色字符串:颜色字符串可以参考一下Demo中的文件,首先要有一个大分类,例如Demo中的
block、text、line
(跟随自己需要分类就好,这里的分类我是扒竞品
富途牛牛
的🤠),如果你有一个分类叫
SomeThing
,那分类下内容命名要带上相应的前缀
SomeThing_
,不然会报找不到,
color string
是HEX 或者AHEX格式。

Bundle 创建注意事项:

资源bundle不要直接新建文件夹之后改扩展名或者用Settings Bundle

推荐Bundle创建方式:

file
->
New
->
Target
->
macOS
->
Bundle

创建完成之后,对 Base SDK 设置为 iOS Build Active Architecture Only 设置为 "YES" Installation Directory    删除掉后面的路径 Code Signing Identity   选择 Don't Code Sign   iOS Deployment Target 设置为 合适的版本 Skip Install 设置为 "NO" Strip Debug Symbols During Copy 设置为 "YES" COMBINEHIDPIIMAGES 设置为 "NO" 再设置一下依赖 好,到现在Bundle就完成了

主要实现原理:

其实实现原理也是非常简单的,我这里拿

UIView
举例子:
@interface UIView (SDTheme)

@property (nonatomic, copy) NSString *theme_backgroundColor; @property (nonatomic, copy) IBInspectable NSString *sd_background; @property (nonatomic, copy) NSString *theme_tintColor;

@en

这是针对UIView提供的扩展,大家可以看到其中有换肤属性

theme_backgroundColor
,如下图,我们在属性
theme_backgroundColor
Setter
方法中有根据主题配置调用系统的相应方法,然后对控件注册监听,等切换主题之后就会收到通知,然后执行
theme_didChanged
方法,为控件设置正确的主题UI,That’s all~

Mac工具

另外同事写了一个Mac小工具也顺便分享一下,找一些颜色的时候会提高一些效率。 工具图

使用的时候只要把对应的ColorMaps拖进框即可,可能第一次需要输入密码,是因为对文件执行了一个

chmod 777
的命令,目前只支持两个,代码在这里,有大佬有兴趣的欢迎扩展,欢迎RP。 * 双击Cell 可以快速拿到对应颜色的key到剪贴板,直接
Ctrl+V
到项目代码中即可。 * 在菜单栏-Eidt->Add Color 可以快捷添加颜色

成品可以在这里直接下载到


⭐⭐⭐如果觉得本仓库对您有帮助,请不要吝啬你的Star⭐。您的支持将鼓励我们继续创作!⭐⭐⭐

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.