Updating your experiment
When new features or bug fixes are added to Empirica, you should try to upgrade to the latest version.
Before upgrading, you can head over to the Empirica Release Notes to verify that there are no BREAKING CHANGES between your current and the latest versions.
At the root of your experiment, run
empirica version
:$ empirica version
Version: v1.0.0-rc.24
SHA: bc4184e
Build: 169
Branch: main
Time: 2022-12-28T08:21:58Z
Client: 1.0.0-rc.24
Server: 1.0.0-rc.24
You can update the packages in your experiment by running the following command at the root of your experiment:
$ empirica upgrade
Within your current experiment, this will upgrade both the
empirica
command and the npm packages used in client/
and server/
. This will not upgrade the empirica
command globally. To upgrade the empirica command globally, see Updating the Empirica commandIf you need to upgrade (or downgrade) to a specific version of Empirica, you can pass the exact version like so:
$ empirica upgrade --version "version: v1.2.3"
You can also choose to only upgrade the command line or the npm packages individually with either:
$ empirica upgrade --commandOnly
$ empirica upgrade --packagesOnly
To upgrade the
empirica
command globally (outside any existing experiment), run the following:$ empirica upgrade --global