#!/usr/bin/env bash
# TODO: use the build system to generate docs once we can
# e.x. convertFqName "android.hardware.foo@1.0::foo::IFoo" "\5" -> IFoo
function convertFqName() {
# android.hardware.foo@1.0::foo::IFoo
# \1 => android.hardware.foo
# \3 => 1
# \4 => 0
# \5 => IFoo # optional capture group
local FQNAME="^(([a-zA-Z0-9]+\.)*[a-zA-Z0-9]+)@([0-9]+).([0-9]+)(::([a-zA-Z0-9]+))?$"
local fqName="$1"
local pattern="$2"
echo $1 | sed -E "s/$FQNAME/$2/g"
}
function assertInterfaceFqName() {
if [ -n "$(convertFqName "$1")" ]; then
echo "$1 is not an interface fqname"
return 1
fi
}
function javaTarget() { convertFqName "$1" "\1-V\3.\4-java"; }
function cppTarget() { convertFqName "$1" "\1@\3.\4"; }
function hidl-gen-output() {
local out="$1"
while read -r fqName; do
echo "Generating output for $fqName."
hidl-gen -Lc++-headers -o "$out/cpp" "$fqName" || exit 1
hidl-gen -Ljava -o "$out/java" "$fqName" 2>/dev/null
done
}
function current-interfaces() {
[ $# = 1 ] || { echo "usage: current-interfaces <package root directory>" && return 1; }
local package_root="$1"
[ -d "$package_root" ] || { echo "current-interfaces: directory $package_root does not exist" && return 1; }
local current_file="$package_root/current.txt"
[ -f "$current_file" ] || { echo "current-interfaces: current file $current_file does not exist" && return 1; }
cat "$current_file" | cut -d '#' -f1 | awk '{print $2}' | sed "/^ *$/d" | sort | uniq
}
function google-interfaces() {
local roots=(
hardware/interfaces
system/hardware/interfaces
frameworks/hardware/interfaces
system/libhidl/transport
)
for root in "${roots[@]}"; do
current-interfaces "$ANDROID_BUILD_TOP/$root"
done | sort | uniq
}
function google-interface-packages() {
google-interfaces | cut -d ':' -f1 | sort | uniq
}
function hidl-doc-generate-sources() {
local outputDir="$1"
[ -z "$1" ] && outputDir="gen"
echo "Generating sources in $(realpath $outputDir)"
google-interface-packages | hidl-gen-output "$outputDir"
echo "Deleting implementation-related files from $outputDir."
rm $(find "$outputDir/cpp" -\( -name "IHw*.h" \
-o -name "BnHw*.h" \
-o -name "BpHw*.h" \
-o -name "Bs*.h" \
-o -name "hwtypes.h" \))
echo "Done: generated sources are in $outputDir"
}