iOS11-Adaptation 项目常见问题解决方案

iOS11-Adaptation 项目常见问题解决方案

iOS11-Adaptation iOS11-Adaptation iOS 11 && iPhone X适配 项目地址: https://gitcode.com/gh_mirrors/io/iOS11-Adaptation

项目基础介绍

iOS11-Adaptation 是一个专注于 iOS 11 和 iPhone X 适配的开源项目。该项目的主要目的是帮助开发者解决在 iOS 11 和 iPhone X 上开发应用时遇到的各种适配问题。项目的主要编程语言是 Objective-C，但也可能包含一些 Swift 代码。

新手使用项目时的注意事项

1. 安全区域适配问题

问题描述：
在 iOS 11 中，苹果引入了 Safe Area Layout Guide 来替代之前的 Top Layout Guide 和 Bottom Layout Guide。如果开发者没有正确适配 Safe Area，可能会导致界面元素被遮挡或布局错乱。

解决步骤：

1. 检查 Storyboard 或 XIB 文件：
   确保在 Storyboard 或 XIB 文件中，取消勾选 "Use Safe Area Layout Guide" 选项，特别是在支持 iOS 8 及以下版本时。

2. 代码适配：
   如果项目中使用了自定义的 NavigationBar 或 TabBar，可以通过 additionalSafeAreaInsets 属性来调整 Safe Area 的值。例如：

   self.additionalSafeAreaInsets = UIEdgeInsetsMake(20, 0, 0, 0);
   

3. 监听 Safe Area 变化：
   在 UIView 或 UIViewController 中实现 safeAreaInsetsDidChange 或 viewSafeAreaInsetsDidChange 方法，以便在 Safe Area 发生变化时进行相应的调整。

2. UITableView 偏移问题

问题描述：
在 iOS 11 中，UITableView 可能会出现莫名其妙的偏移，通常是 20pt 或 64pt。这是由于 iOS 11 弃用了 automaticallyAdjustsScrollViewInsets 属性，并引入了 contentInsetAdjustmentBehavior 属性。

解决步骤：

1. 设置 contentInsetAdjustmentBehavior：
   在代码中设置 contentInsetAdjustmentBehavior 属性，以避免 UITableView 出现偏移。例如：

   if (@available(iOS 11.0, *)) {
       self.tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
   }
   

2. 使用宏定义简化代码：
   可以通过定义宏来简化代码，例如：

   #define adjustsScrollViewInsets(scrollView) \
   do { \
       if ([scrollView respondsToSelector:NSSelectorFromString(@"setContentInsetAdjustmentBehavior:")]) { \
           NSMethodSignature *signature = [UIScrollView instanceMethodSignatureForSelector:@selector(setContentInsetAdjustmentBehavior:)]; \
           NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature]; \
           NSInteger argument = 2; \
           [invocation setTarget:scrollView]; \
           [invocation setSelector:@selector(setContentInsetAdjustmentBehavior:)]; \
           [invocation setArgument:&argument atIndex:2]; \
           [invocation invoke]; \
       } \
   } while (0)
   

3. Masonry 布局适配问题

问题描述：
如果项目中使用了 Masonry 进行布局，在 iOS 11 中需要特别注意 Safe Area 的适配，否则可能会导致布局错乱。

解决步骤：

1. 检查 Masonry 版本：
   确保使用的 Masonry 版本支持 iOS 11 的 Safe Area 适配。

2. 适配 Safe Area：
   在 Masonry 布局代码中，使用 safeAreaInsets 进行适配。例如：

   if (@available(iOS 11.0, *)) {
       [view mas_makeConstraints:^(MASConstraintMaker *make) {
           make.edges.equalTo(self.view.safeAreaInsets);
       }];
   } else {
       [view mas_makeConstraints:^(MASConstraintMaker *make) {
           make.edges.equalTo(self.view);
       }];
   }
   

3. 测试不同设备：
   在不同的设备（如 iPhone X、iPhone 8 等）上测试布局，确保在不同屏幕尺寸和 Safe Area 下都能正常显示。

总结

iOS11-Adaptation 项目为开发者提供了丰富的适配方案，帮助开发者解决在 iOS 11 和 iPhone X 上开发应用时遇到的各种问题。新手在使用该项目时，需要特别注意 Safe Area 适配、UITableView 偏移问题以及 Masonry 布局适配问题，并按照上述步骤进行解决。

iOS11-Adaptation iOS11-Adaptation iOS 11 && iPhone X适配 项目地址: https://gitcode.com/gh_mirrors/io/iOS11-Adaptation