cat <<EOF

local sample_name="$1"

local quickstart_dir

# If QUICKSTART_REPO is set, use it. Otherwise, clone the repo.

if [[ -n "${QUICKSTART_REPO:-}" ]]; then

# If the user provided a path, it must be a valid directory.

if [[ ! -d "${QUICKSTART_REPO}" ]]; then

echo "Error: QUICKSTART_REPO is set to '${QUICKSTART_REPO}'," \

"but this is not a valid directory." >&2

exit 1

fi

echo "Using local quickstart repository at ${QUICKSTART_REPO}" >&2

quickstart_dir="${QUICKSTART_REPO}"

if ! (cd "${quickstart_dir}" && \

git rev-parse --is-inside-work-tree >/dev/null 2>&1); then

echo "Error: QUICKSTART_REPO ('${quickstart_dir}') is not a git" \

"repository." >&2

exit 1

fi

else

# QUICKSTART_REPO is not set, so clone it.

quickstart_dir="quickstart-ios"

if [[ -d "${quickstart_dir}" ]]; then

echo "Quickstart repository already exists at ${quickstart_dir}" >&2

else

echo "Cloning quickstart repository into '${quickstart_dir}' directory..." >&2

# Do a partial, sparse clone to speed up CI. See

# https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/

git clone --filter=blob:none --sparse \

https://github.com/firebase/quickstart-ios.git "${quickstart_dir}"

fi

(

cd "${quickstart_dir}"

echo "Ensuring sparse checkout is set for ${sample_name}..." >&2

# Checkout the sample and scripts directories.

git sparse-checkout set "${sample_name}" scripts shared

)

fi

# If a branch is specified, check it out.

if [[ -n "${QUICKSTART_BRANCH:-}" ]]; then

echo "Checking out quickstart branch: ${QUICKSTART_BRANCH}" >&2

(

cd "${quickstart_dir}"

git fetch --quiet

git checkout --quiet "${QUICKSTART_BRANCH}"

)

fi

# Return the absolute path to the quickstart directory.

(cd "$quickstart_dir" && pwd)

local release_testing_mode="$1"

local absolute_project_file="$2"

case "$release_testing_mode" in

"${NIGHTLY_RELEASE_TESTING}")

# For release testing, find the latest CocoaPods tag.

local latest_tag

latest_tag=$(git -C "$root_dir" tag -l "CocoaPods-*" --sort=-v:refname |

if [[ -z "$latest_tag" ]]; then

echo "Error: Could not find the latest CocoaPods tag." >&2

echo "This is often caused by a shallow git clone in a CI environment." >&2

echo "If you are running in GitHub Actions, please ensure your checkout" >&2

echo "step includes 'fetch-depth: 0' to fetch the full git history." >&2

exit 1

fi

local tag_revision

tag_revision=$(git -C "$root_dir" rev-list -n 1 "$latest_tag")

echo "Setting SPM dependency to revision for tag ${latest_tag}:" \

"${tag_revision}"

"$scripts_dir/update_firebase_spm_dependency.sh" \

"$absolute_project_file" --revision "$tag_revision"

;;

"${PRERELEASE_TESTING}")

# For prerelease testing, point to the tip of the main branch.

echo "Setting SPM dependency to the tip of the main branch."

"$scripts_dir/update_firebase_spm_dependency.sh" \

"$absolute_project_file" --prerelease

;;

*)

# For PR testing, point to the current commit.

local current_revision

# Detect if we are in a PR or a regular push

if [ "${GITHUB_EVENT_NAME:-}" == "pull_request" ]; then

if ! command -v jq &> /dev/null; then

echo "Error: jq is required for PR testing." >&2

exit 1

fi

# In a PR, read the real commit SHA from the event payload

# This guarantees a hash that exists on the remote server

current_revision=$(jq -er .pull_request.head.sha "${GITHUB_EVENT_PATH}")

else

# In a Push (or local run), HEAD is safe to use

current_revision=$(git -C "$root_dir" rev-parse HEAD)

fi

echo "Setting SPM dependency to current revision: ${current_revision}"

"$scripts_dir/update_firebase_spm_dependency.sh" \

"$absolute_project_file" --revision "$current_revision"

;;

esac

# --- Argument Parsing ---

if [[ -z "${1:-}" ]]; then

print_usage

exit 1

fi

local sample="$1"

local release_testing="${2-}"

# Validate release_testing argument.

case "$release_testing" in

"" | "${NIGHTLY_RELEASE_TESTING}" | "${PRERELEASE_TESTING}")

# This is a valid value (or empty), so do nothing.

;;

*)

# This is an invalid value.

echo "Error: Invalid testing_mode: '${release_testing}'" >&2

print_usage

exit 1

;;

esac

# --- Environment Setup and Validation ---

# Enable trace mode if DEBUG is set to 'true'

if [[ "${DEBUG:-false}" == "true" ]]; then

set -x

fi

# Source function to check if CI secrets are available.

source "$scripts_dir/check_secrets.sh"

# Some quickstarts may not need a real GoogleService-Info.plist for their

# tests. When QUICKSTART_REPO is set (for local runs) or BYPASS_SECRET_CHECK

# is true, the secrets check is skipped.

if [[ -z "${QUICKSTART_REPO:-}" ]] && \

[[ "${BYPASS_SECRET_CHECK:-}" != "true" ]] && \

! check_secrets && \

[[ "${sample}" != "installations" ]]; then

echo "Skipping quickstart setup: CI secrets are not available."

exit 0

fi

# --- Main Logic ---

local quickstart_dir

quickstart_dir=$(setup_quickstart_repo "$sample")

local quickstart_project_dir="${quickstart_dir}/${sample}"

if [[ ! -d "${quickstart_project_dir}" ]]; then

echo "Error: Sample directory not found at '${quickstart_project_dir}'" >&2

exit 1

fi

# Find the .xcodeproj file within the sample directory.

# Fail if there isn't exactly one.

# Enable nullglob to ensure the glob expands to an empty list if no files

# are found.

shopt -s nullglob

local project_files=("${quickstart_project_dir}"/*.xcodeproj)

# Restore default globbing behavior.

shopt -u nullglob

if [[ "${#project_files[@]}" -ne 1 ]]; then

echo "Error: Expected 1 .xcodeproj file in" \

"'${quickstart_project_dir}', but found ${#project_files[@]}." >&2

exit 1

fi

local project_file="${project_files[0]}"

update_spm_dependency "$release_testing" "$project_file"