1、为什么要自动打包工具?
每修改一个问题,测试都让你打包一个上传fir , 你要clean -> 编译打包 -> 上传fir -> 通知测试。而且打包速度好慢,太浪费时间了。如果有一个工具能自动的帮你做完上面所有的事情,岂不是快哉?
2、网上有那么多自动打包工具,我直接下载就行了为啥还要学习?
没错网上有很多打包工具,包括github上也有一些直接从github下载并打包上传的,但是他们的不一定适合你,首先下载下来要配置各种参数,不会配,还有网上大多是针对普通项目,但是我们项目是cocoaPods管理的,编译的是 xxx.xcworkspace 不是 xxx.xcodeproj 。怎么办 , xxx.xcodeproj 自动编译后就在你项目目录下会有 xxx.app 但是 xxx.xcworkspace 找不到怎么办?怎么指定目录 , 这些网上的库大都没有的。
3、需要哪些准备工作?
首先你得有装xcode , python3.5 (我装的版本,其他版本也行), 待打包的项目。安装相关软件,随便搜索下就可以了。
废话结束,开始正文。本文介绍的是自动clean本地项目,编译 打包 上传fir 邮件通知相关人员。不涉及从git上下载。原理就是利用python执行控制台命令。对iOS项目进行打包。
xcode控制台命令
xcode 控制台命令基本都是以 xcodebuild 开头的介绍几个简单的命令,大家可以在命令行试试。
xcodebuild -version 查看xcode的版本号和build的版本号
xcodebuild -showsdks 显示当前系统的SDK、及其版本
xcodebuild -list 先 cd 到工程目录下执行此命令 显示target Schemes 等
没有使用 cocoaPods 项目的编译
如果你的项目是普通的项目没有使用cocoaPods 那么 cd 到工程目录下直接执行 xcodebuild build ,就会自动编译了 参数都是默认 默认build release。
你也可以指定 xcodebuild -configuration debug build build的时候会在你工程目录下生成一个build文件夹,build/Release-iphoneos/xx.app
就是一会打包成ipa需要的文件。 第一次build速度会比较慢,要把编译环境拉下来,不要删除build文件夹,以后build 速度就会变快。
使用了 cocoaPods 项目的编译
如果不幸你也和我一样使用了cocoaPods , 其实也没啥不幸的 ,只是编译的时候就比较麻烦了 ,首先还是 cd 到项目目录 。但是你要指定编译文件和 scheme
而且还要指定build后build文件夹的位置,如果位置找不到,后面怎么自动打包ipa?。
我这里的命令大概是这样的:
xcodebuild -workspace xxx.xcworkspace -scheme 你的scheme -configuration debug -derivedDataPath 指定路径 ONLY_ACTIVE_ARCH=NO
这样就能正常编译并把build指定到我们想要去的目录
打包ipa
打包ipa只要上面路径对了,打包指定从.app 文件的路径 , 打包到你指定地方就行了。
命令:
xcrun -sdk iphoneos PackageApplication -v 这里填.app的路径 -o 指定存放ipa路径/文件名.ipa
python实现篇
上面只是说了下编译的原理,下面看下怎么通过python自动处理这些任务 。
clean、编译、打包
首先创建一个xxx.py文件,需要你懂点python 语法,不懂就直接copy代码。不要改tab 。python的语法是严格按照tab区分的。后面我会放上我的代码,你们改改
变量就可以使用。
首先你需要引入一些外部依赖。设置编码为utf-8
# -*- coding: utf-8 -*-
import os
import sys
import time
import hashlib
from email import encoders
from email.header import Header
from email.mime.text import MIMEText
from email.utils import parseaddr, formataddr
import smtplib
第一步 , 声明一些变量
# 项目根目录
project_path = "/Users/xx/project"
# 编译成功后.app所在目录
app_path = "/Users/xx/project/build/Build/Products/Release-iphoneos/xxx.app"
# 指定项目下编译目录
build_path = "build"
# 打包后ipa存储目录
targerIPA_parth = "/Users/xx/Desktop"
第二步,clean,和创建一个文件夹,这里的示例是针对有使用cocoaPods的项目 , 如果没有使用 不用创建文件夹 ,命令自行简化
# 清理项目 创建build目录
def clean_project_mkdir_build():
os.system('cd %s;xcodebuild clean' % project_path) # clean 项目
os.system('cd %s;mkdir build' % project_path) # 创建目录
%s 是py的占位符,字符串类型。后面是真正的填充。
第三步编译项目
def build_project():
print("build release start")
os.system ('cd %s;xcodebuild -list')
os.system ('cd %s;xcodebuild -workspace xxx.xcworkspace -scheme xxx -configuration release -derivedDataPath %s ONLY_ACTIVE_ARCH=NO || exit' % (project_path,build_path))
不知道scheme是啥的xcodebuild -list 自己查
第四步 打包
# 打包ipa 并且保存在桌面
def build_ipa():
global ipa_filename
ipa_filename = time.strftime('yourproject_%Y-%m-%d-%H-%M-%S.ipa',time.localtime(time.time()))
os.system ('xcrun -sdk iphoneos PackageApplication -v %s -o %s/%s' % (app_path,targerIPA_parth,ipa_filename))
然后你现在再编写个方法,按顺序调用就可以编译打包了 ,执行完会看到桌面的ipa
def main():
# 清理并创建build目录
clean_project_mkdir_build()
# 编译coocaPods项目文件并 执行编译目录
build_project()
# 打包ipa 并制定到桌面
build_ipa()
执行就在最下面直接调用就行了 main()
上传fir
我们是把代码上传到fir测试的,如果你们用的蒲公英或者其他,请自行搜索。
通过 gem install fir-cli 如果你没有ruby环境,自行搜索
安装完成后,在命令行输入fir 回车 。会有fir的命令提示。我们上传fir需要fir的API_TOKEN , 去fir官网登录找好就能找到。
拿到那一串串字符,在变量区加上
# firm的api token
fir_api_token = "xxxxxxxxxxxxxxxxxxxxxxxxxx"
然后命令传入ipa目录和token就可以上传了
#上传
def upload_fir():
if os.path.exists("%s/%s" % (targerIPA_parth,ipa_filename)):
print('watting...')
# 直接使用fir 有问题 这里使用了绝对地址 在终端通过 which fir 获得
ret = os.system("/usr/local/bin/fir p '%s/%s' -T '%s'" % (targerIPA_parth,ipa_filename,fir_api_token))
else:
print("没有找到ipa文件")
这里也有遇到一个=坑,就是在终端直接fir 带后面的就可以执行 ,但是在这里识别不了命令,必须制定全路径,怎么找命令的全路径呢?终端输入 which fir
发邮件
具体发邮件功能看代码,这里有几个变量。我使用的是新浪邮箱发的,smtp服务器 , 如果你是 pop3 请更换,还要在邮箱里开启相应的服务
from_addr = "xxxx@sina.com"
password = "*****"
smtp_server = "smtp.sina.com"
to_addr = 'aaa@qq.com,bbbb@qq.com'
然后发邮件的方法
我们的fir路径是固定的
# 发邮件
def send_mail():
msg = MIMEText('xxx iOS测试项目已经打包完毕,请前往 http://fir.im/xxxxx 下载测试!', 'plain', 'utf-8')
msg['From'] = _format_addr('自动打包系统 ' % from_addr)
msg['To'] = _format_addr('xxx测试人员 ' % to_addr)
msg['Subject'] = Header('xxx iOS客户端打包程序', 'utf-8').encode()
server = smtplib.SMTP(smtp_server, 25)
server.set_debuglevel(1)
server.login(from_addr, password)
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()
然后执行顺序是这样的
def main():
# 清理并创建build目录
clean_project_mkdir_build()
# 编译coocaPods项目文件并 执行编译目录
build_project()
# 打包ipa 并制定到桌面
build_ipa()
# 上传fir
upload_fir()
# 发邮件
send_mail()
# 执行
main()
本文重点在自动打包命令上,python代码感兴趣的可以去Python教程 学习。
本文代码已经托管在github上:https://github.com/smalldu/autoipa