以下是2018年10月23日更新
经过大约一个月的时间的适配,项目正式使用XCode10(以下简称为10 or XC10)大部分库都升级为Swift4.2(以下简称为 4.2 or S4.2),下面是适配过程中遇到的一些坑。
1. Swift4、Swift4.2混编
如果你对项目是小的独立项目,完全可以全部升级为4.2,你可以略过第一条;如果你依赖了一些第三方的库,且没有升级4.2,你可以继续看这一条。目前测试的结果来看,Swift4 和 S4.2的混编没有什么大的问题,如果你是通过cocoapod引入的可以在Podfile中加入如下代码:
swift_41_pod_targets = ['your_target_name']
post_install do |installer|installer.pods_project.targets.each do |target|if swift_41_pod_targets.include?(target.name)target.build_configurations.each do |config|config.build_settings['SWIFT_VERSION'] = '4.1'endendend
end
复制代码
2. NSDataAsset
升级XC10和S.2之前,项目里面有些对 'NSDataAsset' 的错误使用: 用‘NSDataAsset’读ImageAsset中的图片,这个是不正确的,但是却可以工作,这次升级修复了这个BUG。
正确的做法使用'DataAsset',然后才可以用‘NSDataAsset’读取数据,我由于不够认真且经验不足还以为是个BUG,给Apple提了个BUG。。。[捂脸]
3. 第三方库的重命名 typealias
为了方便的适配S4.2对UIKit中的重命名,有些第三方使用typealias对一些类型进行了重命名,以 RxSwift 为例子,RxSwift中就有如下代码:
public typealias UIControlEvents = UIControl.Event private
复制代码
这会导致一些重命名的类型即使不改也不会报错,但是一旦去掉了对某个库的依赖就会引入新的问题。
4.Delegate 的 Access Modifier
在升级S4.2过程中,XC偶尔会提示需要给某些Delegate方法添加 private修饰符,不要为了消除这个⚠️添加private,可能会导致Delegate永远不被调到;另外,如果是一个public或者open的class,协议方法记得也要加上public,否则会出一样的问题,具体原因我还在测试,但是现象是这样的,有新的见解欢迎评论区讨论。
5. 机型适配问题,iPhone XS Max字体变大
有些同事遇到XC9构建的安装包在iPhone XS Max上会有字体变大的情况,这个貌似是普遍现象,微信也有,使用XC10构建安装包可以解决这个问题,但是会遇到问题6
###6. iOS9.3以下系统Crash率飙升 使用XC10构建安装包可以解决问题5,但是iOS9.3以下的系统Crash到让你怀疑人生
以下是2018年9月18日内容
AVAudioSession.sharedInstance().setCategory()
disappeared
Swift 4.2 中 iOS10以下不能用 AVAudioSession.sharedInstance() setCategory
可选方案:
- 使用OC实现该部分,然后使用Swift调用
- 放弃 iOS9用户体验
参考地址
do {if #available(iOS 11.0, *) {try audioSession.setCategory(.playback, mode: .default, policy: .longForm, options: [])} else if #available(iOS 10.0, *) {try audioSession.setCategory(.playback, mode: .default, options: [])} else {// Compiler error: 'setCategory' is unavailable in Swifttry audioSession.setCategory(AVAudioSession.Category.playback)}
} catch let error {print("Unable to configure audio sesson category: \(error)")
}
复制代码
NSUnderlineStyle(.patternSolid、.none)
disappeared
可选方案:
Wrong: mutableAttributedString.addAttribute(NSAttributedString.Key.underlineStyle, value: [], range: range) Right: mutableAttributedString.addAttribute(NSAttributedString.Key.underlineStyle, value: 0, range: range)
下面是Rename操作
UIKit
#Swift4/UIKit
UITableViewCell
| Swift 4 | Swift 4.2 |
|---|
| UITableViewCellStyle | UITableViewCell.CellStyle |
UIEvent
| Swift 4 | Swift 4.2 |
|---|
| UIEventSubtype | UIEvent.EventSubtype |
UITableView
| Swift 4 | Swift 4.2 |
|---|
| UITableViewScrollPosition | UITableView.ScrollPosition |
| UITableViewAutomaticDimension | UITableView.automaticDimension |
| UITableViewCellEditingStyle | UITableViewCell.EditingStyle |
| UITableViewRowAnimation | UITableView.RowAnimation |
| UITableViewStyle | UITableView.Style |
| UITableViewCellAccessoryType | UITableViewCell.AccessoryType |
UIControl
| Swift 4 | Swift 4.2 |
|---|
| UIControlEvents | UIControl.Event |
UIWindow
| Swift 4 | Swift 4.2 |
|---|
| UIWindowLevelAlert | UIWindow.Level.alert |
| UIKeyboardFrameEndUserInfoKey | UIResponder.keyboardFrameEndUserInfoKey |
| UIKeyboardFrameBeginUserInfoKey | UIResponder.keyboardFrameBeginUserInfoKey |
| UIKeyboardAnimationDurationUserInfoKey | UIResponder.keyboardAnimationDurationUserInfoKey |
| UIKeyboardAnimationCurveUserInfoKey | UIResponder.keyboardAnimationCurveUserInfoKey |
| UIKeyboardIsLocalUserInfoKey | UIResponder.keyboardIsLocalUserInfoKey |
| UIWindowDidBecomeVisible | UIWindow.didBecomeVisibleNotification |
| UIWindowDidBecomeHidden | UIWindow.didBecomeHiddenNotification |
| UIWindowDidBecomeKey | UIWindow.didBecomeKeyNotification |
| UIWindowDidResignKey | UIWindow.didResignKeyNotification |
| UIKeyboardWillShow | UIResponder.keyboardWillShowNotification |
| UIKeyboardDidShow | UIResponder.keyboardDidShowNotification |
| UIKeyboardWillHide | UIResponder.keyboardWillHideNotification |
| UIKeyboardDidHide | UIResponder.keyboardDidHideNotification |
UIViewController
| Swift 4 | Swift 4.2 |
|---|
| open func addChildViewController(_ childController: UIViewController) | open func addChild(_ childController: UIViewController) |
| open func willMove(toParentViewController parent: UIViewController?) | open func willMove(toParent parent: UIViewController?) |
| open func didMove(toParentViewController parent: UIViewController?) | open func didMove(toParent parent: UIViewController?) |
| open func removeFromParentViewController() | open func removeFromParent() |
UIActivity
| Swift 4 | Swift 4.2 |
|---|
| UIActivityType | UIActivity.ActivityType |
UIActivityIndicatorView
| Swift 4 | Swift 4.2 |
|---|
| activityIndicator.activityIndicatorViewStyle | activityIndicator.style |
UIAlertController
| Swift 4 | Swift 4.2 |
|---|
| UIAlertActionStyle | UIAlertAction.Style |
| UIAlertControllerStyle | UIAlertController.Style |
UIPageViewController
| Swift 4 | Swift 4.2 |
|---|
| UIPageViewControllerNavigationDirection | UIPageViewController.NavigationDirection |
| UIPageViewControllerSpineLocation | UIPageViewController.SpineLocation |
| UIPageViewControllerNavigationOrientation | UIPageViewController.NavigationOrientation |
| UIPageViewControllerTransitionStyle | UIPageViewController.TransitionStyle |
| UIPageViewControllerOptionsKey | UIPageViewController.OptionsKey |
UINavigationController
| Swift 4 | Swift 4.2 |
|---|
| UINavigationControllerOperation | UINavigationController.Operation |
UIGestureRecognizer
| Swift 4 | Swift 4.2 |
|---|
| UIGestureRecognizerStatePossible | UIGestureRecognizer.State.possible |
| UIGestureRecognizerStateBegan | UIGestureRecognizer.State.began |
| UIGestureRecognizerStateChanged | UIGestureRecognizer.State.changed |
| UIGestureRecognizerStateEnded | UIGestureRecognizer.State.ended |
| UIGestureRecognizerStateCancelled | UIGestureRecognizer.State.cancelled |
| UIGestureRecognizerStateFailed | UIGestureRecognizer.State.failed |
| UIGestureRecognizerStateRecognized | UIGestureRecognizer.State.recognized |
NSLayoutFormat
| Swift 4 | Swift 4.2 |
|---|
| NSLayoutFormatOptions | NSLayoutConstraint.FormatOptions |
UIEdgeInsets
| Swift 4 | Swift 4.2 |
|---|
| public func UIEdgeInsetsMake(_ top: CGFloat, _ left: CGFloat, _ bottom: CGFloat, _ right: CGFloat) -> UIEdgeInsets | UIEdgeInsets(top: CGFloat, left: CGFloat, bottom: CGFloat, right: CGFloat) |
| public func UIEdgeInsetsInsetRect(_ rect: CGRect, _ insets: UIEdgeInsets) -> CGRect | public func inset(by insets: UIEdgeInsets) -> CGRect |
UIFontDescriptor
| Swift 4 | Swift 4.2 |
|---|
| UIFontDescriptorSymbolicTraits | UIFontDescriptor.SymbolicTraits |
UIImage
| Swift 4 | Swift 4.2 |
|---|
UIKIT_EXTERN NSData * __nullable UIImagePNGRepresentation(UIImage * __nonnull image); | public func pngData() -> Data? |
NSData * __nullable UIImageJPEGRepresentation(UIImage * __nonnull image, CGFloat compressionQuality); | public func jpegData(compressionQuality: CGFloat) -> Data? |
UIApplication
| Swift 4 | Swift 4.2 |
|---|
| UIApplicationDidEnterBackground | UIApplication.didEnterBackgroundNotification |
| UIApplicationWillEnterForeground | UIApplication.willEnterForegroundNotification |
| UIApplicationDidFinishLaunching | UIApplication.didFinishLaunchingNotification |
| UIApplicationDidBecomeActive | UIApplication.didBecomeActiveNotification |
| UIApplicationWillResignActive | UIApplication.willResignActiveNotification |
| UIApplicationDidReceiveMemoryWarning | UIApplication.didReceiveMemoryWarningNotification |
| UIApplicationWillTerminate | UIApplication.willTerminateNotification |
| UIApplicationSignificantTimeChange | UIApplication.significantTimeChangeNotification |
| UIApplicationWillChangeStatusBarOrientation | UIApplication.willChangeStatusBarOrientationNotification |
| UIApplicationDidChangeStatusBarOrientation | UIApplication.didChangeStatusBarOrientationNotification |
| UIApplicationDidChangeStatusBarFrame | UIApplication.didChangeStatusBarFrameNotification |
| UIApplicationBackgroundRefreshStatusDidChange | UIApplication.backgroundRefreshStatusDidChangeNotification |
| UIApplicationProtectedDataWillBecomeUnavailable | UIApplication.protectedDataWillBecomeUnavailableNotification |
| UIApplicationProtectedDataDidBecomeAvailable | UIApplication.protectedDataDidBecomeAvailableNotification |
| UIApplicationUserDidTakeScreenshot | UIApplication.userDidTakeScreenshotNotification |
| UIApplicationOpenSettingsURLString | UIApplication.openSettingsURLString |
| UIApplicationLaunchOptionsKey | UIApplication.LaunchOptionsKey |
| UIInterfaceOrientationIsLandscape() | UIApplication.shared.statusBarOrientation.isLandscape |
UIView
| Swift 4 | Swift 4.2 |
|---|
func bringSubview(toFront view: UIView) | func bringSubviewToFront(_ view: UIView) |
| UIViewAnimationOptions | UIView.AnimationOptions() |
Foundation
NSAttributedString
| Swift 4 | Swift 4.2 |
|---|
| NSAttributedStringKey | NSAttributedString.Key |
QuartzCore
CAShapeLayer
| Swift 4 | Swift 4.2 |
|---|
| kCALineCapRound | CAShapeLayerLineCap.round |
| kCALineCapButt | CAShapeLayerLineCap.butt |
| kCALineCapSquare | CAShapeLayerLineCap.square |
| kCALineJoinMiter | CAShapeLayerLineJoin.miter |
| kCALineJoinRound | CAShapeLayerLineJoin.round |
| kCALineJoinBevel | CAShapeLayerLineJoin.bevel |
| kCAFillRuleNonZero | CAShapeLayerFillRule.nonZero |
| kCAFillRuleEvenOdd | CAShapeLayerFillRule.evenOdd |
参考资料
Swift-Migration-4.2