高效的 iOS 应用版本支持方法

本文为掘金投稿，译文出自：

掘金翻译计划

原文链接：

Efficient iOS Version Checking

原文作者：

Peter Steinberger

，PSPDFKit CEO & Founder，感谢作者对本篇文章的中文翻译授权。

译者：

DeadLion

校对者：

MAYDAY1993

、

Siegen

感谢译者的辛苦翻译与校对者的审校，欢迎技术投稿、约稿，给文章纠错，请发送邮件至

tangxy@csdn.net

。

极少数应用程序很“奢侈”的只支持最新版本的 iOS。设置一个较低的

部署目标

以及基于特定 iOS 版本的代码分支通常是很有必要的。虽然苹果公司的信息有些矛盾，还是有各种办法来完成这个。最近在

这条 tweet

上看到有人警告说，不要这样做：

#define IsIOS7 ([[[[UIDevice currentDevice] systemVersion] substringToIndex:1] intValue]>=7)

GitHub 搜索显示，有超过 8000 的结果

调用了
substringToIndex:1
。所有这些代码碰到 iOS 10 就“懵逼”了。因为 iOS 10 会被检测成 iOS 1 了，估计只有在越狱的应用中才会出现吧。

又是同样的老故事。

Windows 9 变成 Windows 10

是因为有

太多代码

通过
if (name.startsWith("windows 9"))
来检查 Windows 95 和 98 了。

新 API

苹果公司令人惊讶的花了相当长的时间才意识到这个问题并提供了更好的 API。iOS 8 中，终于有了一些改进！现在

NSProcessInfo

有一个新的

operatingSystemVersion

方法，更重要的是还有

- (BOOL)isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion)version

方法来检查。

if ([[NSProcessInfo processInfo] isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){.majorVersion = 9, .minorVersion = 1, .patchVersion = 0}]) {
    NSLog(@"Hello from > iOS 9.1");
}

// Using short-form for the struct, we can make things somewhat more compact:
if ([NSProcessInfo.processInfo isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){9,3,0}]) {
    NSLog(@"Hello from > iOS 9.3");
}

我们在 PSPDFKit 做了什么

PSPDFKit

是一个关于PDF的SDK，我们可以用它在PDF文档上实现查看、注释以及填写表单的功能。最开始写这个 SDK 的时候还是 iOS 4，随着一系列新 iOS 版本的发布，它也不断的在改进。那个时候还没有专门的 API 来检测版本，许多应用采用类似下面的代码：

if ([[[UIDevice currentDevice] systemVersion] isEqualToString:@"7.0"]) {
    //do stuff
}

这样用不好，所以我们从来没这样用过。比较字符串速度可能很快，但是在这种情况下是个错误的选择。正确的做法是像下面

这样

：

#define SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(v) \
  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedAscending)

if (SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(@"9.0")) {
    ...
}

这样又太笨重了，容易出错。有种更简单的方法。我们可以用

NSFoundationVersionNumber

（或者

kCFCoreFoundationVersionNumber

）来比较。系统检测开销降低到一个简单的 if 比较。不需要调用其它方法，所以它效率极高，即使在紧凑的循环中表现也不错。

if (NSFoundationVersionNumber > NSFoundationVersionNumber_iOS_9_0) {
    // do stuff for iOS 9 and newer
}
else {
    // do stuff for older versions than iOS 9
}

事实上，这正是苹果公司在

2013 构建现代应用程序技术论坛中章节 2

所建议的。

告诫：

有时候会缺少一些常量。
NSFoundationVersionNumber
是在
NSObjCRuntime.h
中定义的，作为 Xcode 7.3.1 的一部分，我们设定常数范围从 iPhone OS 2 到
#define NSFoundationVersionNumber_iOS_8_4 1144.17 -
而不是 9.0-9.3\。对于
kCFCoreFoundationVersionNumber
也一样。注意，虽然这些数字很相似，但是它们的意义是不同的，所以使用其中一个或者另外一个。

如果你做 macOS 开发的话，也可以

使用
NSAppKitVersionNumber
，它通常是更新到最新的

。

在 SDK 10（Xcode 8）苹果补充了缺少的数字，甚至还有未来的版本。

