在前面的文章中已经详细介绍过Jenkins、Sonarqube的安装、配置及使用，对于Web端的代码质量管理通常相对容易，Jenkins配套Sonarqube很方便就能搞定。但是对于移动端来说，尤其iOS，集成和使用的复杂性会大幅提高，目前网络上有一些介绍的方法，但实际操作的过程中会存在很多坑。本篇文章，就带大家详细实操移动端代码质量扫描与安全检测评估。
一、代码质量扫描
Android的Sonarqube相对简单，这里不做过多介绍，重点介绍iOS的代码质量扫描。iOS代码质量扫描的核心是如何支持Objective-C和Swift的扫描。SonarQubeCommunity社区版免费开源，一般来说，社区版就符合大多数开发者的需求，针对大多数语言都可以免费扫描。然而对于iOS，社区版不支持Objective-C和Swift的扫描，因此网络上有单身做了相应的开源插件sonar-swift来实现iOS的代码扫描。sonar-swift的github地址为https://github.com/Idean/sonar-swift，根据官方文档使用该插件的前提是要安装SonarQube、SonarQube Scanner、xcpretty、SwiftLint、Tailor、slather、lizard、OCLint。SonarQube和SonarQube Scanner在前面的文章中已经详细介绍过了，其他几个依赖我们一次介绍下。
（1）xcpretty安装
xcpretty是格式化xcodebuild输入的工具，使用ruby开发，安装命令如下：
git clone https://github.com/Backelite/xcpretty.git
cd xcpretty
git checkout fix/duration_of_failed_tests_workaround
gem build xcpretty.gemspec
sudo gem install --both xcpretty-0.2.2.gem
（2）SwiftLint安装
SwiftLint 是一个用于强制检查 Swift 代码风格和规定的一个工具，基本上以 Ray Wenderlich's Swift代码风格指南为基础。
安装命令如下：
brew install swiftlint
（3）Tailor安装
Tailor是一个用于苹果的Swift编程语言编写的源代码的静态分析和lint工具。安装命令如下：
brew install tailor
（4）slather安装
slather为Xcode项目生成测试覆盖率报告并将其连接到CI。安装命令如下：
sudo gem install -n /usr/local/bin slather
（5）lizard安装
Lizard是一个可扩展的圈复杂度分析插件，适用于许多编程语言，包括C/C++（不需要所有头文件或Java导入）。安装命令如下：
sudo pip3 install lizard
（6）OCLint安装
OCLint 是一种静态代码分析工具，用于通过检查 C、C++ 和 Objective-C 代码来提高质量并减少缺陷。
安装命令如下：
brew install oclint
（7）下载并安装完上述依赖后，通过https://github.com/Idean/sonar-swift下载jar文件，并将下载的jar文件放到本地SonarQube安装目录的插件目录下，通常为/usr/local/Cellar/sonarqube/xxx/libexec/extensions/plugins目录下。这时在SonarQube安装目录的bin目录下执行./sonar start，可能会报错导致SonarQube无法启动。原因是如果SonarQube的版本是9以上，官方的sonar-swift的jar为0.4.6版本，导致无法启动，需要在另一个分支上找适配的版本： <u>https://github.com/estebanhiguitad/sonar-swift/releases，</u>下载0.4.7版本即可。
（8）在iOS项目的根目录下创建sonar-project.properties和run-sonar-swift.sh两个文件。
1）其中sonar-project.properties为SonarQube相关的配置文件，可以直接拷贝https://raw.githubusercontent.com/Backelite/sonar-swift/master/sonar-project.properties，然后根据自己的项目做相应的配置修改，其中比较关键的如下：
# 项目使用的语言
sonar.language=swift
# Project description
# 源代码目录
sonar.sources=XXX
# Destination Simulator to run surefire
# As string expected in destination argument of xcodebuild command
# Example = sonar.swift.simulator=platform=iOS Simulator,name=iPhone 6,OS=9.2
指定模拟器，这里会有一个坑，为了配合run-sonar-swift.sh这个脚本，此处是必填项，可能存在找不到相应模拟器的问题，我们在run-sonar-swift.sh这个文件中做相应修改。
sonar.swift.simulator=platform=iOS Simulator,name=iPhone 13,OS=15.0
# 指定工程名或者空间名
sonar.swift.project=XXX.xcodeproj
sonar.swift.workspace=XXX.xcworkspace
# 配置Scheme
sonar.swift.appScheme= XXX
2）下载https://raw.githubusercontent.com/Backelite/sonar-swift/master/sonar-swift-plugin/src/main/shell/run-sonar-swift.sh的run-sonar-swift.sh文件，并修改其中的内容将 build-for-testing和destinationSimulator去掉buildCmd=($XCODEBUILD_CMD clean)
echo -n 'Building & extracting Xcode project information'
if [[ "$workspaceFile" != "" ]] ; then
buildCmd+=(-workspace "$workspaceFile")
else
buildCmd+=(-project "$projectFile")
fi
buildCmd+=(-scheme $appScheme)
runCommand xcodebuild.log "${buildCmd[@]}"
这样就不会出现找不到模拟器的问题，完美解决。
（9）执行iOS代码扫描
启动SonarQube，在项目根目录下执行bash run-sonar-swift.sh -nounittests -v命令，根据sonar-project.properties的配置，会自动进行代码扫描，扫描完成后在SonarQube即可看到相应的报告。
二、安全检测评估
移动端安全检测我们采用MobSF，移动安全框架 (MobSF) 是一个智能化、一体化的开源移动应用（Android / iOS）自动测试框架，能够对iOS和Android 应用进行静态和动态分析（动态分析目前只支持Android）。MobSF可以有效、快速地对应用APK 和IPA文件及压缩的源代码进行审计分析。MobSF的安装和使用参照官方文档https://mobsf.github.io/docs/#/zh-cn/。安装和使用以MAC为例。
(1) 安装git,或者直接通过github上下载压缩包
sudo apt-get install git
(2) 安装Python
sudo apt-get install python3.8
注意MAC电脑上默认安装有安装Python ，需要修改环境变量以便切换到python3。
(3) 安装 JDK 8+
sudo apt-get install openjdk-8-jdk
(4) 安装以下依赖
sudo apt install python3-dev python3-venv python3-pip build-essential libffi-dev libssl-dev libxml2-dev libxslt1-dev libjpeg8-dev zlib1g-dev wkhtmltopdf
依赖包括xml解析、pdf生成等插件。
(5) 安装MobSF
git clone https://github.com/MobSF/Mobile-Security-Framework-MobSF.git
cd Mobile-Security-Framework-MobSF
./setup.sh
(6) 运行MobSF
./run.sh 127.0.0.1:8000
(7) 运行MobSF
在浏览器中，打开 http://localhost:8000/ 访问 MobSF Web界面。
三、Jenkins集成sonar-swift和MobSF
由于MobSF需要上传APK 或IPA，因此需要在使用MobSF框架前将相应的包打包出来备用。采用Jenkins实现代码扫描和安全检测自动化有两种方式，一种是在Jenkins中新建两个任务，分别进行代码扫描、编译打包和安全检测；另一种方式是同一个任务中设置依赖，先进行代码扫描、编译打包，然后再进行安全检测，我们以第一种方式为例。
（1）代码扫描、编译打包
新建一个自由风格的Jenkins项目，常规的配置代码获取等在之前的文章中有介绍，这里不再赘述。
上图中的两个run-sonar-swift.sh和build.sh均位于iOS项目的根目录，build.sh为命令行编译打包的脚本，可以参考网上的相关文章进行编写。在构建步骤执行这两个步骤后就能将sonar-swift扫描的结果呈现到SonarQube上，并且打包出来ipa。
（2）安全检测
1）在Jenkins中新建一个Pipeline项目，在构建触发器选择依赖上一个编译打包的工程。
2）MobSF启动后访问http://127.0.0.1:8000/api_docs，获取REST API Key。
3）在Pipeline项目配置中添加脚本
脚本内容如下：
pipeline {
agent any
stages{
stage('Analysis') {
steps {
script {
echo 'start Upload'
//上传应用包
def AUTH_KEY = 'MobSF的REST API Key'
upload_cmd =
"curl -F
'file=@ipa文件所在的具体路径'
http://localhost:8000/api/v1/upload -H 'Authorization:${AUTH_KEY}'"
upload_result = sh label: 'Upload Binary', returnStdout: true, script: upload_cmd
}
}
}
}
}
4）执行Jenkins任务，构建完成后ipa包直接上传到MobSF平台作静态分析。
网友评论