Skip to content

Latest commit

 

History

History
158 lines (106 loc) · 5.07 KB

README-MAINTAINER.md

File metadata and controls

158 lines (106 loc) · 5.07 KB
Raw

license CI on Push GitHub issues GitHub pulls

Maintainer info

Project repository

The project is hosted on GitHub:

To clone the stable branch (xpack), run the following commands in a terminal (on Windows use the Git Bash console):

rm -rf ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git && \
mkdir -p ~/Work/micro-os-plus && \
git clone \
  https://github.com/micro-os-plus/devices-qemu-aarch64-xpack.git \
  ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git

For development purposes, clone the development branch (xpack-develop):

rm -rf ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git && \
mkdir -p ~/Work/micro-os-plus && \
git clone \
  --branch xpack-develop \
  https://github.com/micro-os-plus/devices-qemu-aarch64-xpack.git \
  ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git

Prerequisites

A recent xpm, which is a portable Node.js command line application.

To run the native tests, a C++ development environment is required. On macOS install Command Line Tools, on Ubuntu build-essential.

Code formatting

Code formatting is done using clang-format --style=file, either manually from a script, or automatically from Visual Studio Code, or the Eclipse CppStyle plug-in.

Always reformat the source files that were changed.

How to make new releases

Release schedule

There are no fixed releases.

Check Git

In the micro-os-plus/devices-qemu-aarch64-xpack Git repo:

  • switch to the xpack-develop branch
  • if needed, merge the xpack branch

No need to add a tag here, it'll be added when the release is created.

Increase the version

Determine the upstream version (like 4.0.0) and eventually update the package.json file; the format is 4.0.0-pre.

Fix possible open issues

Check GitHub issues and pull requests:

and fix them; assign them to a milestone (like 4.0.0).

Update README-MAINTAINER.md

Update the README-MAINTAINER.md file to reflect the changes related to the new version.

Update CHANGELOG.md

  • open the CHANGELOG.md file
  • check if all previous fixed issues are in
  • add a new entry like * v4.0.0
  • commit with a message like prepare v4.0.0

Push changes

  • reformat the source files that were changed
  • commit and push

Manual tests

To run the tests manually on the local machine:

xpm run install-all -C ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git
xpm run test-all -C ~/Work/micro-os-plus/devices-qemu-aarch64-xpack.git

Publish on the npmjs.com server

  • select the xpack-develop branch
  • commit all changes
  • npm pack and check the content of the archive, which should list only package.json, README.md, LICENSE, CHANGELOG.md, the sources and CMake/meson files; possibly adjust .npmignore
  • npm version patch, npm version minor, npm version major
  • push the xpack-develop branch to GitHub
  • the postversion npm script should also update tags via git push origin --tags
  • wait for the CI job to complete (https://github.com/micro-os-plus/devices-qemu-aarch64-xpack/actions/workflows/ci.yml)

Test on all platforms

In addition, it is possible to manually trigger a test-all job, that runs all available builds, on all supported platforms, including Linux Arm and macOS Apple Silicon.

For this:

Publish

  • npm publish --tag next (use npm publish --access public when publishing for the first time)

The version is visible at:

Update the repo

When the package is considered stable:

  • with a Git client (VS Code is fine)
  • merge xpack-develop into xpack
  • push to GitHub
  • select xpack-develop

Tag the npm package as latest

When the release is considered stable, promote it as latest:

  • npm dist-tag ls @micro-os-plus/devices-qemu-aarch64
  • npm dist-tag add @micro-os-plus/devices-qemu-aarch64@4.0.0 latest
  • npm dist-tag ls @micro-os-plus/devices-qemu-aarch64