#define NSFoundationVersionNumber_iOS_9_0 1240.1
#define NSFoundationVersionNumber_iOS_9_1 1241.14
#define NSFoundationVersionNumber_iOS_9_2 1242.12
#define NSFoundationVersionNumber_iOS_9_3 1242.12
#define NSFoundationVersionNumber_iOS_9_4 1280.25
#define NSFoundationVersionNumber_iOS_9_x_Max 1299

会有 iOS 9.4 吗？考虑到 iOS 10 将在未来 3 个月内发布，而且 9.3.3 仍然是 beta 版，我估计是不会有了，但是最好还是占个坑吧。在 PSPDFKit 中，我们是使用下面的模式来定义缺少的版本号。如果代码以一个更高的最低部署目标构建，代码会自动编译，当我们遗漏了一些 iOS 版本时，这会很有帮助。

// iOS 9 compatibility
#ifndef kCFCoreFoundationVersionNumber_iOS_9_0
#define kCFCoreFoundationVersionNumber_iOS_9_0 1223.1
#endif

#define PSPDF_IS_IOS9_OR_GREATER (kCFCoreFoundationVersionNumber >= kCFCoreFoundationVersionNumber_iOS_9_0)

#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && __IPHONE_OS_VERSION_MAX_ALLOWED >= 90000
#define PSPDF_IF_IOS9_OR_GREATER(...) \
if (PSPDF_IS_IOS9_OR_GREATER) { \
PSPDF_PARTIAL_AVAILABILITY_BEGIN \
__VA_ARGS__ \
PSPDF_PARTIAL_AVAILABILITY_END }
#else
#define PSPDF_IF_IOS9_OR_GREATER(...)
#endif

#if defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && __IPHONE_OS_VERSION_MIN_REQUIRED < 90000
#define PSPDF_IF_PRE_IOS9(...)  \
if (kCFCoreFoundationVersionNumber < kCFCoreFoundationVersionNumber_iOS_9_0) { \
PSPDF_PARTIAL_AVAILABILITY_BEGIN \
__VA_ARGS__ \
PSPDF_PARTIAL_AVAILABILITY_END }
#else
#define PSPDF_IF_PRE_IOS9(...)
#endif

请注意部分可用的宏。这是添加到 SDK 9 中出现的一个警告。当我们打包进版本代码块时，这些没什么用，所以禁用它。我们有一些单独的宏，在做一些其他类型的可用性检查时会有用。我们在某些情况下使用，例如在
UICollectionView
中实现一些交互动画，在

iOS 9 中拖拽 tab 或者 page

，同时也要支持 iOS 8。

#define PSPDF_PARTIAL_AVAILABILITY_BEGIN \
_Pragma("clang diagnostic push") \
_Pragma("clang diagnostic ignored \"-Wpartial-availability\"")

#define PSPDF_PARTIAL_AVAILABILITY_END \
_Pragma("clang diagnostic pop")

为什么用这些宏

自从

前段时间我们放弃了 iOS 7

，我们可以轻易的切换到新的
isOperatingSystemAtLeastVersion:
方法上。其内部实现是通过调用
operatingSystemVersion
，是相当高效的。但它会产生更多的代码，仍然比我们现在的实现要慢一点。我没看到过基础检测的正面比较，但是可以肯定的说用了这些宏会更好，如果没有用宏的话，赶紧试试吧。

如果我们直接看
operatingSystemVersion
的实现，确实有点丑。它被缓存了，但是它通过调用
_CFCopySystemVersionDictionary()
生成版本号，然后查找
kCFSystemVersionProductVersionKey
（就是
ProductVersion
），然后对该字符串执行
componentsSeparatedByString:
。不知道为啥，我更期望这是硬编码，但是从外部字典文件读取可能更加灵活。

Swift

由于 Swift 2.0 是

支持内置版本检查的语言

，以前是这么用的：

if NSProcessInfo().isOperatingSystemAtLeastVersion(NSOperatingSystemVersion(majorVersion: 10, minorVersion: 0, patchVersion: 0)) {
    // modern code
}

现在可以用更少的代码完成同样的事：

if #available(iOS 10.0, *) {
    // modern code
} else {
    // Fallback on earlier versions
}

Swift 还适用于代码块中 API 调用的可用性检查

，所以我们保证了编译时安全，在 Objective-C 是无法轻易做到的。在

