通过“Android APK签名”构建步骤,使用apksigner对Android APK进行签名。
配置说明
1. 在“Android构建”步骤后添加“Android APK签名”步骤。
参数说明如下:
参数 说明
需要签名的APK路
径 Android构建后生成要签名的.apk文件位置,支持正则表达 式,如:可以使用build/bin/*.apk匹配构建出来的APK包。
Keystore文件 用于签名的Keystore文件,单击下拉列表,展示文件管理 页面已经上传的Keystore文件,请根据需要选择。
keystore
password 密钥文件密码。
别名(Alias) 密钥别名。
key password 密钥密码。
apksigner命令行 用户自定义签名参数,默认“--verbose”显示签名详细。
2. 验证签名是否成功。
配置完成后执行构建任务,当显示任务执行成功后,查看构建日志,若“Android APK签名”那段日志中显示“result: Signed”即为签名成功。
添加“Npm构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 根据需要选择工具版本。
命令 配置Npm命令,一般使用系统默认生成的命令即可。如有特殊 构建要求,可以在文本域中输入自定义的构建脚本。
4.6 Gradle 构建
使用Gradle构建工具构建Java,Groovy和Scala项目。
配置说明
添加“Gradle构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
Gradle 根据需要选择Gradle版本。
JDK 根据需要选择JDK版本。
命令 配置Gradle命令,一般使用系统默认生成的命令即可。如有特 殊构建要求,可以在文本域中输入自定义的构建脚本。
使用SetupTools打包时,需要保证代码根目录下存在“setup.py”文件。
● 关于setup文件写法请参见Python官方说明。
● “setup.py”文件请参见https://www.python.org/search/?
q=setup&submit=。
配置说明
添加“SetupTool构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择工具版本。
参数项 说明
命令 配置构建打包命令。
● 可以使用默认的命令打包为“egg”格式的文件。
● Python2.7后建议使用python setup.py sdist
bdist_wheel,打包为源码包和whl格式的安装包,以便使 用pip安装。
4.8 PyInstaller 构建
使用Pyinstaller工具构建Python项目。
自定义安装
pip安装Python的组件。
配置说明
添加“PyInstaller构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择工具版本。
命令 配置打包命令,使用zip命令将源码所在目录打包。
4.10 Gnu-arm 构建
使用GNU-ARM工具链设计、开发和使用 ARM 模拟器。
配置说明
添加“Gnu-arm构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择ARM工具版本。
使用arm-linux-gcc命令,例如arm-linux-gcc -o main main.c
– gnuarm-7-2018-q2-update镜像
使用arm-none-eabi-gcc命令,例如arm-none-eabi-gcc --specs=nosys.specs -o main main.c
说明
● Linux下的GNU的makefile编写,请参见官网。
● 注意Makefile只有行注释 "#", 如果要使用或者输出"#"字符, 需要 进行转义, "\#等。
4.11 Msbuild 构建
背景信息
编译构建服务提供了常用的构建模板(构建环境),不同的构建模板中预装了对应构 建所需工具集,MSBuild构建镜像一般预装了msbuild、nuget、.NET Frameword等常 用工具。
使用msbuild构建工具执行引擎、构造工程,支持.NET框架构建,包含.NET Core 和.NET Frameworks。
配置说明
添加“Msbuild构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择Msbuild构建工具版本。
● 请选择相应的.NET版本。
● msbuild15-all版本的工具提供更多的构建支持,如nant、
nodejs的构建命令支持等。
powershell命令 配置Msbuild命令,一般使用系统默认给出的命令即可。
● nuget restore命令会还原csharp项目依赖。
● msbuild命令构建项目:
– OutputPath会指定生成路径,此路径设置会以csproject文 件为相对路径。
– 项目存在多个csproject时可能会因此导致构建失败,删除 路径指定参数后可构建成功。
● .NET Core项目请尝试使用.NET相关命令构建。
Msbuild 系统规格说明
为方便使用,编译构建服务提供的Msbuild构建环境原则上尽可能保持与本地环境一
● 一些特殊场景(如构建时指定输出目录为“Output/release”)下,可能会额外占
– 由于Windows特殊性,通常情况下,此类程序集默认安装于本地系统,无需 指定程序集位置,VS构建时会从默认配置的几个程序集路径查找,可以构建 成功。
而云端构建环境对应目录无此程序集,进而导致云端构建环境与本地不一致 带来的失败。
– 为解决此类场景,Msbuild集成了NuGet,可以在构建时从远程仓库下载对应 程序集,此时只需于项目中指定“packages.config”,并于其中声明依赖的
cd test\test1或cd test\\test1
正确示例:
cd test/test1
● 避免直接指定低版本SDK路径
– 编译构建服务提供了“.NET Framework”的4.7.2版本和3.5版本(详细说明 请参见已支持的镜像版本及工具集)。
一般来讲,4.7.2版本可以兼容4.0以上版本SDK,3.5版本可以兼容3.5版本以 下SDK,项目中可以引用兼容版本的SDK内容。
– 在某些场景下,用户可能将引用直接指向了某个低版本的sdk路径,此时会因 找不到SDK导致构建失败。
如果您的项目出现此类场景,我们建议:
▪
尝试更改您的引用路径,尽可能使用兼容版本SDK。▪
如果您的项目因为不可回避的原因,必须指向低版本SDK路径,请尝试 联系客服。Msbuild 构建场景
● 已支持场景 nuget restore命令下载所有依赖,此后使用msbuild命令进行 构建。.NET命令无需先执行nuget命令。
例如:项目使用了“dotnetframework4.7.2”的SDK,依赖了 Myget上某Package并使用Nuget添加了该依赖。可选用
“msbuild15-dotnetframework4.7.2”版本镜像,使用nuget restore && msbuild命令构建。
其他 对于有其他命令需求的项目,如Git、JDK、Nant、Nodejs等,
请参见msbuild15-all版本镜像构建工具集的说明,使用支持的 本低于VS2015(不 包含)
对于使用VS2015(不含)以前版本创建的解决方案,会出现版 本过低不兼容的情况,导致构建失败。请尝试升级解决方案。
Powershell 命令使用
名。
Expand-Archive(解 压缩命令)
powershell –Command Expand-Archive -Path [SourcePath] -DestinationPath [TargetPath]
● SourcePath
指定需要解压的文件,如“demo.zip”。
● TargetPath
要解压到的目标路径,支持通配符和相对路径。
Copy-Item
(复制命 令)
powershell –Command CopyItem Recurse Path [SourcePath] -DestinationPath [TargetPath]
● SourcePath
指定需要复制的文件或文件夹,支持通配符和相对路径。
● TargetPath
要复制到的目标路径,支持通配符和相对路径。
说明-Recurse选项为循环复制子文件夹,但若在SourcePath中使用了通配 符,此开关会失效,不会复制指定目录下的子文件夹。
其他命令 文档只介绍了构建常用的Powershell命令,更多Powershell命令 请参见微软官方文档:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择Cmake构建工具版本。
命令 配置Cmake命令,一般使用系统默认给出的命令即可。如有特 殊构建要求,可以在文本域中输入自定义的构建脚本。
4.13 Ant 构建
Apache Ant是一个Java项目的构建工具,用于编译、测试和部署Java项目。
前置准备
项目为Java语言Ant结构,有正确的“build.xml”构建描述文件。
操作步骤
添加“Ant构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 默认使用推荐版本,可以根据需要选择和自己编译环境匹配的 Ant与JDK镜像版本。
命令 配置Ant构建命令,一般使用系统默认给出的命令即可。如有 特殊构建要求,可以在文本域中输入自定义的构建脚本。
4.14 Golang 构建
使用Go语言环境构建。
前置条件
项目为Go语言开发项目,代码中有构建描述文件。
配置说明
添加“Go语言构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 请根据需要选择工具版本,默认使用推荐版本,可以根据需要 选择和自己编译环境匹配的Go版本。
命令 配置Go项目构建命令,一般使用系统默认给出的命令即可,如 有特殊构建要求,可以在文本域中输入自己的构建脚本。
4.15 Android-Ionic 构建
背景信息
● Ionic是一款基于Angular、Cordova的强大的HTML5移动应用框架,可以快速创 建一个跨平台的移动应用。
● 支持快速开发移动App、移动端Web页面、混合App和Web页面。
自定义安装 npm 组件
● 全局安装:npm install –g xxx。
● 项目下安装:npm install xxx。
● 如果发现镜像内安装的npm组件不符合要求,可以按照如下方式卸载,然后安装
配置说明
步骤1 确认Ionic项目已经上传到codehub代码仓库。
项目中包含“ionic.config.json、package.json”和“andular.json”等项目编译描述文 件。
步骤2 添加“Ionic Android App构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 根据需要选择Gradle、JDK和NDK版本。
命令 配置命令框中的打包脚本。
----结束
4.16 Quickapp 快应用构建
本节主要介绍快应用签名的构建步骤-Android快应用构建。
自定义安装
npm config set xxx命令:配置Npm相关设置。
配置说明
添加“Android快应用构建”构建步骤,如图:
参数说明如下:
参数项 说明
步骤显示名称 构建步骤的名称,可自定义修改。
工具版本 根据需要选择构建工具版本。
快应用签名操作:
1. 通过openssl命令等工具生成签名文件“private.pem”、
“certificate.pem”,例如:
openssl req -newkey rsa:2048 -nodes -keyout private.pem -x509 -days 3650 -out certificate.pem
在工程的“sign”目录下创建“release”目录,将私钥文 件“private.pem”和证书文件“certificate.pem”拷贝进 去。
2. 发布程序包前需要增加release签名,然后在工程的根目录 下运行:npm run release
生成的应用路径为“/dist/.release.rpk”。
3. 如果需要临时使用debug签名,可以使用:
npm run release -- --debug
说明由于debug签名是公开的,安全性无法保证,一定不要使用debug 签名签发正式上线的应用。
● Dockerfile制作请参见官网。
● Dockerfile是由一系列命令和参数构成的脚本,这些命令应用于基础镜像并最终创建一个新 的镜像。它们简化了从头到尾的流程并极大的简化了部署工作。
● Dockerfile从FROM命令开始,紧接着跟随各种方法、命令和参数。
● 编译构建提供两种基础镜像,可基于该基础镜像制作Dockerfile文件,详见自定义构建环
● 编译构建提供两种基础镜像,可基于该基础镜像制作Dockerfile文件,详见自定义构建环