How to install older versions of Cadence CLI using homebrew

[longquanzheng]

Why

This may be necessary after users upgrade their CLI without upgrading the server, or install the latest CLI.

1. Using a new CLI with old server may run into error of ClientVersionNotSupportedError. See details https://stackoverflow.com/questions/68217385/what-is-clientversionnotsupportederror-and-how-to-resolve-it/68217386#68217386

2. Also users may need to install older schemas.

Note that server always backward compatible to older CLI that it can support. So if you can upgrade server, you don't need to install old CLIs :)

How

1. Go to https://github.com/Homebrew/homebrew-core/blob/master/Formula/cadence-workflow.rb
2. Click History to find the version that you want to install. Remember the version to make sure it's available. E.g. 0.18.2
3. Use below commands to create a local tap and install the old version:

3.1: create a new local tap

brew tap-new $USER/local-cadence-workflow

Exact the formula of old version from homebrew/core into your local tap:

brew extract --version=0.18.2  cadence-workflow $USER/local-cadence-workflow

NOTE: replace 0.18.2 with the version that you want to install.

Then install the local-cadence-workflow with version:

brew install cadence-workflow@0.18.2

If you have installed new versions, you will see the errors:

Error: The `brew link` step did not complete successfully
The formula built, but is not symlinked into /usr/local
Could not symlink bin/cadence

If so you need to overwrite the links by the command:

brew link --overwrite cadence-workflow@0.18.3

Reference: https://cmichel.io/how-to-install-an-old-package-version-with-brew/