Fw Update
This command is meant to update an app which has already been installed in production mode to the newest available version (or the version which is specified). You will probably notice many noticeable similarities between this command and fw install
. Note: This cannot be used on an app which has been installed in development mode.
You can also optionally run fw u
as a shortened form of fw update
if you wish.
Directory to Run
This can be run in two different contexts: either the FW root (usually named either fw-dev
or fw-apps
), in which case the app
parameter must be specified. Or it can be run at the apps root directory (ie fw-apps/apps/sta
), in which case it will update the app of the location you are currently in, and the app parameter is unnecessary.
Arguments
There are two arguments available to this command, very similarly to fw install
:
app
is the app short code you wish to update. This parameter is required either by directory context or to be specified. If using the command within the app folder, this argument is set by context and unneeded.version
is a string which specifies the version of the app to update to. This is only available if app argument is specified (ie in the sta app folderfw update 0.5.1
will update to the most recent version of Status regardless of whether it matches that parameter or not). Note this must be used correctly in tandem with therollback
option (see below) in that if rollback is not specified, the selected version must be higher than the currently installed version, and if rollback is specified, the selected version must be lower than the currently installed version.
Extra Options
There are two additional options, besides those listed in the base options above. They are:
-f
|--force
is a flag option which will force an update, even if it is unneeded (ie if you are already on the most recent version, specifying force will re-download the most recent version). The default behavior is that if you are on the most recent version, there will be a message suggesting that an update is unneeded.-r
|--rollback
is a flag option which will, instead of updating an app (to the most recent available version or specified version), will roll an app back to an older version (to the immediately previous version to the current version or specified version). Thus to rollback an app you must use the command:fw update sta --rollback
.
Usage
So here is the structure of the fw update
command. If it is wrapped in <> it is a required, wrapped in [] means it is optional. See above for any questions.
C:\Users\[user]\fw-dev> fw update <app> [version] [--force --rollback]
C:\Users\[user]\fw-dev\apps\sta> fw update [--force --rollback]