4.4.1

Author: molicechen

QMUIConfigurationTemplate/QMUIConfigurationTemplate.m

@@ -51,6 +51,11 @@ - (void)applyConfigurationTemplate {
     QMUICMI.testColorGreen = UIColorMakeWithRGBA(0, 255, 0, .3);
     QMUICMI.testColorBlue = UIColorMakeWithRGBA(0, 0, 255, .3);
 
+    #pragma mark - QMUILog
+    QMUICMI.shouldPrintDefaultLog = YES;                                        // ShouldPrintDefaultLog : 是否允许输出 QMUILogLevelDefault 级别的 log
+    QMUICMI.shouldPrintInfoLog = YES;                                           // ShouldPrintInfoLog : 是否允许输出 QMUILogLevelInfo 级别的 log
+    QMUICMI.shouldPrintWarnLog = YES;                                           // ShouldPrintInfoLog : 是否允许输出 QMUILogLevelWarn 级别的 log
+    QMUICMI.shouldPrintQMUIWarnLogToConsole = NO;                              // ShouldPrintQMUIWarnLogToConsole : 是否在出现 QMUILogWarn 时自动把这些 log 以 QMUIConsole 的方式显示到设备屏幕上
 
     #pragma mark - UIControl
 
@@ -244,11 +249,6 @@ - (void)applyConfigurationTemplate {
     QMUICMI.windowLevelQMUIAlertView = UIWindowLevelAlert - 4.0;                // UIWindowLevelQMUIAlertView : QMUIModalPresentationViewController、QMUIPopupContainerView 里使用的 UIWindow 的 windowLevel
     QMUICMI.windowLevelQMUIConsole = 1;                                         // UIWindowLevelQMUIConsole : QMUIConsole 内部的 UIWindow 的 windowLevel
 
-    #pragma mark - QMUILog
-    QMUICMI.shouldPrintDefaultLog = YES;                                        // ShouldPrintDefaultLog : 是否允许输出 QMUILogLevelDefault 级别的 log
-    QMUICMI.shouldPrintInfoLog = YES;                                           // ShouldPrintInfoLog : 是否允许输出 QMUILogLevelInfo 级别的 log
-    QMUICMI.shouldPrintWarnLog = YES;                                           // ShouldPrintInfoLog : 是否允许输出 QMUILogLevelWarn 级别的 log
-    
     #pragma mark - QMUIBadge
 
     QMUICMI.badgeBackgroundColor = UIColorRed;                                  // BadgeBackgroundColor : QMUIBadge 上的未读数的背景色

QMUIKit.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = "QMUIKit"
-  s.version          = "4.4.0"
+  s.version          = "4.4.1"
   s.summary          = "致力于提高项目 UI 开发效率的解决方案"
   s.description      = <<-DESC
                        QMUI iOS 是一个致力于提高项目 UI 开发效率的解决方案，其设计目的是用于辅助快速搭建一个具备基本设计还原效果的 iOS 项目，同时利用自身提供的丰富控件及兼容处理， 让开发者能专注于业务需求而无需耗费精力在基础代码的设计上。不管是新项目的创建，或是已有项目的维护，均可使开发效率和项目质量得到大幅度提升。
@@ -266,10 +266,6 @@ Pod::Spec.new do |s|
       sss.source_files = 'QMUIKit/QMUIComponents/QMUISegmentedControl.{h,m}'
     end
 
-    ss.subspec 'QMUISlider' do |sss|
-      sss.source_files = 'QMUIKit/QMUIComponents/QMUISlider.{h,m}'
-    end
-
     ss.subspec 'QMUITableViewCell' do |sss|
       sss.source_files = 'QMUIKit/QMUIComponents/QMUITableViewCell.{h,m}'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIButton'
@@ -307,7 +303,6 @@ Pod::Spec.new do |s|
       sss.dependency 'QMUIKit/QMUIComponents/QMUILabel'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIPopupContainerView'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIPopupMenuView'
-      sss.dependency 'QMUIKit/QMUIComponents/QMUISlider'
       sss.dependency 'QMUIKit/QMUIComponents/QMUITextField'
       sss.dependency 'QMUIKit/QMUIComponents/QMUITextView'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIToastView'
@@ -331,7 +326,6 @@ Pod::Spec.new do |s|
       sss.dependency 'QMUIKit/QMUIResources'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIEmptyView'
 			sss.dependency 'QMUIKit/QMUIComponents/QMUIButton'
-			sss.dependency 'QMUIKit/QMUIComponents/QMUISlider'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIPieProgressView'
       sss.dependency 'QMUIKit/QMUIComponents/QMUIAssetLibrary'
     end

QMUIKit/QMUIComponents/NavigationBarTransition/UINavigationBar+Transition.m

@@ -76,6 +76,8 @@ - (void)setQmuinb_copyStylesToBar:(UINavigationBar *)copyStylesToBar {
     weakContainer.object = copyStylesToBar;
     objc_setAssociatedObject(self, &kAssociatedObjectKey_copyStylesToBar, weakContainer, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
 
+    if (!copyStylesToBar) return;
+    
 #ifdef IOS15_SDK_ALLOWED
     if (@available(iOS 15.0, *)) {
         copyStylesToBar.standardAppearance = self.standardAppearance;

QMUIKit/QMUIComponents/NavigationBarTransition/UINavigationController+NavigationBarTransition.m

@@ -118,6 +118,9 @@ + (void)load {
                         if (shouldCustomNavigationBarTransition) {
                             disappearingViewController.qmuinb_shouldShowTransitionBar = YES;
                             appearingViewController.qmuinb_shouldShowTransitionBar = YES;
+                            
+                            // 只绑定即将显示的 vc 的 bar，注意可能在 setNavigationBarHidden: 里被覆盖，引起下述问题：
+                            // https://github.com/Tencent/QMUI_iOS/issues/1335
                             weakNavigationController.navigationBar.qmuinb_copyStylesToBar = appearingViewController.transitionNavigationBar;
                         }
                     }
@@ -164,7 +167,7 @@ + (void)load {
                     if (hidden) {
                         [selfObject.topViewController removeTransitionNavigationBar];
                     } else {
-                        [selfObject.topViewController addTransitionNavigationBarIfNeeded];
+                        [selfObject.topViewController addTransitionNavigationBarAndBindNavigationBar:YES];
                     }
                 }
             };
@@ -214,7 +217,7 @@ + (void)load {
     });
 }
 
-- (void)addTransitionNavigationBarIfNeeded {
+- (void)addTransitionNavigationBarAndBindNavigationBar:(BOOL)shouldBind {
     // add 时虽然过滤了 navigationBarHidden 的条件，但可能在 push/pop 时，新界面暂时还没刷新导航栏的显隐状态，所以还是需要在 viewWillLayoutSubviews 那边再重新根据 navigationBarHidden 的值来决定是否隐藏假 bar
     if (!self.qmuinb_shouldShowTransitionBar || self.transitionNavigationBar || !self.navigationController.navigationBar || self.navigationController.navigationBarHidden) {
         return;
@@ -234,8 +237,10 @@ - (void)addTransitionNavigationBarIfNeeded {
     }
 #endif
     [self.view addSubview:customBar];
-    customBar.originalNavigationBar = self.navigationController.navigationBar;
-    
+    customBar.originalNavigationBar = self.navigationController.navigationBar;// 注意这里内部不会保留真 bar 和假 bar 的 copy 关系
+    if (shouldBind) {
+        self.navigationController.navigationBar.qmuinb_copyStylesToBar = customBar;
+    }
     [self layoutTransitionNavigationBar];
 }
 
@@ -561,7 +566,7 @@ - (BOOL)prefersNavigationBarBackgroundViewHidden {
 - (void)setQmuinb_shouldShowTransitionBar:(BOOL)shouldShowTransitionBar {
     objc_setAssociatedObject(self, &kAssociatedObjectKey_shouldShowTransitionBar, @(shouldShowTransitionBar), OBJC_ASSOCIATION_RETAIN_NONATOMIC);
     if (shouldShowTransitionBar) {
-        [self addTransitionNavigationBarIfNeeded];
+        [self addTransitionNavigationBarAndBindNavigationBar:NO];// 这里不绑定 bar，因为不知道此时是两个 vc 里的哪一个
         self.prefersNavigationBarBackgroundViewHidden = YES;
     } else {
         [self removeTransitionNavigationBar];

QMUIKit/QMUIComponents/QMUIMarqueeLabel.h

@@ -65,3 +65,29 @@
  */
 - (BOOL)requestToStopAnimation;
 @end
+
+
+@interface UILabel (QMUI_Marquee)
+
+/**
+ 是否开启系统自带的跑马灯效果（系统的只能控制开启/关闭，无法控制速度、停顿等，更多功能可以使用 @c QMUIMarqueeLabel ，但论性能还是系统的更优。
+ 
+ 用法：
+ [label qmui_startNativeMarquee];
+ [label qmui_stopNativeMarquee]; // 当你需要停止动画时，调用这个方法（如果业务只关心什么时候开启，不关心什么时候结束，则从头到尾都可以不用调用这个方法）
+ 
+ @note 当开启该属性时，会强制把 numberOfLines 设置为1，clipsToBounds 设置为 YES。如果你是在 reuse view 内使用（例如 UITableViewCell/UICollectionViewCell），需要手动在 will display 时  start，did end display 时 stop。
+ */
+- (void)qmui_startNativeMarquee;
+
+/**
+ 停止跑马灯效果，与 @c qmui_startNativeMarquee 不需要成对出现，也即如果业务不关心什么时候停止动画，可以从头到尾都不调用这个方法。
+ */
+- (void)qmui_stopNativeMarquee;
+
+/**
+ 系统的跑马灯效果是否正在运行，默认为 NO。
+ */
+@property(nonatomic, assign, readonly) BOOL qmui_nativeMarqueeRunning;
+
+@end

QMUIKit/QMUIComponents/QMUIMarqueeLabel.m

@@ -266,3 +266,53 @@ - (BOOL)requestToStopAnimation {
 }
 
 @end
+
+@implementation UILabel (QMUI_Marquee)
+
+- (void)dealloc {
+    [self qmuimq_removeObserver];
+}
+
+- (void)qmui_startNativeMarquee {
+    // 系统有 _startMarqueeIfNecessary、_startMarquee，但直接开启的方法其实是 marqueeRunning
+    BOOL running = YES;
+    self.numberOfLines = 1;
+    self.clipsToBounds = YES;
+    [self qmui_performSelector:NSSelectorFromString(@"setMarqueeEnabled:") withArguments:&running, nil];
+    [self qmui_performSelector:NSSelectorFromString(@"setMarqueeRunning:") withArguments:&running, nil];
+    [self qmuimq_removeObserver];
+    [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(qmuimq_handleApplicationDidEnterBackground:) name:UIApplicationDidEnterBackgroundNotification object:nil];
+    [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(qmuimq_handleApplicationDidBecomeActive:) name:UIApplicationDidBecomeActiveNotification object:nil];
+}
+
+- (void)qmui_stopNativeMarquee {
+    // 系统有 _stopMarqueeWithRedisplay:，但直接关闭的方法其实是 marqueeRunning
+    BOOL running = NO;
+    [self qmui_performSelector:NSSelectorFromString(@"setMarqueeRunning:") withArguments:&running, nil];
+    [self qmui_performSelector:NSSelectorFromString(@"setMarqueeEnabled:") withArguments:&running, nil];
+    [self qmuimq_removeObserver];
+}
+
+- (BOOL)qmui_nativeMarqueeRunning {
+    BOOL running = NO;
+    [self qmui_performSelector:NSSelectorFromString(@"marqueeRunning") withPrimitiveReturnValue:&running];
+    return running;
+}
+
+- (void)qmuimq_handleApplicationDidEnterBackground:(NSNotification *)notification {
+    [self qmui_bindBOOL:self.qmui_nativeMarqueeRunning forKey:@"QMUI_Marquee_Running"];
+}
+
+- (void)qmuimq_handleApplicationDidBecomeActive:(NSNotification *)notification {
+    if ([self qmui_getBoundBOOLForKey:@"QMUI_Marquee_Running"]) {
+        [self qmui_stopNativeMarquee];// 要手动停止一次才能重新 start
+        [self qmui_startNativeMarquee];
+    }
+}
+
+- (void)qmuimq_removeObserver {
+    [NSNotificationCenter.defaultCenter removeObserver:self name:UIApplicationDidEnterBackgroundNotification object:nil];
+    [NSNotificationCenter.defaultCenter removeObserver:self name:UIApplicationDidBecomeActiveNotification object:nil];
+}
+
+@end

QMUIKit/QMUIComponents/QMUISlider.h

@@ -21,6 +21,7 @@
 
 @interface QMUITableViewCell() <UIScrollViewDelegate>
 
+@property(nonatomic, assign) BOOL initByTableView;
 @property(nonatomic, assign, readwrite) QMUITableViewCellPosition cellPosition;
 @property(nonatomic, assign, readwrite) UITableViewCellStyle style;
 @property(nonatomic, strong) UIImageView *defaultAccessoryImageView;
@@ -32,13 +33,16 @@ @implementation QMUITableViewCell
 
 - (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier {
     if (self = [super initWithStyle:style reuseIdentifier:reuseIdentifier]) {
-        [self didInitializeWithStyle:style];
+        if (!self.initByTableView) {
+            [self didInitializeWithStyle:style];
+        }
     }
     return self;
 }
 
 - (instancetype)initForTableView:(UITableView *)tableView withStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier {
-    if (self = [super initWithStyle:style reuseIdentifier:reuseIdentifier]) {
+    self.initByTableView = YES;
+    if (self = [self initWithStyle:style reuseIdentifier:reuseIdentifier]) {// 这里需要调用 self 的 initWithStyle，而不是 super，目的是为了让业务在重写 init 方法时可以沿用系统默认的思路，去重写 initWithStyle:reuseIdentifier:，但在 vc 里使用 cell 时又可以直接调用 initForTableView:withStyle:。
         self.parentTableView = tableView;
         [self didInitializeWithStyle:style];// 因为设置了 parentTableView，样式可能都需要变，所以这里重新执行一次 didInitializeWithStyle: 里的 qmui_styledAsQMUITableViewCell
     }
@@ -303,6 +307,7 @@ - (void)handleAccessoryButtonEvent:(QMUIButton *)detailButton {
 @implementation QMUITableViewCell(QMUISubclassingHooks)
 
 - (void)didInitializeWithStyle:(UITableViewCellStyle)style {
+    self.initByTableView = NO;
     _cellPosition = QMUITableViewCellPositionNone;
 
     _style = style;