Build Test Packages From A Release Branch

From Joomla! Documentation

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎हिन्दी

Occasionally, new features and existing bugs need to be tested during install or update between Joomla! versions. The build script found in the CMS repo on GitHub can be easily modified to build packages from a feature branch, and will result in the full array of packages (full install and update) available for use.


In order to build the packages, your local checkout must be in sync with the base Joomla! CMS repo, to include all release tags. This is important because the build script uses the git tags created at each release to build the update packages. Next, your feature branch should be in sync with the staging branch from the Joomla! CMS repo to ensure that the current code is being tested in addition to your proposed changes.

Editing the Build Script[edit]

To build packages from your feature branch, all you need to do is make two changes to the build script.

  • Line 66:
    • Change this line to read "system($gitPath . ' archive BRANCH-NAME | tar -x -C ' . $fullpath);" and replace your branch name as appropriate
  • Line 144:
    • Change this line to read "$command = $gitPath . ' diff tags/' . $previousTag . ' BRANCH-NAME --name-status > diffdocs/' . $version . '.' . $num;" and replace your branch name as appropriate

Run the Script[edit]

So long as you don't have any PHP syntax errors and each of the release tags are available in your local checkout, you should be able to run the build script and have full packages ready for testing.