/SDTheme

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

Primary LanguageObjective-CMIT LicenseMIT

SDTheme

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

效果图

Demo运行效果图

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

使用方法非常简单:

初始化:

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

SDTheme-WhiteSDTheme-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.plistImages.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" COMBINE_HIDPI_IMAGES 设置为 "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⭐。您的支持将鼓励我们继续创作!⭐⭐⭐