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 folder fw 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 the rollback 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]