https://github.com/melezhik/sparrowdo-vsts-cordova

Sparrowdo module to generate VSTS yaml build definition steps for Cordova build
https://github.com/melezhik/sparrowdo-vsts-cordova

automation build build-tool cd ci cicd cordova devops ios microsoft perl6 uwp vsts

Last synced: 3 days ago
JSON representation

Sparrowdo module to generate VSTS yaml build definition steps for Cordova build

• Host: GitHub
• URL: https://github.com/melezhik/sparrowdo-vsts-cordova
• Owner: melezhik
• Created: 2018-07-27T20:07:08.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-10-18T15:07:13.000Z (about 6 years ago)
• Last Synced: 2024-11-05T20:51:50.007Z (about 2 months ago)
• Topics: automation, build, build-tool, cd, ci, cicd, cordova, devops, ios, microsoft, perl6, uwp, vsts
• Language: Perl
• Size: 77.1 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# Sparrowdo::VSTS::YAML::Cordova

Sparrowdo module to generate VSTS yaml build definition steps for Cordova build.

# Platform supported

* Windows

For building Cordova for iOS/OSx see [Sparrowdo::Cordova::OSx::Build](https://github.com/melezhik/sparrowdo-cordova-osx-build) module.

# Prerequisites

* Perl5

# Usage

    $ cat sparrowfile

    module_run "VSTS::YAML::Cordova", %( 

      build-dir => "vsts/build",

      build-configuration => "debug", # build configuration, default value  

      build-arch => "x86" # build architecture, default value  

    );

    $ sparrowdo --no_sudo --local_mode

# Visual studio project creation

If only need to create VS source code, use `prepare-only` flag:

    prepare-only => True

# MSBuild/VS configuration

Use following parameter to adjust MSBuild and Visual Studio settings:

    Parameter               | Meaning                            | Default value

    ===============================================================================================================================================

    vs-inst-dir             | Visual  Studio install directory   | C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional

    ms-build-dir            | MS Build exe install directory     | C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\Bin

    make-pri-exe-full-path  | Path to MakePri.exe tool           | C:\Program Files (x86)\Windows Kits\10\bin\10.0.17134.0\x86\MakePri.exe

    ===============================================================================================================================================

# Per branche/env configurations

Modules supports source branches configuration int two flavors:

## Data configuration

The method copies "branch specific" files to `src/assets/jsons/` directory.

The data files should be located at `src/env/$target/$source_code_branch/.*json` where:

- `$source_code_branch` is SCM branch name

- `$target` is `uwp` or `ios`

Example:

    # target = uwp

    # $source_code_branch = production

    

    cp -r src/env/uwp/production/*.json src/assets/jsons/

## Command configuration

The method executed "branch specific" windows commands.

Command files should be located at `src/env/$target/$source_code_branch/` where:

- `$source_code_branch` is SCM branch name

- `$target` is `uwp` or `ios`

The commands are executed in order defined by their files names ( alphabetic order )

Example:

    # $source_code_branch = production

    

    ls -1 src/env/uwp/production/

    00-command.cmd # executed  first

    01-command.cmd # executed  second

    02-command.cmd # excecuted third, so on

You can use Powershell or Perl scripts as well:

    00-command.cmd # windows batch script 

    01-command.pl  # Perl script

    02-command.ps1 # Powershell script 

You may define `default` branch to execute command for any branch not matching listed branches:

    src/env/$target/default/

# VSTS Build configurations

These variables adjust build logic:

- Build.$source_code_branch.Configuration 

Set configuration for `cordova build` command.

For example:

    Build.Production.Configuration = "release" # Set release configuration for production branch 

    Build.Default.Configuration = "debug" # Set debug configuration by default

- Build.NoPatchRevision

Disable revision version patching. Helpful when you create build for windows store.

# Author

Alexey Melezhik