“Swift in Practice” (WWDC 2015, Session 411) 8：40

开始，一名苹果工程师详细介绍了这一特性。

那么，Swift 底层是怎样实现的？好在它是开源的而且有着良好的结构。让我们来看看
Availability.swift
:

/// Returns 1 if the running OS version is greater than or equal to
/// major.minor.patchVersion and 0 otherwise.
///
/// This is a magic entry point known to the compiler. It is called in
/// generated code for API availability checking.
@_semantics("availability.osversion")
public func _stdlib_isOSVersionAtLeast(
  _ major: Builtin.Word,
  _ minor: Builtin.Word,
  _ patch: Builtin.Word
) -> Builtin.Int1 {
#if os(OSX) || os(iOS) || os(tvOS) || os(watchOS)
  let runningVersion = _swift_stdlib_operatingSystemVersion()
  let queryVersion = _SwiftNSOperatingSystemVersion(
    majorVersion: Int(major),
    minorVersion: Int(minor),
    patchVersion: Int(patch)
  )

  let result = runningVersion >= queryVersion

  return result._value
#else
  // FIXME: As yet, there is no obvious versioning standard for platforms other
  // than Darwin-based OS', so we just assume false for now.
  // rdar://problem/18881232
  return false._value
#endif
}

现在，更有趣的是，
_swift_stdlib_operatingSystemVersion()
是干什么的，它是怎么定义的？想要找到答案的话，我们得离开舒适的 Swift 世界了，然后深入探究 [“疯狂”的 Objective-C++] 。进入

Availability.mm

:

/// Return the version of the operating system currently running for use in
/// API availability queries.
_SwiftNSOperatingSystemVersion swift::_swift_stdlib_operatingSystemVersion() {
  static NSOperatingSystemVersion version = ([]{
    // Use -[NSProcessInfo.operatingSystemVersion] when present
    // (on iOS 8 and OS X 10.10 and above).
    if ([NSProcessInfo
         instancesRespondToSelector:@selector(operatingSystemVersion)]) {
      return [[NSProcessInfo processInfo] operatingSystemVersion];
    } else {
      // Otherwise load and parse from SystemVersion dictionary.
      return operatingSystemVersionFromPlist();
    }
  })();

  return { version.majorVersion, version.minorVersion, version.patchVersion };
}

Swift 使用了 iOS 8 的新 API，但是低于 iOS 8 的版本又回退到糟糕的方法了，开放了
@"/System/Library/CoreServices/SystemVersion.plist"
文件。这样结果就会被缓存，版本检测会访问硬盘，但是只访问一次。我的第一反应是发送一个变化的 pull 请求，简单的使用已有的公用 API（
systemVersion
），然而

Xcode 8 设置最小部署目标为 iOS 8

，我们不可能看到另外一个有着 Swift 更新的 Xcode 7.3.x 发布，所以这段代码在低于 iOS 8 的版本可能是完全无用的。

结论

对于大多数应用，在 Objective-C 中使用
isOperatingSystemAtLeastVersion:
，在 Swift 中使用
#available()
就足够了。了解底层实现还是很有趣的，一切都比字符串比较要好。如果你喜欢刨根问底，那么

PSPDFKit 就是你该来的地方

。

更新

发表这篇文章之后，Devin Coughlin ，
#available
方法的作者回复了为什么在 Swift 中不能使用
systemVersion
：

@steipete Also: 为什么不用 “systemVersion”? 因为 UIDevice 在 macOS 中不存在，然后我们想在所有平台上使用同样的代码路径。

2016 年 9 月 23-24 日，由 CSDN 和创新工场联合主办的“

MDCC 2016 移动开发者大会• 中国

”（Mobile Developer Conference China）将在北京• 国家会议中心召开，来自iOS、Android、跨平台开发、产品设计、VR开发、移动直播、人工智能、物联网、硬件开发、信息无障碍10个领域的技术专家将分享他们在各自行业的真知灼见。

8月7日24点前仍处于5折优惠票价阶段，五人以上团购更有特惠，限量供应，预购从速。

（

票务详情链接

，

5折优惠仅此一周！

）

原文链接：https://blog.csdn.net/byeweiyang/article/details/80124593

新 API

我们在 PSPDFKit 做了什么

Swift

更多关于向后兼容

结论

更新

你可能也喜欢