在 iOS 开发中,一般打发布包都是在本地打包,也就是工程师在自己开发电脑上使用 Xcode 编译并导出安装包来进行发布,为了提高效率可能会制作一些自动化打包脚本。本文聊的是远程打包的内容,通过资源拷贝及参数替换然后编译完成打包。
由于 HTML5 跨平台的特点,很多技术团队考虑到代码复用,在部分模块中会采用 h5 来描述界面。甚至有些不需要太复杂交互的 app,全部界面采用 h5 来编写,也就是一个 web 工程。对于大部分现有的 web 工程,能打包成 app 就已经满足了业务诉求。DCloud 团队开发的 HBuilder(IDE)工具中提供了云打包的功能,用起来很方便,简单的说,就是把 web 工程上传到云打包服务器,最后打包生成 app,点击下载即可安装使用。
dcloud_pack_policy.png
虽然云打包服务很方便,但上传源码总感觉不太妥当,总有些秘密不想让别人看见,并且其他同事也有打包的需求,但不一定会使用 HBuilder。因此,搭建一个自己的打包服务很有必要。
按照 HBuilder 提供的云打包功能,先定一个初步的需求:
支持修改应用 id、版本号 、icon、启动图
支持导入签名文件
开工!!!
准备工作
首先,需要一台安装了 MacOS 的电脑(当做服务器使用)。
笔者手头上刚好有台闲置的电脑就拿来当服务器使用了,装了 VMware,然后装了 MacOS 虚拟机(问题较多,不建议使用虚拟机)。
物理机 windows7,内存 4G;虚拟机 MacOS,内存 3G。
其次,在服务器上部署一个 web 服务,提供打包交互界面方便客户端上传资源文件及下载安装包。我们的界面只提供了一个 www
zip 包的上传入口,所有应用资源及打包相关的配置文件都在里面。www 目录结构如下:
www_directory.png
appConfig.json 文件内容
{ "id":"com.domain.pack", "appName":"我的应用", "debug":true, "launchPath": "index.html", "version": { "name": "1.0.0", "code": "100" }, ... }
launchPath
对应 web 应用入口文件,iOS 工程使用这个文件路径作为 webview 的加载入口。
secret.json 文件内容
{ "ios" : { "p12Password" : "123456" }, "android" : { "keyAlias" : "keyAlias", "keyPassword" : "123456", "storePassword" : "123456", "amapApiKey" : "", "jpushApiKey" : "", ... } }
除了交互界面外,打包服务还需要提供调起 Python 脚本的功能。
Python 打包脚本
基本所有的功能都使用脚本实现,使用 Python 编写打包脚本是因为 Python 用起来方便,刚开始打算用 Shell 来编写,执行效果可能好一些,但是对这个不熟,只好将就用 Python。我们的 web 服务采用 Java 编写,Java 是可以调用 Python 脚本的 ProcessBuilder pb = new ProcessBuilder(command.split(" "));
。打包脚本事先准备好,放在 web 服务站点根目录下,在解压完 www
zip 包之后,把脚本拷贝到与 www 目录同级目录中,然后执行脚本打包。打包脚本主要做以下几件事情:
下载 iOS 工程代码到指定目录
将客户端上传的 www 文件资源拷贝到 iOS 工程目录,应用图标、启动图等
修改 iOS 工程配置
导入证书到系统钥匙串
导入 mobileprovision 文件
编译工程
导出 ipa 安装包
打包脚本和客户端上传的 www 文件夹需要放在同一目录下。
实现难度不是很大,但是细节很多,需要反复实践尝试。脚本全部内容见文章末尾。
下载 iOS 工程代码到指定目录
svnChekoutCmd = 'svn co --username=%s --password=%s %s %s' %(SVN_USERNAME, SVN_PASSWORD, SVN_URL, checkoutPath()) p = subprocess.Popen(svnChekoutCmd, shell=True, stderr=subprocess.PIPE) p.wait()
从 svn 仓库拉取 iOS 工程代码,使用 svn checkout
命令把代码拷贝到指定目录,后面会使用这个目录下的工程进行编译。
将客户端上传的 www 文件资源拷贝到 iOS 工程目录
sourceWWWDir = currentDir() + '/www'projectWWWDir = '/packProject/www'destinationWWWDir = checkoutPath() + projectWWWDir copyFiles(sourceWWWDir, destinationWWWDir)for file in os.listdir(destinationWWWDir): if file.startswith('secret.json') or file.endswith('.mobileprovision') or file.endswith('.p12'): os.remove(destinationWWWDir + '/' + file)
将客户端上传的 www
文件夹拷贝到 iOS 工程中的 www 目录下。
iconAssetDirectory = checkoutPath() + '/packProject/Assets.xcassets/AppIcon.appiconset'iconSrcDirectory = projectWWWDir + '/Icons/ios'items = os.listdir(iconSrcDirectory)for filename in items: copyFile(iconSrcDirectory + '/' + filename, iconAssetDirectory + '/' + filename) clearDir(iconSrcDirectory)
将 www/Icons/ios
文件夹中的各种尺寸的应用图标拷贝到 Assets.xcassets/AppIcon.appiconset
目录中。这个需要事先编写好 AppIcon.appiconset
中的 Contents.json
文件,为每种尺寸的 icon 指定文件名,这里的文件名与 Icons/ios
目录下的图片文件名一一对应,所以,Icons/ios
中的图片名称是固定不变的。Contents.json
文件部分内容:
{ "images" : [ { "idiom" : "iphone", "size" : "20x20", "filename" : "40x40.png", "scale" : "2x" }, { "idiom" : "iphone", "size" : "20x20", "filename" : "60x60.png", "scale" : "3x" }, { "idiom" : "iphone", "size" : "29x29", "filename" : "58x58.png", "scale" : "2x" }, { "idiom" : "iphone", "size" : "29x29", "filename" : "87x87.png", "scale" : "3x" }, { "idiom" : "iphone", "size" : "40x40", "filename" : "80x80.png", "scale" : "2x" }, }
启动图资源的拷贝跟应用图标的拷贝一样,需要事先编写好 Contents.json
文件,并且启动图的名称也是固定的。
修改 iOS 工程配置
需要根据客户端上传的配置文件 appConfig.json
来修改工程配置。
首先,读取配置文件的内容,包括应用 id 、名称、版本号、编译号、应用入口等。Python 读取 json 文件字符串类型的值默认会转为 unicode 编码表示,需要进行处理,笔者专门写了一个 json_load_byteified
函数来处理这个问题。
其次,使用从配置文件中获取到的内容来修改 info.plist
文件。这里需要使用 MacOS 系统自带的工具 PlistBuddy
来辅助修改。
导入证书到系统钥匙串
p12FilePath = findFileInDirectory('.p12', sourceWWWDir) unlockKeychainCmd = 'security unlock-keychain -p %s' %MacOS_ADMIN_PASSWORD p = subprocess.Popen(unlockKeychainCmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait()if p.returncode != 0: print p.stderr.read() returnimportCertCmd = 'security import %s -P %s -T /usr/bin/codesign' % (p12FilePath, p12Password) p = subprocess.Popen(importCertCmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait()if p.returncode != 0: print p.stderr.read()
使用系统 security
工具将 p12 文件导入到系统钥匙串中,先打开系统钥匙串并提供系统管理员密码,然后再导入。
证书和私钥需要客户端事先准备好,并导出为 p12 文件一并放入 www 文件夹中上传(如何导出 p12 文件请自行查看官方文档)。p12 文件的密码规定写在
secret.json
文件中。
导入 mobileprovision 文件
provisionFileExtension = '.mobileprovision'provisionFilePath = findFileInDirectory(provisionFileExtension, sourceWWWDir)if not len(provisionFilePath) > 0: print ("[packageFailed]: Not found \'%s\' file in \'www\' directory.") %(provisionFileExtension) returnteamIdentifier = getMobileProvisionItem(provisionFilePath, 'TeamIdentifier') provisionUUID = getMobileProvisionItem(provisionFilePath, 'UUID') provisionName = getMobileProvisionItem(provisionFilePath, 'Name')# type – prints mobileprovision profile type (debug, ad-hoc, enterprise, appstore)provisionType = getMobileProvisionItem(provisionFilePath, 'type') teamName = getMobileProvisionItem(provisionFilePath, 'TeamName') desProvisionFilePath = PROVISONING_PROFILE_DIRECTORY + provisionUUID + provisionFileExtension copyFile(provisionFilePath, desProvisionFilePath)
读取 .mobileprovision
文件的信息,并将 uuid 作为它的文件名保存到 /Users/%s/Library/MobileDevice/Provisioning Profiles/
目录,完成导入。如果先前已经导入过该类文件(一般双击文件导入),打开这个目录可以看到,文件名都是 uuid。这里,除了 uuid 之外,还可以读取团队 id、名称以及文件类型(debug, ad-hoc, enterprise, appstore)等信息。
为了方便读取 .mobileprovision
文件信息,这里使用一个第三方命令行小工具。安装命令如下:
curl https://raw.githubusercontent.com/0xc010d/mobileprovision-read/master/main.m | clang -framework Foundation -framework Security -o /usr/local/bin/mobileprovision-read -x objective-c -
安装命令会使用 curl 工具下载源码,然后使用 clang 编译并将可执行文件输出到 /usr/local/bin/
目录,命名为 mobileprovision-read
,用法:
mobileprovision-read -f fileName [-o option]
该工具实现比较简单,使用 security
库解析 mobileprovision
文件,然后根据命令行输入的 option 选择输出结果,因为笔者没有对源码进行修改,所以需要对输出结果中的控制字符 \n
进行处理(removeControlChars
函数的作用)。
编译工程
编译源码。以前在苹果线上开发者文档可以查看 xcodebuild
用法,不知道什么时候删掉了,现在只能使用 man xcodebuild
查看 xcodebuild
用法,这个不多说。需要注意的是,刚才只是导入了 .mobileprovision
文件,工程配置并没有修改,所以没有关联起来。在 project.pbxproj
文件中有以下几个字段需要进行替换,替换完之后才算完成整个工程编译变量的配置。
PRODUCT_BUNDLE_IDENTIFIER PROVISIONING_PROFILE_SPECIFIER PROVISIONING_PROFILE
可以在命令行传入这几个编译变量完成替换,命令行中传入的编译变量优先级最高。
project.pbxproj
不是常见的文件格式,在不知道 xcodebuild 可以注入编译变量之前,找了一圈发现没有方便的工具可以用来编辑。有人建议先转成 json 然后再使用 json 编辑工具进行修改。笔者没有采纳,笔者想到用 sed,但 sed 只对简单的文本内容有效,这种嵌套层级太多的内容貌似匹配不了,所以,无法进行修改。awk 应该可以,但这个我没有尝试。
导出 ipa 安装包
创建 exportOptions.plist
文件并导出 .ipa
安装包。把生成的 .ipa
文件路径输出给 java 进程,java 进程将结果显示在界面上,方便客户端进行下载。
注意:
Python 脚本没有执行权限,需要使用 Chmod 命令添加执行权限。
脚本全部内容如下:
#!/usr/bin/env python# _*_ coding:utf-8 _*_import subprocessimport osimport jsonimport re SVN_USERNAME = 'Hansen'SVN_PASSWORD = '123456'SVN_URL = 'https://Hansen@svn.domain.com/svn/****/trunk/iOS/packProject'CHECKOUT_FOLDER = 'ios_source_code'MacOS_ADMIN_USER = 'packrobot'MacOS_ADMIN_PASSWORD = '123456'EXPORT_MAIN_DIRECTORY = "/Users/%s/Documents/ios_appArchive/" % MacOS_ADMIN_USER PROVISONING_PROFILE_DIRECTORY = "/Users/%s/Library/MobileDevice/Provisioning Profiles/" % MacOS_ADMIN_USERdef json_load_byteified(file_handle): return _byteify( json.load(file_handle, object_hook=_byteify), ignore_dicts=True )def json_loads_byteified(json_text): return _byteify( json.loads(json_text, object_hook=_byteify), ignore_dicts=True )def _byteify(data, ignore_dicts = False): # if this is a unicode string, return its string representation if isinstance(data, unicode): return data.encode('utf-8') # if this is a list of values, return list of byteified values if isinstance(data, list): return [ _byteify(item, ignore_dicts=True) for item in data ] # if this is a dictionary, return dictionary of byteified keys and values # but only if we haven't already byteified it if isinstance(data, dict) and not ignore_dicts: return { _byteify(key, ignore_dicts=True): _byteify(value, ignore_dicts=True) for key, value in data.iteritems() } # if it's anything else, return it in its original form return datadef currentDir(): return os.path.split(os.path.realpath(__file__))[0]def checkoutPath(): return currentDir() + '/' + CHECKOUT_FOLDERdef pullSvnSourceCode(): svnChekoutCmd = 'svn co --username=%s --password=%s %s %s' %(SVN_USERNAME, SVN_PASSWORD, SVN_URL, checkoutPath()) p = subprocess.Popen(svnChekoutCmd, shell=True, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print ('[packageFailed]: %s') %p.stderr.read() else: print ('Sucessfullly checkout source code at path: %s') %(checkoutPath())def clearDir(Dir): cleanCmd = "rm -r %s" %(Dir) process = subprocess.Popen(cleanCmd, shell=True) (stdoutdata, stderrdata) = process.communicate()def getAppConfig(): projectWWWDir = 'packProject/www' destinationWWWDir = currentDir() + '/' + CHECKOUT_FOLDER + '/' + projectWWWDir; appConfigFilePath = destinationWWWDir + '/appConfig.json' if os.path.exists(appConfigFilePath): appConfigReader = open(appConfigFilePath, 'r') appConfig = json_load_byteified(appConfigReader) appConfigReader.close() return appConfig return Nonedef copyFiles(sourceDir, destinationDir): if not os.path.exists(sourceDir): print ('[packageFailed]: Copy file -- sourceDir doesn\'t exist ') pass clearDir(destinationDir) for file in os.listdir(sourceDir): sourceFile = os.path.join(sourceDir, file) destinationFile = os.path.join(destinationDir, file) if os.path.isfile(sourceFile): if not os.path.exists(destinationDir): os.makedirs(destinationDir) if not os.path.exists(destinationFile) or (os.path.exists(destinationFile) and (os.path.getsize(destinationFile) != os.path.getsize(sourceFile))): open(destinationFile, "wb").write(open(sourceFile, "rb").read()) if os.path.isdir(sourceFile): copyFiles(sourceFile, destinationFile) print ('Copy assets success!')def copyFile(srcFile, dstFile): srcReader = open(srcFile, "rb") desWriter = open(dstFile, "wb") desWriter.write(srcReader.read()) srcReader.close() desWriter.close()def cleanArchiveFile(archiveFile): cleanCmd = "rm -r %s" %(archiveFile) process = subprocess.Popen(cleanCmd, shell=True) (stdoutdata, stderrdata) = process.communicate()def buildExportDirectory(): dateCmd = 'date "+%Y-%m-%d_%H-%M-%S"' process = subprocess.Popen(dateCmd, stdout=subprocess.PIPE, shell=True) (stdoutdata, stderrdata) = process.communicate() exportDirectory = "%s%s" %(EXPORT_MAIN_DIRECTORY, stdoutdata.strip()) return exportDirectorydef getMobileProvisionItem(filepath, key): cmd = 'mobileprovision-read -f %s -o %s' %(filepath ,key) p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE) p.wait() return removeControlChars(p.stdout.read())def updatePlistEntry(filePath, key, value): cmd = "/usr/libexec/PlistBuddy -c 'Set :%s %s' %s" % (key, value, filePath) p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print p.stderr.read()def deletePlistEntry(filePath, key): cmd = "/usr/libexec/PlistBuddy -c 'Delete :%s' %s" %(key, filePath) p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print p.stderr.read()def addPlistEntry(filePath, key, _type, value): cmd = "/usr/libexec/PlistBuddy -c 'Add :%s %s %s' %s" % (key, _type, value, filePath) p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print p.stderr.read()def findFileInDirectory(ext, dir): fileName = '' items = os.listdir(dir) for name in items: if name.endswith(ext): fileName = name break if not len(fileName) > 0: return '' return dir + '/' + fileNamedef removeControlChars(s): control_chars = ''.join(map(unichr, range(0,32) + range(127,160))) control_char_re = re.compile('[%s]' % re.escape(control_chars)) return control_char_re.sub('', s)def main(): # Pull ios project source code from svn. pullSvnSourceCode() # Copy 'www' files. sourceWWWDir = currentDir() + '/www' projectWWWDir = '/packProject/www' destinationWWWDir = checkoutPath() + projectWWWDir copyFiles(sourceWWWDir, destinationWWWDir) for file in os.listdir(destinationWWWDir): if file.startswith('secret.json') or file.endswith('.mobileprovision') or file.endswith('.p12'): os.remove(destinationWWWDir + '/' + file) # Copy app icons. iconAssetDirectory = checkoutPath() + '/packProject/Assets.xcassets/AppIcon.appiconset' iconSrcDirectory = projectWWWDir + '/Icons/ios' items = os.listdir(iconSrcDirectory) for filename in items: copyFile(iconSrcDirectory + '/' + filename, iconAssetDirectory + '/' + filename) clearDir(iconSrcDirectory) # Copy launch images. launchImageAssetDirectory = checkoutPath() + '/packProject/Assets.xcassets/LaunchImage.launchimage' LaunchImageSrcDirectory = projectWWWDir + '/LaunchImages/ios' items = os.listdir(LaunchImageSrcDirectory) for filename in items: copyFile(LaunchImageSrcDirectory + '/' + filename, launchImageAssetDirectory + '/' + filename) clearDir(launchImageAssetDirectory) # Read 'appConfig.json' file. appConfig = getAppConfig() if appConfig is None: print ("[packageFailed]: Not found \'%s\' file in \'www\' directory.") % ('appConfig.json') return versionName = appConfig['version']['name'] versionCode = int(appConfig['version']['code']) applicationId = appConfig['id'] appName = appConfig['appName'] mode = 'Debug' if appConfig['debug'] else 'Release' # Modify 'info.plist' file in project/workspace according to appconfig params those read from 'appConfig.json' file. infoPlistPath = checkoutPath() + '/packProject/' + 'info.plist' updatePlistEntry(infoPlistPath, 'CFBundleShortVersionString', versionName) updatePlistEntry(infoPlistPath, 'CFBundleVersion', versionCode) updatePlistEntry(infoPlistPath, 'CFBundleIdentifier', applicationId) updatePlistEntry(infoPlistPath, 'CFBundleDisplayName', appName) # Get p12 file's password. secretFilePath = sourceWWWDir + '/secret.json' if os.path.exists(secretFilePath): secretReader = open(secretFilePath, 'r') secretKeyDict = json_load_byteified(secretReader) secretReader.close() else: print ("[packageFailed]: Not found \'%s\' file in \'www\' directory.") % ('secret.json') return iosKeyDict = secretKeyDict['ios'] if 'ios' in secretKeyDict else None p12Password = iosKeyDict['p12Password'] if 'p12Password' in iosKeyDict else '123456' # Import p12 file into system keychain. p12FilePath = findFileInDirectory('.p12', sourceWWWDir) unlockKeychainCmd = 'security unlock-keychain -p %s' %MacOS_ADMIN_PASSWORD p = subprocess.Popen(unlockKeychainCmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print p.stderr.read() return importCertCmd = 'security import %s -P %s -T /usr/bin/codesign' % (p12FilePath, p12Password) p = subprocess.Popen(importCertCmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print p.stderr.read() # Read mobileprovision profile info. provisionFileExtension = '.mobileprovision' provisionFilePath = findFileInDirectory(provisionFileExtension, sourceWWWDir) if not len(provisionFilePath) > 0: print ("[packageFailed]: Not found \'%s\' file in \'www\' directory.") %(provisionFileExtension) return teamIdentifier = getMobileProvisionItem(provisionFilePath, 'TeamIdentifier') #MNxxxxx8 provisionUUID = getMobileProvisionItem(provisionFilePath, 'UUID') provisionName = getMobileProvisionItem(provisionFilePath, 'Name') # type – prints mobileprovision profile type (debug, ad-hoc, enterprise, appstore) provisionType = getMobileProvisionItem(provisionFilePath, 'type') teamName = getMobileProvisionItem(provisionFilePath, 'TeamName') desProvisionFilePath = PROVISONING_PROFILE_DIRECTORY + provisionUUID + provisionFileExtension copyFile(provisionFilePath, desProvisionFilePath) # Build archiveName = "%s_%s.xcarchive" % (applicationId, versionName) archiveFilePath = currentDir() + '/' + archiveName xcworkspaceFilePath = findFileInDirectory('.xcworkspace', checkoutPath()) projectSettingParams = 'PRODUCT_BUNDLE_IDENTIFIER=%s PROVISIONING_PROFILE_SPECIFIER=%s PROVISIONING_PROFILE=%s' %(applicationId, provisionName, provisionUUID) archiveCmd = 'xcodebuild -workspace %s -scheme %s -configuration %s archive -archivePath %s -destination generic/platform=iOS build %s' % (xcworkspaceFilePath, 'packProject', mode, archiveFilePath, projectSettingParams) p = subprocess.Popen(archiveCmd, shell=True, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print ("[packageFailed]: %s") %p.stderr.read() return # Create 'exportOptions.plist' file and export ipa. exportOptionsPlistFilePath = currentDir() + '/' + 'exportOptions.plist' addPlistEntry(exportOptionsPlistFilePath, 'provisioningProfiles', 'dict', '') addPlistEntry(exportOptionsPlistFilePath, 'provisioningProfiles:'+ applicationId, 'string', provisionUUID) addPlistEntry(exportOptionsPlistFilePath, 'teamID', 'string', teamIdentifier) # {app-store, ad-hoc, enterprise, development} method = 'development' if cmp(provisionType, 'debug') == 0 else provisionType method = 'app-store' if cmp(method, 'appstore') == 0 else method addPlistEntry(exportOptionsPlistFilePath, 'method', 'string', method) exportDirectory = buildExportDirectory() exportCmd = "xcodebuild -exportArchive -archivePath %s -exportPath %s -exportOptionsPlist %s" % (archiveFilePath, exportDirectory, exportOptionsPlistFilePath) p = subprocess.Popen(exportCmd, shell=True, stderr=subprocess.PIPE) p.wait() if p.returncode != 0: print ("[packageFailed]: %s") %p.stderr.read() else: ipaVersion = str(versionCode) if mode == 'Debug' else versionName ipaName = applicationId + '_' + ipaVersion + '.ipa' os.rename(exportDirectory + '/packProject.ipa', exportDirectory + '/' + ipaName) print("[packageName]: %s") % (ipaName) print("[packagePath]: %s") % (exportDirectory) cleanArchiveFile(archiveFilePath) p = subprocess.Popen('security lock-keychain', shell=True) p.wait()if __name__ == '__main__': main()
脚本并不限于将 web 工程打成 app,只是刚好笔者有这样的需求。欢迎留言交流。
作者:码不停蹄的忧伤
链接:https://www.jianshu.com/p/f5f60de46797
共同学习,写下你的评论
评论加载中...
作者其他优质文章