feature/sc-77462/project-commands

[busticated]

Problem

The prtcl CLI now includes support for project-related build commands. The current compile, flash, and clean commands will be deprecated and removed

Solution

Move the test-build-system CI workflow over to the new project:compile and project:clean commands

Steps to Test

1. Using macOS...
2. Install the prtcl CLI (instructions)
3. Run the CI test script:
   • cd /path/to/device-os
   • ./ci/test-build-tasks.sh ./
4. Using linux (Ubuntu)...
5. Install the prtcl CLI (instructions)
6. Run the CI test script:
   • cd /path/to/device-os
   • ./ci/test-build-tasks.sh ./
7. Using Windows + Powershell...
8. Install the prtcl CLI (instructions)
9. Run the CI test script:
   • cd C:\\path\to\device-os
   • .\ci\test-build-tasks.ps1 .\
10. Observe the latest CI run in CircleCI

outcome

Scripts should run properly - exiting on error and otherwise reporting success. CI configuration changes should make sense and do what you expect.

References

https://app.shortcut.com/particle/story/77462

---

Completeness

• User is totes amazing for contributing!
• Contributor has signed CLA (Info here)
• Problem and Solution clearly stated
• Run unit/integration/application tests on device
• Added documentation
• Added to CHANGELOG.md after merging (add links to docs and issues)

[scott-brust]

I ran this locally with the latest prtcl and it seemed to work as expected

➜  ci git:(feature/sc-77462/project-commands) ✗ ./test-build-tasks.sh ../ p2
:::: Using prtcl v1.8.0
:::: Using Device OS at: ../
:::: Targeting platforms: p2
:::: Running task pairs: compile:user clean:user compile:all clean:all compile:debug clean:debug
Toolchain was previously installed
:::: Testing build tasks for p2

✔ Compiling project: undefined
✔ Using toolchain for deviceOS@source and p2...
- - - -
Running build task: "compile-user" for deviceOS@source [p2] against /Users/scottbrust/develop/device-os/user/applications/tinker/
- -

:::: COMPILING APPLICATION
...snip...

*** COMPILED SUCCESSFULLY ***

✔ Cleaning project: undefined
✔ Using toolchain for deviceOS@source and p2...
- - - -
Running build task: "clean-debug" for deviceOS@source [p2] against /Users/scottbrust/develop/device-os/user/applications/tinker/
- -

:::: CLEANING APPLICATION FOR DEBUG


*** CLEANED SUCCESSFULLY ***

:::: done!

Does test-build-tasks.sh run in CI somewhere with each build?

[busticated]

@scott-brust

Does test-build-tasks.sh run in CI somewhere with each build?

yes, see here and here. the test-build-system workflow runs when these branches are updated 👍