操作系统：macOS Big Sur
前置需求：
# Terminal：homebrew、rvm、ruby、gem、cocoapods
# 编译器：vscode、androidStudio、xcode
# Flutter：flutter sdk、dart
# Android&iOS：android sdk、gradle、jdk、.keystore、P12、.mobileprovision等
# terminal运行flutter doctor无异常
# vscode编译运行flutter项目成功
# androidStudio和xcode单独编译运行flutter项目下的android和ios项目成功
ok，开始搞jenkins
1、使用homebrew安装jenkins
Terminal运行命令brew install Jenkins
2、运行jenkins
Terminal运行命令jenkins，最终出现 Jenkins is fully up and running代表运行成功
3、初始化jenkins
在浏览器地址栏输入http://localhost:8080/
然后首次安装启动就会出现新手引导，根据引导操作
自定义jenkins那里选择安装推荐的插件
PS：这里我很多插件都安装失败了，这个没关系，可以进去再自己安装或者不再安装貌似也没啥影响，继续向下操作即可
最后的实例配置那，默认即可，也可以设置一个地址
PS：如果要设置的话，就是自己的电脑ip地址+8080端口就行，配置完之后系统管理里报了一个反向代理设置有误，目前没发现这个报错有什么不好的影响，这个地址也可以以后在jenkins系统管理-系统配置里改的，这个主要是用来让别的同事来访问时要用的，自己用的话就不用设置，额外说一个，如果同事电脑挂了vpn，大概率是访问不了你设置的这个地址的，退掉vpn即可
4、安装插件
进来第一步就是安装插件了，这里要用到哪些我也是根据别人的博客找的，但是由于我主要是用shell命令，所以好像很多都没用上，但是安装了也不亏。。。
gitLab Plugin、gitLab Hook Plugin、Xcode integration、keychains and provisioning profiles Management，DingTalk等
PS：说下这个Upload Keychain or Provisioning Profile File插件，这个是用来管理iOS证书和配置文件的，但是吐血的是，无论如何都传不上去，搞到头秃，最后没办法，放弃治疗，好在还有别的办法，往下看
然后DingTalk这个是在构建成功后自动通知到钉钉群的插件，我这边用到了，下面也有介绍
5、iOS相关设置
系统管理-Manage Credentials
点击 Stores scoped to Jenkins下面的域-全局，然后就可以添加全局凭据了，这里要添加的是：
gitLab或者gitHub账号密码（Username with password）
/Library/Keychains路径（macOS Keychain password and path）
mobileprovision文件（Apple Developer Profile）
P12文件（Certificate）
Upload Keychain or Provisioning Profile File插件用不了，配置文件在这里添加也是一样的
6、Android相关设置
系统管理-系统配置-全局属性-环境变量
Android SDK设置
系统管理-全局工具配置
JDK设置
Gradle设置
7、钉钉插件通知配置
在钉钉群的设置-智能群助手-添加自定义机器人
要复制一下webhook链接，下面要用，还有关键字设置，要钉钉和jenkins一致
在jenkins系统管理-系统配置中，设置钉钉，点击测试如果群聊能收到通知就可以
8、新建任务
这里是Android和iOS各建一个，选择freestyle即可，两边别的都一样，就是shell命令不一样，下面会贴
点开新建的任务，点击配置
①描述和钉钉
②git信息
git这里是自己项目的git地址和之前全局配置的git账号密码，也可以再这里添加新的账号密码
③构建触发器和构建环境都不用选
④构建
选择执行shell，然后填写shell命令（iOS和Android我都贴上了，可以自己参考和修改）
里面的一些关键密码和文件名等，我改成了文字描述或者***，都填自己的
此shell支持的一些功能：清空指定文件夹，替换指定文件，替换指定文件的指定内容，导出安装包，上传蒲公英，安装包重命名（version+build+时间），安装包上传svn
iOS打包shell
# keychain-这里可能你进去看到只有login.keychain-db，复制一份然后去掉-db即可
security unlock-keychain -p 电脑密码 ${HOME}/library/keychains/login.keychain
# 工程名-在xcode中查看PROJECT
APP_NAME="Runner"
# target-在xcode中查看TARGETS
TARGET_NAME="primary"
# 证书
# 这里是钥匙串中证书的显示简介-常用名称
CODE_SIGN_DISTRIBUTION="Apple Development: *** (Q3******UZ)"
# 这里是mobileprovision文件的UUID
provisoning_profile="e4270330-***********-473b3a50de58"
# 模式
CONFIGURATION="Release"
# 路径 这个路径要自己看/Users/你的电脑用户名/.jenkins/workspace/下的，你每建一个项目，构建后都会在这下面创建对应的文件夹存放git clone下来的项目
WORKSPACE_PATH=${WORKSPACE}/witparking/ios/${APP_NAME}.xcworkspace
# 这个是导出ipa用的文件，用xcode导出一个对应模式的ipa就能获取到，把那个文件的路径放这里
EXPORT_OPTIONS=/Users/你的电脑用户名/Desktop/***/ExportOptions.plist
ArchivePath=/Users/***/.jenkins/workspace/witParkingIOS@tmp/
EXPORTIPA=/Users/***/.jenkins/workspace/witParkingIOS@tmp/
# 清空存放ipa的文件夹
cd ${EXPORTIPA}
rm -rf *
# 将指定文件的指定内容替换掉pro/dev/test
# 这里是修改main_primary文件的指定内容，切换环境
# 如下示例意思是，使用app5test.wit替换该文件的从app开始，到wit结束的指定字段
cd ${WORKSPACE}/witparking/lib/flavors
sed -i '' "s/app.*wit/app5test.wit/" main_primary.dart
# flutter pub get
cd ${WORKSPACE}/witparking/
flutter pub get
# build app，里面的primary是前面的target
flutter build ios --release --flavor primary -t lib/flavors/main_primary.dart
# 进入原生项目 archive和export
cd ${WORKSPACE}/witparking/ios/
pod install
# 导出achive，里面的primary是前面的target
xcodebuild archive -workspace ${WORKSPACE_PATH} -scheme "primary" -configuration ${CONFIGURATION} -sdk iphoneos -archivePath ${ArchivePath}runner.xcarchive
# 导出ipa
xcodebuild -exportArchive -archivePath ${ArchivePath}runner.xcarchive -exportPath ${EXPORTIPA}runner -exportOptionsPlist ￥{EXPORT_OPTIONS}
# echo "=================上传到蒲公英分发平台 ================="
curl -F "file=@${EXPORTIPA}runner/Runner.ipa" \
# uKey和api_key都可以去蒲公英自己的账号信息里查看
-F "uKey=662aad68ce*****32c8114d87a13" \
-F "_api_key=46755cd719*******b4fd8fa55f" \
[https://www.pgyer.com/apiv1/app/upload](https://www.pgyer.com/apiv1/app/upload)
# ipa重命名（这里重命名是因为上传svn有统一的命名格式）
# info.plist路径
project_infoplist_path=${WORKSPACE}/witparking/ios/Info.plist
# 取版本号
bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")
# 取build值
bundleBuild=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${project_infoplist_path}")
# 获取年月日时分
DATE="$(date +%Y%m%d%H%M)"
cd ${EXPORTIPA}runner
# 拼接新名字
ipaReName=${bundleVersion}-${bundleBuild}-${DATE}.ipa
# 替换
mv Runner.ipa ${ipaReName}
# 上传svn
# 账号信息
svnname=账号
svnpwd=密码
hostname=root
hostpwd=rootpwd
# 待提交文件
myFile=${ipaReName}
# ipa文件地址
resource_dir=${EXPORTIPA}runner/${myFile}
# 本地仓库地址
commit_dir=/Users/***/Desktop/APP/测试环境/IOS
# svn路径
target_svn_dir=svn://*****/测试/版本管理/APP版本/APP
cd $commit_dir
# 先更新项目
svn update --username $svnname --password $svnpwd
# 复制安装包到提交目录
cp $resource_dir $commit_dir
#增加项目
svn add $commit_dir/$myFile
#上传项目
svn commit -m "commit file ipa" $commit_dir --username $svnname --password $svnpwd
echo "====================== svn commit end ======================"
Android apk打包shell
# apk目录
WORKSPACE_PATH=${WORKSPACE}/witparking/build/app/outputs/apk/primary/release
# 将指定文件的指定内容替换掉pro/dev/test
cd ${WORKSPACE}/witparking/lib/flavors
sed -i '' "s/app.*wit/app5test.wit/" main_primary.dart
# 清空存放apk的文件夹（首次编译没有这个路径的文件夹，因此首次编译需要注释掉这里）
cd ${WORKSPACE_PATH}
rm -rf *
# flutter pub get
cd ${WORKSPACE}/witparking/
flutter pub get
# 安卓down下来的插件有个错误，会导致运行失败，因此需要替换文件内容
# 被替换文件
A=/Users/***/Desktop/flutter/.pub-cache/hosted/pub.flutter-io.cn/contact_picker-0.0.2/android/src/main/java/net/goderbauer/flutter/contactpicker/ContactPickerPlugin.java
# 替换文件
B=/Users/****/Desktop/WitParkingDEV/ContactPickerPlugin.java
cat $B > $A
echo "==========已替换插件文件=========="
# 编译apk
flutter build apk --flavor primary -t lib/flavors/main_primary.dart --no-shrink
# 获取最新apk包的名称
cd ${WORKSPACE_PATH}
# apk名称
fileName="xx"
# 遍历获取后缀为apk的文件名
traverse_dir()
{
filepath=${WORKSPACE_PATH}
for file in `ls -a $filepath`
do
if [ -d ${filepath}/$file ]
then
if [[ $file != '.' && $file != '..' ]]
then
# 递归
traverse_dir ${filepath}/$file
fi
else
# 调用查找指定后缀文件
check_suffix $file
fi
done
}
# 获取后缀为apk的文件
check_suffix()
{
file=$1
if [ "${file##*.}" = "apk" ];
then
fileName=${file}
fi
}
traverse_dir ${WORKSPACE_PATH}
# apk签名
# 别名
aliase='****'
# 库密码
storepass='****'
# 签名密码
keypass='****'
# 秘钥
keystore='/Users/****/Desktop/WitParkingDEV/com.rpms.uaandroid.keystore'
output="output"
if [ ! -d "$output" ];then
mkdir $output
fi
# 签名
function sign(){
jarsigner -verbose -digestalg SHA1 -sigalg MD5withRSA -keystore $keystore -storepass $storepass -keypass $keypass -signedjar $tempname $filename $aliase
}
# $output"/"$(basename $filename .apk)"_signed.apk"
for filename in *
do
if [ "${filename##*.}" = "apk" ]; then
outputname=$output"/"${filename//_unsign/_signed}
echo "签名: "$filename
tempname=$(basename $filename .apk)"_temp.apk"
sign
rm -rf $tempname
fi
done
echo "-------签名已完成------"
# echo "=================上传到蒲公英分发平台 ================="
同上
# apk加时间戳
# 获取年月日时分
DATE="$(date +%Y%m%d%H%M)"
# 获取不带apk后缀的包名并重命名--从右边开始，删除第一个.及右边的字符
rename=${filename%.*}-${DATE}.apk
mv ${fileName} ${rename}
# 上传svn
同上
⑤构建后操作也不用做，保存
9、点击立即构建
如果构建失败可以点击当次构建，然后点击查看控制台输出，查看具体报错进行修改，一般来说只要androidStudio和xcode能够编译成功的话，这边问题都不大，一般都是一些小问题要改，如果构建成功，就会通知到钉钉群了
