一、什么是Jenkins
Jenkins®是一个开源的，用 Java 编写的开源持续集成（CI）服务器，可以自托管以自动执行任何项目的构建周期。Jenkins 为软件项目提供 CI 服务，可以通过命令行或 Web 应用程序服务器启动它。
什么是持续集成？
CI 是一种开发实践，其中开发人员一天几次将代码集成到共享存储库中。当有人将新代码推送到共享存储库中时，测试会在非开发人员（测试人员）的计算机上自动运行。CI 的工作流程可为你提供快速反馈。如果更改中断了构建，则在将代码提交到共享存储库后不久，你将知道。控制台还提供了详细的日志消息，因此可以识别出哪些更改导致了构建失败。另外，通过在 CI 服务器中使用公共存储库，你可以将构建部署通知到其他开发人员和测试人员。与Jenkins的持续集成
Jenkins 在 CI 中大量使用，以允许代码自动构建，部署和测试。
让我们考虑以下情况：先构建应用程序的完整源代码，然后将其部署在测试服务器上进行测试。这是开发软件的理想方法，但是在实践中，这是不实际的。开发人员将不得不暂停工作，直到获得测试结果为止，这可能需要几个小时。整个过程是手动的，因此可能会出现人为错误，这可能会浪费时间。
当然，在上述情况下，它会导致软件交付缓慢和客户不满意。这导致对开发人员可以在其中触发上述过程自动发生的需求。Jenkins 正是在这里发挥 CI 的作用。
使用 Jenkins，你可以将其连接到 Mercurial，SVN，Git 等存储库。因此，所有开发人员要做的就是配置 Jenkins定期检查存储库，并在有新内容时尝试构建，测试和部署新代码。这有助于节省大量开发人员的时间，使他们可以专注于自己的工作。-
使用Jenkins 的优点
- Jenkins 是开源的（免费），并且拥有庞大的社区
有许多可用的插件使 Jenkins 易于使用 - Jenkins 用 Java 编写，这意味着它是可移植的
- 开发人员可以在其他地方花费更多的时间：大多数集成和测试由自动化的构建和测试系统进行管理。
- 加快开发速度：大多数集成工作是自动完成的，从而减少了集成问题。从长远来看，这可以在项目的整个生命周期中节省时间和金钱。
- 更高质量的软件：可及早发现问题并立即解决。这样可以使软件保持可以随时安全发布的状态。
- Jenkins 是开源的（免费），并且拥有庞大的社区
使用Jenkins 的缺点
- 成本和时间： Jenkins 必须在服务器上运行（成本），并且经常需要系统管理员的关注（时间）。你不能指望建立了Jenkins，然后让它自己运行。该系统将需要经常更新和维护。
- 需要投入一些资金才能开始使用： 大多数团队遇到的一些主要障碍是初始设置，拖延或先前尝试建立 Jenkins的尝试失败。许多团队都知道这是最佳做法，但是在进行更紧急的编码工作时会忽略它。
- 测试可能会中断： 需要实时更新，如果未更新它们，则这些测试将停止提供价值。
二、集成环境
- 安装java环境 （一般Mac默认已安装）
- 安装Jenkins
- 使用osx系统自带的homebrew来安装jenkins
$ brew install Jenkins - 手动安装
- Jenkins官网
-
下载LTS war包
- 终端进入war包路径
- 执行命令：java -jar jenkins.war
- 使用osx系统自带的homebrew来安装jenkins
三、配置Jenkins
- 终端开启Jenkins
打开浏览器，输入http://localhost:8080
-
进入 /Users/xxx/.jenkins/secrets/initialAdminPassword 拷贝管理员密码
-
选择安装推荐的插件
-
等待安装完成
-
创建管理员用户
- 安装完成
四、创建任务及构建配置
-
创建任务
-
构建配置
image.png -
定时构建
-
源码管理
三种构建方式
1.Fastlane 构建
-
Fastlane 构建（前提需要先配置Fastlane）
-
保存并构建，可以通过控制台查看构建信息
2.shell构建
- 导出ExportOptions.plist
使用Xcode手动打包，在导出的文件夹中找到ExportOptions.plist文件。
检查ExportOptions.plist文件下的provisioningProfiles是否设置正确。
将ExportOptions.plist文件放在jenkins主目录/xxx/workspace/build目录下。
- 编写shell
SECONDS=0
#默认使用的语言是英文
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
#假设脚本放置在与项目相同的路径下
project_dir=$(pwd)
#编辑上传的文件全部放于此路径下,不影响原工程 ，保存项目目录地址
upload_dir="/Users/kaifengyang/Desktop/package/TestAndUpload"
if [ -d "$upload_dir" ]; then
echo "编辑上传的文件输出文件目录存在,目录为:$upload_dir"
else
echo "编辑上传的文件目录不存在"
mkdir -pv $upload_dir
echo "创建打包文件目录${upload_dir}成功"
fi
#打包配置环境
configuration="Release"
#判断是用的xcodeproj还是直接xcworkspace，xcworkspace设置为true，否则设置为false
isWorkSpace=true
#项目名称
scheme=`find . -name *.xcodeproj | awk -F "[/.]" '{print $(NF-1)}'`
projectName="${scheme}.xcworkspace"
#确定工程名称，如果用了cocopods，则使用xcworkspace，但是没有该文件则使用xcodeproj进行
if [ -a "$project_dir/$projectName" ]; then
isWorkSpace=true
projectName="${scheme}.xcworkspace"
else
isWorkSpace=false
projectName="${scheme}.xcodeproj"
fi
#指定项目地址
project_path="$project_dir/$projectName"
#确认输出日期
buildDate=$(date +%Y%m%d%H%M%S)
#指定输出路径
output_path="$upload_dir/package$buildDate"
#指定输出归档文件地址
archive_path="$output_path/${scheme}.xcarchive"
#指定输出ipa名称
ipa_name="${scheme}.ipa"
#指定输出ipa地址
ipa_path="$output_path/$ipa_name"
#指定xarchive文件导出授权样式 bundle id
provisioningProfileName="XC iOS: com.imuyuan.jt"
#指定打包所使用的输出方式，目前支持app-store, package, ad-hoc, enterprise, development, 和developer-id，即xcodebuild的method参数
export_method='ad-hoc'
###############获取版本号,bundleID
infoPlist="$project_dir/$scheme-Info.plist"
bundleVersion=`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" $infoPlist`
bundleIdentifier=`/usr/libexec/PlistBuddy -c "Print CFBundleIdentifier" $infoPlist`
bundleBuildVersion=`/usr/libexec/PlistBuddy -c "Print CFBundleVersion" $infoPlist`
displayname=`/usr/libexec/PlistBuddy -c "Print CFBundleDisplayName" $infoPlist`
#输出设定的变量值
echo "项目名:$projectName"
echo "===项目路径: ${project_path}==="
echo "===打包xarchive文件路径: ${archive_path}==="
echo "===打包ipa文件路径: ${ipa_path}==="
echo "~~~~~~~~~~~~~~~~~~~开始编译~~~~~~~~~~~~~~~~~~~"
#处理没有输出打包文件目录的情况
if [ -d "$output_path" ]; then
echo "打包文件输出文件目录存在,目录为:$output_path"
else
echo "打包文件目录不存在"
mkdir -pv $output_path
echo "创建打包文件目录${output_path}成功"
fi
#处理编译文件目录的情况
cd $upload_dir
rm -rf ./build
buildAppToDir="$upload_dir/build" #编译打包完成后.app文件存放的目录
#重新进入当前项目路径下
cd $project_dir
security unlock-keychain -p "addcn" /Users/addcn/Library/Keychains/login.keychain
#开始编译app
if $isWorkSpace ; then #判断编译方式
echo "开始编译workspace...."
xcodebuild -workspace $projectName -scheme $scheme -configuration $configuration clean build SYMROOT=$buildAppToDir
else
echo "开始编译target...."
xcodebuild -target $projectName -configuration $configuration clean build SYMROOT=$buildAppToDir
fi
#判断编译结果
if test $? -eq 0
then
echo "~~~~~~~~~~~~~~~~~~~编译成功~~~~~~~~~~~~~~~~~~~"
else
echo "~~~~~~~~~~~~~~~~~~~编译失败~~~~~~~~~~~~~~~~~~~"
exit 1
fi
echo "开始打包$scheme.app成$scheme.ipa....."
cd $upload_dir
findFolderName=`find . -name "$configuration-*" -type d |xargs basename` #查找目录
appDir=$buildAppToDir/$findFolderName #app所在路径
#重新进入当前项目路径下
cd $project_dir
echo "打包xarchive文件,路径为:$archive_path"
if $isWorkSpace ; then #判断编译方式
echo "开始打包workspace...."
xcodebuild -workspace $projectName -scheme $scheme -destination generic/platform=iOS archive -configuration ${configuration} ONLY_ACTIVE_ARCH=NO -archivePath $archive_path
else
echo "开始打包target...."
xcodebuild -target $projectName -scheme $scheme -destination generic/platform=iOS archive -configuration ${configuration} ONLY_ACTIVE_ARCH=NO -archivePath $archive_path
fi
#检查文件是否存在
if [ -a "$archive_path" ]; then
echo "打包$scheme.xcarchive成功."
else
echo "打包$scheme.xcarchive失败."
exit 1
fi
# echo "开始导出$scheme.xcarchive成$scheme.ipa....."
xcodebuild -exportArchive -archivePath "$archive_path" -exportPath "$appDir/$ipa_name" -exportOptionsPlist ExportOptions.plist
#xcodebuild -exportArchive -exportFormat ipa -archivePath $archive_path -exportPath $appDir/$ipa_name -exportProvisioningProfile $provisioningProfileName
# echo "检查打包文件$appDir/${ipa_name}是否存在"
# if [ -f "$appDir/$ipa_name" ];then
# echo "打包${ipa_name}成功."
# else
# echo "打包${ipa_name}失败."
# exit 1
# fi
# cp -f -p $appDir/$ipa_name/$ipa_name $ipa_path #拷贝ipa文件
# echo "复制${ipa_name}到${ipa_path}成功"
echo "~~~~~~~~~~~~~~~~~~~结束打包，处理成功~~~~~~~~~~~~~~~~~~~"
# #输出总用时
echo "===Finished.编译加打包共花费时间: ${SECONDS}s==="
echo "正在上传至蒲公英平台"
echo "版本:${bundleVersion}"
#蒲公英上的User Key
uKey="f6c70c474a55813e1cb65a40c9d5c018"
#蒲公英上的API Key
apiKey="55f5cd523a26b233ede77002e815f9ad"
#要上传的ipa文件路径
IPA_PATH="$appDir/$ipa_name/$ipa_name"
#执行上传至蒲公英的命令，这句不需要修改
curl -F "file=@${IPA_PATH}" -F "uKey=${uKey}" -F "_api_key=${apiKey}" https://www.pgyer.com/apiv1/app/upload
# echo "删除编译文件包和打包"
# rm -rf $buildAppToDir
# rm -rf $output_path
#输出总用时
echo "===Finished.共花费时间: ${SECONDS}s==="
-
执行shell 并构建
3.xcode 构建 （较繁琐，不建议）
五、其他配置
-
修改Jenkins端口号
1.打开文件 vi /usr/local/Cellar/jenkins/2.321/homebrew.mxcl.jenkins.plist(路径替换成你自己的，不知道的可以搜索关键字jenkins)
2、修改默认端口号
启动jenkins： brew services start jenkins
停止jenkins：brew services stop jenkins
重启Jenkins：brew services restart jenkins
- 搭建HTTP局域网共享文件服务器
Mac 自带Python，可以使用Python的SimpleHTTPServer进行局域网文件共享
1. cd 需共享的文件夹
2. sudo python -m SimpleHTTPServer 80
3. 输入管理员密码即可
