You must be on a paid tier to take full advantage of the branching feature. For more information on pricing visit https://www.activestate.com/solutions/pricing/
Branches on the ActiveState Platform allow users to have more flexibility when working with complex projects. Branches bring support for experimental builds, managing complex multi-platform projects, different builds per environment, and more. The benefits of using branches in your project include
Changes made on a branch are localized, so you can safely experiment on other branches without impacting your main branch. Branches can also be kept in sync with changes made to the main branch, assuring your entire project can be free of security risks.
You can now configure each branch to suit the needs of your project. You can add or remove packages included from the main project, as well as change the language version and even the operating system requirement for the branch.
To make changes to your branch go to your project’s Overview tab and click the Configure button next to the branch you wish to change.
You can make changes to this branch the same way you would with the main project. Except any changes you make will be restricted to only this branch, and will not affect other branches or the main project.
If the main branch has been updated (by you or another authorized owner), each associated branch will get a notification prompting you to keep it in sync with the main branch.
This is especially useful when
Updating branches is voluntary, but may be an expectation of the main project or your organization. See below to update your branch and sync to the main project
All merging must be done using the Platform. The State Tool currently does not allow merging upstream changes into a child branch.
state branch to see available branches of your project.
state switch <branchname> to change branches.
You will see a
Successfully switched to branch: <branchname> message in your command terminal when the switch has been successful.
The Overview tab of your project page will show Install buttons for your main project as well as all available branches. After clicking Install, follow the prompts in the “Download & Install Runtime” window to install the branch.
state checkout <orgname>/<projectname> --branch <branchname> to download the project branch directly. Then enter
state use <orgname>/<projectname> to set the branch as the system default. To verify that you are working on the correct branch, enter
state branch to see your current working branch as well as other available branches.