Jenkins serving Cake: our recipe for Windows
https://novemberfive.co/blog/windows-jenkins-cake-tutorial/
Where we started, or: why Cake took the cake
Before we started using Cake to build our Windows 10 applications, we used a similar setup, but instead of Cake we used an MSBuild script.
What went wrong? Well, nothing! We could do everything what we wanted with the MSBuild script. In fact, the Cake build script does exactly the same thing our old MSBuild file took care of.
So why did we replace the MSBuild script with Cake?
The answer is pretty simple: MSBuild uses xml to configure the build task. Cake build scripts are written in C#. As C# developers we write C# code on a daily basis, which means Cake, unlike MSBuild, feels instantly familiar (and doesn’t have us researching syntax on a regular basis). This means writing and changing the build scripts is easier, quicker, and fewer mistakes are made. It also means that any developer can make these changes, without having to go through a learning curve first.
Some more advantages for us were the fact that we can make identical builds wherever we want with Cake (on our local machine, Jenkins, …) and the fact that it offers a Visual Studio Code plugin with syntax highlighting.
Our recipe: application lifecycle management via Git, Jenkins and Cake for UWP
So how does our solution work?
Jenkins fetches the changes from Git via polling; gets and commits any new translations from Phraseapp; and starts the default Cake task.
Cake can then:
- clean the solution
- take care of the semantic versioning, based on git branches
- restore the nuget package
- perform the actual build of the applications
- run unit tests
- create an app package bundle
- sign the app package bundle
At this point, Jenkins kicks back into action. It archives the packages, in our case to Dropbox and to a dedicated server, and uploads the beta builds to Hockey app. It then notifies the developers and/or project manager via Slack when new builds are available or have failed.
Now, let’s get down to the details to help you get the same workflow!
Preparing your Cake
Step 1: Preparing Git
Only files necessary for building the application are checked in with Git. All other files, like binaries and helper files, are ignored. We do this via a gitignore. We have to ignore following folders: tools and build (a custom folder we created to temporarily store the build artifacts).
To do this, simply add the following lines to the gitignore file; you can place them anywhere in the file.
#Cake
build
tools
Step 2: Acquiring Cake
You can download Cake from the website, install via Powershell or use the Visual Code plugin to acquire it. You only need two files to start working with Cake. You can place these files anywhere in the repository, but we prefer to place them at the root.
- build.ps1: The bootstrapper powershell script. This file downloads Cake and its dependencies when needed. It contains a basic configuration and will start Cake.
- build.cake: This file contains our buildscript. It will have some basic configuration by default.
With these files in place, we can run Cake for the first time. To do so, start powershell with administrator rights. Go to the root of your repository, for example:
cd c:\projects\ExampleApp
Execute the bootstrapper script:
.\build.ps1
That’s it! You should now see something like this:
Step 3: Customizing the bootstrapper
In our company, we use three build types (build configurations in Visual Studio), which are aligned on all platforms:
- Debug: For development only
- Beta: For beta distribution and testing
- Release: The actual store build
The bootstrapper file (build.ps1) supports only Debug and Release by default. To better suit our needs, we replaced [ValidateSet("Release", "Debug")]
with [ValidateSet("Release", "Beta")]
.
Step 4: Making our Cake file
First, we clean up the solution and remove the old build artifacts, to make sure we start with a clean slate:
Task("Clean")
.Does(() =>
{
// Remove old build artifacts from the build output folder
CleanDirectories(projectPath + "/AppPackages");
// Clean the solution, uwp supports multiple platforms
foreach(var platform in supportedPlatforms)
{
MSBuild(solutionFile, configurator =>
configurator.SetConfiguration(buildConfiguration)
.SetVerbosity(Verbosity.Quiet)
.SetMSBuildPlatform(MSBuildPlatform.x86)
.SetPlatformTarget(platform)
.WithTarget("Clean"));
}
});
Next, we set up the semantic version of the app, using the GitVersion Tool. This version will be added in AssemblyInfo.cs. The GitVersion Tool is not part of the default Cake installation, so we have to add an import on top of the Cake.file:
#tool "nuget:?package=GitVersion.CommandLine"
Task("Versioning")
.IsDependentOn("Clean")
.Does(() =>
{
GitVersion(new GitVersionSettings {
UpdateAssemblyInfo = true
});
});
The next step is using a default command to restore the packages.
Task("NugetPackageRestore")
.IsDependentOn("Versioning")
.Does(() =>
{
NuGetRestore(solutionFile);
});
After this, we define the actual build. We do this multiple times, once for each platform.
Task("Build")
.IsDependentOn("NugetPackageRestore")
.Does(()=>{
foreach(var platform in supportedPlatforms)
{
MSBuild(solutionFile, configurator =>
configurator.SetConfiguration(buildConfiguration)
.SetVerbosity(Verbosity.Quiet)
.SetMSBuildPlatform(MSBuildPlatform.x86)
.SetPlatformTarget(platform)
.WithTarget("Build"));
}
});
After the build of the application, we run all our tests. In this example we run only unit tests. All the names of our unit test projects are ending with “.UnitTests”. We can use a wildcard to find all our test projects.
Task("Test")
.IsDependentOn("Build")
.Does(()=>{
MSTest("./Tests/**/*.UnitTests.dll");
});
As final step we sign the generated appxbundle. This is needed to install the app on Windows 10 mobile. If you want to install the app on a PC, just zip all files, because HockeyApp supports only one file for each app.
Task("Sign")
.IsDependentOn("Test")
.Does(()=>{
if (!buildConfiguration.Equals("Release"))
{
var appxBundles = GetFiles(projectPath + "/AppPackages/**/*.appxbundle");
Sign(appxBundles, new SignToolSignSettings {
TimeStampUri = new Uri("http://timestamp.digicert.com"),
CertPath = "certificate.pfx",
Password = "Password"
});
}
});
The full file should look like this:
Jenkins serving Cake: our recipe for Windows的更多相关文章
- Jenkins持续集成(上)-Windows下安装Jenkins
环境:Windows 2008 R2.Jenkins2.235.1: 概要 前面写过一篇文章,<自动发布-asp.net自动发布.IIS站点自动发布(集成SLB.配置管理.Jenkins)> ...
- jenkins简单安装及配置(Windows环境)
jenkins是一款跨平台的持续集成和持续交付.基于Java开发的开源软件,提供任务构建,持续集成监控的功能,可以使开发测试人员更方便的构建软件项目,提高工作效率. Windows平台下,一般安装方法 ...
- Jenkins的详细安装及使用--windows
操作环境:Windows 一.环境准备 1 安装JDK 本文采用jdk-8u111-windows-x64.exe: 2 配置tomcat 本文采用tomcat8,无需安装,配置JAVA_HOME及J ...
- 微软开放技术发布开源 Jenkins 插件以将 Windows Azure Blob 服务用的开作存储库
发布于 2014-02-10 作者 陈 忠岳 持续集成 (CI) 的历史源远流长, 其宗旨在于软件团队在敏捷环境中不断将他们的工作整合为持续构建.管理 CI 进程的工具已存在一段时间.过去几年中 ...
- NetBeans GUI tests on Jenkins + Windows (转)
from http://forgetfulprogrammer.wordpress.com/tag/interact-with-desktop/ Running NetBeans applicatio ...
- 【最新】Android使用jenkins全自动构建打包-Windows版本(Android,Jenkins,360加固,Email,QRcode,参数构建,蒲公英)
Android打包喝咖啡系列(Windows版) 这篇博客主要讲述的内容: 1.windows上部署Jenkins https://jenkins.io 2.基于SVN或Git https://git ...
- jenkins windows slave 构建c/c++代码
关于如何再centos系统上的jenkins master下搭建windows系统的jenkins slave节点,本篇博客中不做介绍,如果有需要的话,请参考我的另外一篇博客,在其中介绍了不同系统的j ...
- Installing Jenkins as a Windows service
Install Jenkins as a Windows service NOTE: if you installed Jenkins using the windows installer, you ...
- jenkins轻松玩玩远程windows的进程
飞测说:在持续集成的路上走了小半年,遇到的一些问题,今天来说一个折腾好几天的问题,和大家交流.我们都知道C#语言开发的,部署站点在IIS上,但是用持续集成的时候,发现经常因为w3wp进程导致文件无法覆 ...
随机推荐
- Springboot杂七杂八
1 加载配置文件 private static ResourceBundle resb = ResourceBundle.getBundle("serverInfo"); 然后在r ...
- python遍历某一位置所有文件夹中的文件
通过多次遍历达到找出所有文件的目的 import os rootdir=["d:/77"] c=[] for i in rootdir: for parent,dirnames,f ...
- jquer文字闪烁简单实现
arguments.callee <script type="text/javascript"> (function () { $(".usesend&quo ...
- Java多线程-----匿名内部类创建线程
1.继承Thread类创建线程 package com.practise.createthread; public class AnonymousThread { public static v ...
- 【2017-03-21】HTML表单及标记
一.表单 表单在网页中主要负责数据采集功能 表单格式 <form action="服务器路径" method=get(用的比较少)/post(最常用)></for ...
- 对SQLite 数据库的一点点了解
SQLite,是一款轻型的数据库,是遵守ACID的关系型数据库管理系统,它包含在一个相对小的C库中.它的设计目标是嵌入式的,它占用资源非常低,在嵌入式设备中,可能只需要几百k的内存就够了. SQLit ...
- Linux基础命令---ping
ping ping指令可以发送ICMP请求到目标地址,如果网络功能正常,目标主机会给出回应信息.ping使用ICMP协议强制发送ECHO_REQUEST报文到目标主机,从主机或网关获取ICMP ECH ...
- linux python虚拟环境 相关的
为什么要用虚拟环境 在使用python开发过程中,各种业务需求多了,导致工程任务多了,难免会碰到不同的工程依赖不同版本库的问题,;或者是在开发的时候不想让物理环境里充斥各种各样的库,引发依赖环境灾难, ...
- [转载]oracle的加密和解密
加密函数 create or replace function encrypt_des(p_text varchar2, p_key varchar2) return varchar2 isv_tex ...
- bp暴力破解(转载)
在kali linux系统环境下自带burpsuite软件工具. 一.打开浏览器需要先设置将代理设置为本地. 打开firefox浏览器->open menu->preferences-&g ...