Xcode代码规范之SwiftLint配置

Xcode代码规范之SwiftLint配置

前言

• 最近公司大佬考虑将项目代码规范化, 然而自Xcode9以后,Xcode的插件基本处于废弃的状态大部分插件都是在一年前就中止更新了;
• 因而在谷歌找到了一款强大的代码规范工具SwiftLint
• SwiftLint是 Realm 推出的一款 Swift 代码规范检查工具, SwiftLint 基于 Github 公布的 Swift 代码规范进行代码检查，而且可以很好的和 Xcode 整合
• Github 公布的 Swift 代码规范--原文
• Github 公布的 Swift 代码规范--中文
• 配置好全部的设置以后，在 Xcode 中执行编译时，SwiftLint 会自动运行检查，不符合规范的代码会经过警告或者 红色错误 的形式指示出来
• 支持自定义规则,可禁用或者开启某一些规则

一. 安装SwiftLint

• SwiftLint目前有三种安装方式可供选择,能够根据本身的项目须要自行选择

1. 安装全局配置(Homebrew 安装)

Homebrew

• Homebrew, Mac系统的包管理器，用于安装NodeJS和一些其余必需的工具软件, 输入如下代码安装:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
复制代码

译注：在Max OS X 10.11（El Capitan)版本中，homebrew在安装软件时可能会碰到/usr/local目录不可写的权限问题。可使用下面的命令修复：

sudo chown -R `whoami` /usr/local
复制代码

• Homebrew 会自动安装最新版本
• 打开终端输入如下代码:

brew install swiftlint
复制代码

安装成功,以下图所示:

2. 使用 CocoaPods 安装

• 这种方式只能针对单个项目有效,若是你想要针对不一样的项目使用不一样的SwiftLint 版本，这是一种很好的解决方案
• 须要注意的是使用这种方案会将整个SwiftLint以及他的依赖包的完整资源文件都安装到 Pods/ 目录中去，因此在使用版本管理工具好比 git/svn 时要注意设置忽略相关目录
• CocosPods安装和安装第三方框架同样
• 在根目录建立Podfile

pod 'SwiftLint'
复制代码

3. 使用安装包

SwiftLint 还支持使用 pkg 安装包进行安装，在官方的 Github 页面能够找到最新发布的安装包

二. 查看SwiftLint的所有命令

• 等待安装完成，在终端输入 swiftlint help 能够查看全部可用的命令：

各个命令注释

//查看全部命令
swiftlint help

//忽略空格致使的警告和错误
swiftlint autocorrect

//输出全部的警告和错误
swiftlint lint

//查看全部可得到的规则以及对应的 ID
swiftlint rules

//产看当前版本号
swiftlint version
复制代码

• 咱们将目录切换到工程的根目录之下，而后敲击以下命令:

swiftlint autocorrect
复制代码

而后咱们就会发现，全部的空格符Warning都消失了。这都得益于咱们刚刚所进行的命令行操做，它会将已知的可以自动修复的Error和Warning都自动修复，大大的减轻了咱们的工做量。

三. SwiftLint的使用

安装完成后,须要在Xcode中配置相关设置,才能使 SwiftLint 在 Xcode 中自动检测代码规范。配置也很简单，只须要在 Xcode 的 Build Phases 中新建一个 Run Script Phase 配置项，在里面添加相关代码后,编译便可!

• 配置代码添加步骤
• 须要将相关脚本添加到红色框内

1. 全局安装脚本添加方式

if which swiftlint >/dev/null; then
  swiftlint
else
  echo "warning: SwiftLint not installed, download from https://github.com/realm/SwiftLint"
fi
复制代码

2. CocoaPods安装脚本添加

"${PODS_ROOT}/SwiftLint/swiftlint"
复制代码

• 这里实际上是设置了一个自动编译脚本，每次运行编译都会自动执行这个脚本
• 若是正确安装了 SwiftLint，就会执行 SwiftLint 中的代码规范检查，若是没有安装，脚本会抛出一个没有安装 SwiftLint 并提示下载的警告，方便提醒团队团队中没有安装的成员。
• 固然，你也能够设置为强制要求安装，这时若是没有安装则没法经过编译。只须要在脚本中

echo "warning: ..."
复制代码

以后添加一行代码：

exit 1
复制代码

• 这样一来，若是没有安装 SwiftLint，编译时会直接抛出一个编译错误而非警告，提示须要安装 SwiftLint。

3. 配置完成后,command+B编译

• 若是你的是正在开发中的项目, 你可能会发现你的项目提示999+的黄色警告和999+的红色错误
• 甚至你会发现甚至一些空格和一些系统的方法和注释也会报错或者警告
• SwiftLint默认方法名或者注释不得超过120个字符

• Swift Lint 在完成上述操做以后，便已经生效。可是，若是以为默认的风格过于严格，或者项目组有另外的要求，Swift Lint 也能够定制相应的风格，或者禁用某些规则。
• SwiftLint 的所有规则能够在：Source/SwiftLintFramework/Rules 目录内找到

四. 自定义配置

• 当你编译过项目后,看到999+的警告和错误,是否是第一反应就是要放弃了,其实否则
• 仔细看一下具体的错误，会发现好多都是第三方库的代码规范问题，并且好多问题的级别被设置成为了 error
• 第三方库的代码规范问题,这个锅咱们可不能背
• 这里咱们能够作一些配置，让 SwiftLint 在作代码规范检查的时候自动忽略 CocoaPods、Carthage 等包管理器引入的第三方库（固然，手动导入的第三方库也能设置忽略）

1. 建立配置文件

