SDTheme 0.1.0

SDTheme 0.1.0

Maintained by SDTheme.



SDTheme 0.1.0

  • By
  • maligh and culeo

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_backgroundColorSetter方法中有根据主题配置调用系统的相应方法,然后对控件注册监听,等切换主题之后就会收到通知,然后执行theme_didChanged方法,为控件设置正确的主题UI,That’s all~