Skip to content

DEV_ENVIRONMENT.md

Latest commit

 

History

History
66 lines (51 loc) · 3.54 KB

DEV_ENVIRONMENT.md

File metadata and controls

66 lines (51 loc) · 3.54 KB

Developer guide: getting your environment set up

  1. Make sure you have both node and yarn installed. We recommend using nvm to manage your node versions.
  2. angular/components uses Bazel which requires certain Bash and UNIX tools.
    • On Windows: Follow the instructions to install MSYS2 and the listed "Common MSYS2 packages". Afterwards add C:\msys64\usr\bin to the PATH environment variable.
  3. Fork the angular/components repo on GitHub.
  4. Clone your fork to your machine with git clone. Recommendation: name your git remotes upstream for angular/components and <your-username> for your fork. Also see the team git shortcuts.
  5. From the root of the project, run yarn to install the dependencies.

To build angular/components in release mode, run yarn build. The output can be found under dist/releases.

To bring up a local server, run yarn dev-app. This will automatically watch for changes and rebuild. The browser should refresh automatically when changes are made.

Running tests

To run unit tests, run yarn test <target>. The target can be either a short name (e.g. yarn test button) or an explicit path yarn test src/cdk/stepper. To run the e2e tests, run yarn e2e. To run lint, run yarn lint.

Getting Packages from Build Artifacts

Each CI run for a Pull Request stores the built Angular packages as build artifacts. The artifacts are not guaranteed to be available as a long-term distribution mechanism, but they are guaranteed to be available around the time of the build.

You can access the artifacts for a specific CI run by going to the workflow page, clicking on the upload_release_packages job and then switching to the "Artifacts" tab.

Archives for each Package

On the "Artifacts" tab, there is a list of links to compressed archives for Angular packages. The archive names are of the format <package-name>-pr<pr-number>-<sha>.tgz (for example material-pr12345-a1b2c3d.tgz).

One can use the URL to the .tgz file for each package to install them as dependencies in a project they need to test the Pull Request changes against. Yarn supports installing dependencies from URLs to .tgz files. As an example, update the dependencies in package.json to point to the artifact URLs and then run yarn to install the packages:

"dependencies": {
  "@angular/cdk": "https://<...>.circle-artifacts.com<...>/cdk-pr12345-a1b2c3d.tgz",
  "@angular/material": "https://<...>.circle-artifacts.com<...>/material-pr12345-a1b2c3d.tgz",
}

Download all Packages

In addition to the individual package archives, a .tgz file including all packages is also available (named all-pr<pr-number>-<sha>.tgz). This can be used if one prefers to download all packages locally and test them by either of the following ways:

  1. Update the dependencies in package.json to point to the local uncompressed package directories.
  2. Directly copy the local uncompressed package directories into the node_modules/ directory of a project.

Approving public API changes

If you're making changes to a public API, they need to be propagated to our public API golden files. To save the changes you can run yarn approve-api <target> and to review the changes, you can look at the file under tools/public_api_guard/<target>.d.ts.