app-store-vsts-extension/CONTRIBUTING.md

Azure DevOps Extension for the Apple App Store Contributor Guide

The instructions below will help you set up your development environment to contribute to this repository. Make sure you've already cloned the repo. 😄

Ways to Contribute

Interested in contributing to this project? There are plenty of ways to contribute, all of which help make the project better.

• Submit a bug report or feature request through the Issue Tracker
• Review the source code changes
• Submit a code fix for a bug (see Submitting Pull Requests below)
• Participate in discussions

Set up Node and npm

Node and npm

Windows and Mac OSX: Download and install node from nodejs.org

Linux: Install using package manager

From a terminal ensure at least node 10.0.0 and npm 5.6.0:

$ node -v && npm -v
v10.24.1
6.14.12

Build

To build the extension, run the following from the root of the repo:

node make.js build

This command will create the _build folder at the root of the repository.

If you open the root of the repository in Visual Studio Code, you can build with Ctrl+Shift+B.

Tests

Tests should be run with changes. Before you run tests, make sure you have built the extension. Run the following from the root of the repo:

node make.js test

To run the tests within Visual Studio Code, select the Debug viewlet, change the debug profile to "Launch L0 Tests", set a breakpoint directly in the L0.js file (e.g., _build/Tasks/AppStoreRelease/Tests/L0.js) and press F5. At this time, you cannot debug the task itself during tests as a second node process is created (in which the task is run).

Testing task changes

In order to test your task changes, you will need to upload the new task to your own organization and test it with a build or release pipeline. First, create a pipeline you can use to test your changes. Then, after building the task you changed, upload the task to your organization. To upload a task, you will need to install the tfx-cli tool, login in to your organization with it (e.g., https://dev.azure.com/organization) and then upload the task. To do the actual uploading you can run the following from the _build/Tasks folder:

tfx build tasks upload --task-path ./AppStorePromote

Note: The task will only be uploaded if the version of the task has been incremented. To do this, update the patch version in the task's task.json and task.loc.json file. You will need to re-build the task after making this change.

To make subsequent changes, you can either remove the previous version of the task (using the tfx-cli tool) and re-upload an updated version, or simply increment the patch version again and re-upload the task.

Package

The package command will package the extension into a Visual Studio extension installer (.vsix file).

From the root of the repo:

node make.js packagetest

The VSIX package will be created in the root of the repository.

Code Styles

1. node make.js build will run tslint and flag any errors. Please ensure that the code stays clean.
2. All source files must have the following lines at the top:

 /*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

Contribution License Agreement

In order to contribute, you will need to sign a Contributor License Agreement.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Submitting Pull Requests

We welcome pull requests! Fork this repo and send us your contributions. Go here to get familiar with GitHub pull requests.

Before submitting your request, ensure that both node make.js build and node make.js test succeed.