The first step in publishing a new version of your Application is creating a Release:
dblsqd release $version
$version needs to be replaced with a unique name later used to
identify this release.
It is typically a good idea to use a naming scheme compatible with Semantic Versioning 2.0. This allows for some additional features such as ordering by version number and targeted delta versions which are described in a later section of this chapter.
dblsqd release interactively asks
for a changelog message.
Alternatively, you can specify one or more changelog paragraphs with the
A Release can contain one or multiple Artifacts.
Artifacts are the files you want to distribute to your users, e. g. installation packages or installers.
DBLSQD is platform-agnostic and allows for a single Release to have Artifacts for multiple operating systems and processor architectures.
You can upload an Artifact with the
dblsqd push $os:$arch $/path/to/artifact
$arch should represent the Artifact’s
operating system and processor architecture respectively.
An Artifact can be marked as a patch by specifying the
Typically, patches are delta updates to the previous Release.
If you are a versioning scheme compatible with Semantic Versioning 2.0, you can also specifically target the patch at one or more previous Releases with the operators familiar from package managers such as npm, gem or hex.
--patch 0.1.1 denotes a patch that should be applied to the
--patch "~> 0.1" matches all versions that are greater or
equal to 1.1.0 yet smaller than (not including) 2.0.0.
--patch ">= 1.1.0 and < 1.3.0" matches all versions that are greater or
equal to 1.1.0 and smaller than (not including) 1.3.0.
Sometimes you might need multiple different Artifacts for the same operating system and processor architecture in a Release. This is when you can use Artifact Types.
A typical use case would be a Windows application for which you want to publish a regular .exe installer, an .msi package and a portable .zip version .
The default Artifact Type in DBLSQD is standalone and is always assumed when no other type is specified.
In the case of the aforementioned Windows application, publishing a new Release could look like this:
dblsqd push win:x86_64 octaplay-1.0.0.exe dblsqd push win:x86_64 octaplay-1.0.0.msi --type msi dblsqd push win:x86_64 octaplay-1.0.0-portable.zip --type portable
Artifact Types also play a role when targeting specific Feeds. More about this in the next chapter of this Guide.
Next up in the DBLSQD Guide:
Are you stuck?
Are you stuck or need help setting things up?
Let us know at hello - at - dblsqd com and we’ll be happy to assist you!