• 首先须要在项目的根目录下新建一个名为 .swiftlint.yml 的配置文件
• 打开终端, cd 到项目根目录下
• 输入: touch .swiftlint.yml
• 执行完该命令后, 在文件夹中你可能找不到该yml格式文件,那是由于文件被隐藏了
• 关于隐藏/显示隐藏文件(命令同样): command + shift + .
• 下面咱们来认识一下主要的几个配置选项

disabled_rules: # 禁用指定的规则
  - colon
  - comma
  - control_statement
opt_in_rules: # 启用指定的规则
  - empty_count
  - missing_docs
  # 能够经过执行以下指令来查找全部可用的规则:
  # swiftlint rules
included: # 执行 linting 时包含的路径。若是出现这个 `--path` 会被忽略。
  - Source
excluded: # 执行 linting 时忽略的路径。 优先级比 `included` 更高。
  - Carthage
  - Pods
  - Source/ExcludedFolder
  - Source/ExcludedFile.swift
复制代码

2. 在代码中关闭某个规则

能够经过在一个源文件中定义一个以下格式的注释来关闭某个规则：

// swiftlint:disable <rule>
复制代码

在该文件结束以前或者在定义以下格式的匹配注释以前，这条规则都会被禁用：

// swiftlint:enable <rule>
复制代码

例如:

// swiftlint:disable opening_brace
    func initTakeScreenshot(launchOptions: [AnyHashable: Any]?){
        // swiftlint:enable opening_brace
        if let options = launchOptions {
            let userInfo = options[UIApplicationLaunchOptionsKey.remoteNotification]
            NotificationCenter.default.post(name: Notification.Name.UIApplicationUserDidTakeScreenshot, object: userInfo)
        }
    }
复制代码

规则关闭以前

规则关闭以后

也能够经过添加 :previous, :this 或者 :next 来使关闭或者打开某条规则的命令分别应用于前一行，当前或者后一行代码。

例如:

// swiftlint:disable:next force_cast
let noWarning = NSNumber() as! Int
let hasWarning = NSNumber() as! Int
let noWarning2 = NSNumber() as! Int // swiftlint:disable:this force_cast
let noWarning3 = NSNumber() as! Int
// swiftlint:disable:previous force_cast
复制代码

3. 忽略引入的第三方库

• 1). 忽略CocoaPods导入的第三方库

excluded: 
  - Pods
复制代码

• 2). excluded 配置项用来设置忽略代码规范检查的路径，能够指定整个文件夹
• 好比若是你的项目使用 Carthage 管理第三方库的话，能够将 Carthage 目录添加到忽略列表：

excluded: 
  - Pods
  - Carthage
复制代码

• 3). 指定精确路径下的文件，经过 - xxxx 的形式列在下面就能够了

excluded: # 执行 linting 时忽略的路径。 优先级比 `included` 更高。
  - Source/ExcludedFolder
  - Source/ExcludedFile.swift
复制代码

4. 嵌套配置

SwiftLint 支持经过嵌套配置文件的方式来对代码分析过程进行更加细致的控制。

• 在你的根 .swiftlint.yml 文件里设置 use_nested_configs: true 值。
• 在目录结构必要的地方引入额外的 .swiftlint.yml 文件。
• 每一个文件被检查时会使用在文件所在目录下的或者父目录的更深层目录下的配置文件。不然根配置文件将会生效。
• excluded，included，和 use_nested_configs 在嵌套结构中会被忽略。

5. 自动更正

• SwiftLint 能够自动修正某些错误，磁盘上的文件会被一个修正后的版本覆盖。
• 请确保在对文件执行 swiftlint autocorrect 以前有对它们作过备份，不然的话有可能致使重要数据的丢失。
• 由于在执行自动更正修改某个文件后颇有可能致使以前生成的代码检查信息无效或者不正确，因此当在执行代码更正时标准的检查是没法使用的。

五. 最后贴上官方示例

disabled_rules: # 执行时排除掉的规则
  - colon
  - comma
  - control_statement
opt_in_rules: # 一些规则仅仅是可选的
  - empty_count
  - missing_docs
  # 能够经过执行以下指令来查找全部可用的规则:
  # swiftlint rules
included: # 执行 linting 时包含的路径。若是出现这个 `--path` 会被忽略。
  - Source
excluded: # 执行 linting 时忽略的路径。 优先级比 `included` 更高。
  - Carthage
  - Pods
  - Source/ExcludedFolder
  - Source/ExcludedFile.swift

# 可配置的规则能够经过这个配置文件来自定义
# 二进制规则能够设置他们的严格程度
force_cast: warning # 隐式
force_try:
  severity: warning # 显式
# 同时有警告和错误等级的规则，能够只设置它的警告等级
# 隐式
line_length: 110
# 能够经过一个数组同时进行隐式设置
type_body_length:
  - 300 # warning
  - 400 # error
# 或者也能够同时进行显式设置
file_length:
  warning: 500
  error: 1200
# 命名规则能够设置最小长度和最大程度的警告/错误
# 此外它们也能够设置排除在外的名字
type_name:
  min_length: 4 # 只是警告
  max_length: # 警告和错误
    warning: 40
    error: 50
  excluded: iPhone # 排除某个名字
variable_name:
  min_length: # 只有最小长度
    error: 4 # 只有错误
  excluded: # 排除某些名字
    - id
    - URL
    - GlobalAPIKey
reporter: "xcode" # 报告类型 (xcode, json, csv, checkstyle)
复制代码

附录:

原文连接：https://github.com/realm/SwiftLint/blob/master/README.md 译文连接：https://github.com/realm/SwiftLint/blob/master/README_CN.md