#!/usr/bin/env bash ## ## ## ## ## : ------------------------------------------ : Introduction : ------------------------------------------ # This script allows you to install the latest version of the # "firebase" command by running: # : curl -sL firebase.tools | bash # # If you do not want to use this script, you can manually # download the latest "firebase" binary. # : curl -Lo ./firebase_bin https://firebase.tools/bin/linux/latest # # Alternatively, you can download a specific version. # : curl -Lo ./firebase_bin https://firebase.tools/bin/linux/v7.2.2 # # Note: On Mac, replace "linux" with "macos" in the URL. # # For full details about installation options for the Firebase CLI # please see our documentation. # https://firebase.google.com/docs/cli/ # # Please report bugs / issues with this script on Github. # https://github.com/firebase/firebase-tools # : ------------------------------------------ : Advanced Usage : ------------------------------------------ # This script reports anonymous success / failure analytics. # You can disable this reporting by setting the "analytics" variable to false. : curl -sL firebase.tools | analytics=false bash # By default we report all data anonymously and do not collect any information # except platform type (Darwin, Win, etc) in the case of an unsupported platform # error. : ------------------------------------------ : Source Code : ------------------------------------------ # This script contains a large amount of comments so you can understand # how it interacts with your system. If you're not interested in the # technical details, you can just run the command above. # We begin by generating a unique ID for tracking the anonymous session. CID=$(cat /dev/urandom | LC_CTYPE=c tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1) # Credit: https://gist.github.com/earthgecko/3089509 # We can use this CID in all calls to the Google Analytics endpoint via # this reusable function. send_analytics_event() { # We only make the API call in the case of the "analytics" variable # not being set to "false". If it is set to false, this function # performs no operation. if [ ! "$analytics" = "false" ]; then curl -s https://www.google-analytics.com/collect \ -d "tid=UA-154737150-1" \ -d "t=event" \ -d "ec=firebase.tools" \ -d "ea=$1" \ -d "v=1" \ -d "cid=$CID" \ -o /dev/null fi } # We send one event to count the number of times this script is ran. At the # end we also report success / failure, but it's possible that the script # will crash before we get to that point, so we manually count invocations here. send_analytics_event start # We need to ensure that we don't mess up an existing "firebase" # install, so before doing anything we check to see if this system # has "firebase" installed and if so, we exit out. echo "-- Checking for existing firebase-tools on PATH..." HAS_FIREBASE_TOOLS=$(which firebase) if [ ! -z "$HAS_FIREBASE_TOOLS" ] then echo "Your machine already has firebase-tools@$(firebase --version) installed. Nothing to do." echo "-- All done!" send_analytics_event already_installed exit 0 fi echo "-- Checking your machine type..." # Now we need to detect the platform we're running on (Linux / Mac / Other) # so we can fetch the correct binary and place it in the correct location # on the machine. # We use "tr" to translate the uppercase "uname" output into lowercase UNAME=$(uname -s | tr '[:upper:]' '[:lower:]') # Then we map the output to the names used on the Github releases page case "$UNAME" in linux*) MACHINE=linux;; darwin*) MACHINE=macos;; esac # If we never define the $MACHINE variable (because our platform is neither Mac # or Linux), then we can't finish our job, so just log out a helpful message # and close. if [ -z "$MACHINE" ] then echo "Your operating system is not supported, if you think it should be please file a bug." echo "https://github.com/firebase/firebase-tools/" echo "-- All done!" send_analytics_event "missing_platform_$UNAME" exit 0 fi # We have enough information to generate the binary's download URL. echo "-- Links..." DOWNLOAD_URL="https://firebase.tools/bin/$MACHINE/latest" echo "[Binary URL] $DOWNLOAD_URL" # We use "curl" to download the binary with a flag set to follow redirects # (Github download URLs redirect to CDNs) and a flag to show a progress bar. echo "-- Downloading binary..." # For info about why we place the binary at this location, see # https://unix.stackexchange.com/a/8658 INSTALL_DIR="/usr/local/bin" sudo curl -o "$INSTALL_DIR/firebase" -L --progress-bar $DOWNLOAD_URL # Once the download is complete, we mark the binary file as readable # and executable (+rx). echo "-- Setting permissions on binary..." sudo chmod +rx "$INSTALL_DIR/firebase" # If all went well, the "firebase" binary should be located on our PATH so # we'll run it once, asking it to print out the version. This is helpful as # standalone firebase binaries do a small amount of setup on the initial run # so this not only allows us to make sure we got the right version, but it # also does the setup so the first time the developer runs the binary, it'll # be faster. VERSION=$(firebase --version) # If no version is detected then clearly the binary failed to install for # some reason, so we'll log out an error message and report the failure # to headquarters via an analytics event. if [ -z "$VERSION" ] then echo "Something went wrong, firebase has not been installed." echo "Please file a bug with your system information on Github." echo "https://github.com/firebase/firebase-tools/" echo "-- All done!" send_analytics_event failure exit 1 fi # Since we've gotten this far we know everything succeeded. We'll just # let the developer know everything is ready and take our leave. echo "-- firebase-tools@$VERSION is now installed" echo "-- All Done!" send_analytics_event success exit 0 # ------------------------------------------ # Notes # ------------------------------------------ # # This script contains hidden JavaScript which is used to improve # readability in the browser (via syntax highlighting, etc), right-click # and "View source" of this page to see the entire bash script! # # You'll also notice that we use the ":" character in the Introduction # which allows our copy/paste commands to be syntax highlighted, but not # ran. In bash : is equal to `true` and true can take infinite arguments # while still returning true. This turns these commands into no-ops so # when ran as a script, they're totally ignored. #