/padavan-builder-workflow

Automatic Padavan firmware builds using GitHub servers

English | Русский

Automatic Padavan firmware builds using GitHub servers

Usage

  • Fork this repository, further steps should be performed in your fork

  • Copy your build config to build.config

    Build config template can be found in the firmware repository

  • Run the build process: Actions → Build firmware → Run workflow

    run workflow

    The build process will appear on the same page (if it doesn't appear, just refresh the page). You can get process details by clicking on it.

    Depending on the build config, build process usually takes from 10 to 60 minutes.

  • While the process is in progress, its status indicator would be gold-ish circle

    workflow status progress

  • If the process finishes successfully, its status indicator would turn green with a check mark

    workflow status success

    Click on the finished process. Archive with the firmware would be stored as its artifact:

    workflow artifacts

    Firmware license does not permit binaries distribution, so artifacts are stored for 7 days for personal use.

  • If the process finishes with an error, its status indicator would turn red with a cross

    workflow status fail

    Click on the finished process. To get details about the error, click on the failed build job at the left:

    workflow details fail

    Job report will be opened:

    workflow details get logs

    Here it's immediately obvious that it was Check firmware size step that failed — it is marked with a red circle with a cross. Specific reason is shown below: Firmware size (18,492,849 bytes) exceeds max size (16,187,392 bytes) for your target device — i.e. built firmware size is too big for the target device.

    In case of any error its reason is usually shown at the end of the log, as in the example above. To view full log click on the cog ⚙️ icon in the top right corner → View raw logs. You can also download compressed log archive in the same menu → Download log archive.

    If you can't figure out the problem on your own, you can ask community or firmware developer for help. In this case don't forget to attach the log archive.

Updating your fork

To sync your fork with its origin repository, just click Sync fork → Update branch at the top of the main page of your fork:

sync fork

Advanced usage

You can set the firmware repository, branch, specific tag or commit in the variables file.

In the variables file you can also specify which themes you want to install by uncommenting theme names in the PADAVAN_THEMES variable. Themes repository can be set with the PADAVAN_THEMES_REPO variable.

You can create a pre-build.sh script with any custom commands, which will be executed just before build process. By that time firmware source code is already downloaded, so you can add or change anything in it.

You can create a post-build.sh script, which will be executed right after build process.

Discussion: https://github.com/shvchk/padavan-builder-workflow/discussions/categories/general