Build Test Packages From A Release Branch

From Joomla! Documentation

This page contains changes which are not marked for translation.
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 repository on GitHub can be easily modified to build packages from a feature branch, and will result in the entire 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, just 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]

If 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.