development/referenceDocs/stageReferenceDocs.sh

#!/bin/bash
set -e

cd "$(dirname $0)"

# Save current working directory
scriptDirectory=$(pwd)

if [[ -z "$1" ]]; then
      printf "Please supply a buildID from the android build server\n"
      exit
fi

buildId=$1

newDir="reference-docs"
# Remove the existing out directory to avoid conflicts from previous runs
rm -rf out
mkdir -p out/$newDir
cd out/$newDir

androidxPublicKotlinDocsZip="dokka-public-docs-${buildId}.zip"
androidxPublicJavaDocsZip="doclava-public-docs-${buildId}.zip"


printf "============================ STEP 1 =============================== \n"
printf "== Downloading the doc zip files from the build server... \n"
printf "== If this script hangs, try running glogin or gcert.\n"
printf "=================================================================== \n"

/google/data/ro/projects/android/fetch_artifact --bid $buildId --target androidx $androidxPublicKotlinDocsZip
/google/data/ro/projects/android/fetch_artifact --bid $buildId --target androidx $androidxPublicJavaDocsZip

printf "============================ STEP 2 =============================== \n"
printf "== Unzip the doc zip files \n"
printf "=================================================================== \n"

unzip $androidxPublicKotlinDocsZip
unzip $androidxPublicJavaDocsZip

printf "============================ STEP 3 =============================== \n"
printf "== Format the doc zip files \n"
printf "=================================================================== \n"

# Remove directories we never publish
rm en -rf
rm reference/java -rf
rm reference/org -rf
rm reference/hierarchy.html
rm reference/kotlin/org -rf

# Move package list into the correct location
mv reference/kotlin/package-list reference/kotlin/androidx/package-list 

# Remove javascript files that have no use
rm -f reference/androidx/lists.js
rm -f reference/androidx/navtree_data.js

# Remove extraneous _book.yaml that improperly overwrites the correct one
rm -f reference/androidx/_book.yaml

# Remove the version_added labels to the _toc.yaml that don't do anything
sed -i "s/  version_added/# version_added/" reference/androidx/_toc.yaml
sed -i "s/    # version_added/#     version_added/" reference/androidx/_toc.yaml


printf "============================ STEP 4 =============================== \n"
printf "== Generate the language switcher \n"
printf "=================================================================== \n"

cd reference
python3 ./../../../switcher.py --work androidx
python3 ./../../../switcher.py --work support

printf "============================ STEP 5 =============================== \n"
printf "== Run the following command to copy the docs into Google3 \n"
printf "=================================================================== \n"

printf "
\`\`\`
g4d -f androidx-ref-docs-stage && \
cd third_party/devsite/android/en/reference && \
g4 sync && \
cp -r $(pwd)/* . && \
/google/data/ro/projects/devsite/two/live/devsite2.par stage androidx && \
/google/data/ro/projects/devsite/two/live/devsite2.par stage kotlin/androidx
\`\`\`\n"

exit