Swiftpack.co - Package - ZhengShouDong/CloudPacker

CloudPacker

CloudPacker Server - Swift Build Status

CloudPacker平台API调用说明文档

建议调用"/v1/build"接口之前先请求"/v1/status"接口,根据返回的code值判断当前服务状态,忙碌情况下请不要调用"/v1/build"接口!

注意:widget目录需要将最外层widget文件夹打包为.zip,否则ipa打包成功后无法正常运行!!

1.编译打包API

POST http://127.0.0.1:9603/v1/build

headers必须参数: "cloudPackerToken":"token"

body必须参数:

scheme: 这里针对当前原生项目(不固定)
exportType: 编译导出类型 dev,adhoc,enterprise,appstore
configuration: debug,release
zipUrl: 前端ZIP包资源URL
rootDirPath: 这里针对当前原生项目写死即可,原生项目相对xcodeproj所在路径,字符串类型
bundleID: 这里针对当前原生项目,例如:"cn.zhengshoudong.cn"
sdkString: iphoneos,iphonesimulator
p12FileName: 调用upload接口上传成功后返回的name(p12文件)
p12Password: p12文件的密码
mobileprovisionName: 调用upload接口上传成功后返回的name(mobileprovision文件)

以上参数值均为字符串类型,均区分英文大小写

返回内容: 服务器无任务进行且参数正常,返回内容如下 {"status": "Start Build","code": 0} HTTP状态码: 200

服务器已经有任务在进行中,返回内容如下 {"status": "Building","code": 1} HTTP状态码: 200

状态码不为200即为错误,请根据返回的json做处理

注意:虽已经做过后端处理,但频繁调用将导致服务变慢!如果发现对应token调用频繁,后端服务可以在数据库中进行措施!


2.上传文件API

POST http://127.0.0.1:9603/v1/upload

仅支持from表单的上传形式 返回内容:

上传成功 {"code": 1,"fileName": ""} HTTP状态码: 200

状态码不为200即为错误,请根据返回的json做处理


3.获取服务器状态API

GET http://127.0.0.1:9603/v1/status

返回内容: 服务器当前没有任务在进行 {"code": 0} HTTP状态码: 200

服务器当前有任务正在进行 {"code": 1} HTTP状态码: 200

状态码不为200即为错误,请根据返回的json做处理


4.获取模拟器包(.app)的列表API

GET http://127.0.0.1:9603/v1/applist

返回内容:

[{"time":"2017/11/18 16:30:47","path":"/v1/app/651D5342-646B-4A9C-8C5F-0F1F2D90AC3E.zip"},{"time":"2017/11/19 16:31:34","path":"/v1/app/6F5768A5-BF1B-40A2-89CD-D0DA68B4A62B.zip"},{"time":"2017/11/19 15:53:43","path":"/v1/app/923A697C-3048-4B22-A294-C3AD3813E3B5.zip"},{"time":"2017/11/19 16:28:49","path":"/v1/app/A2A791B1-000F-4973-8298-84A2B00D0F72.zip"},{"time":"2017/11/19 15:46:30","path":"/v1/app/B7EAAFA4-238F-491A-92F2-00D29509DD5C.zip"},{"time":"2017/11/19 16:05:44","path":"/v1/app/CDB052A0-1FAD-48A5-9A8C-D66A3ED8DFEF.zip"}]

time:打包时间

path:返回的字符串拼接到当前服务的地址上访问即可成功下载

例如: http://127.0.0.1:9603/v1/app/651D5342-646B-4A9C-8C5F-0F1F2D90AC3E.zip

下载完毕后,需要解压即可得到.app文件

使用时,将.app文件拖拽至模拟器中即可成功安装


5.获取真机包(.ipa)的平台-PackMan

调用编译服务编译打包.ipa包,后台服务编译打包完毕后将自动上传至PackMan平台! 在内网用Apple设备的Safari浏览器访问:http://127.0.0.1:1234/


author:郑守栋

文档更新日期: 2017-11-21