apt.ts

import * as utils from "../utils";

const aptCommandLine: string[] = [
	"DEBIAN_FRONTEND=noninteractive",
	"RTI_NC_LICENSE_ACCEPTED=yes",
	"apt-get",
	"install",
	"--no-install-recommends",
	"--quiet",
	"--yes",
];

const aptDependencies: string[] = [
	"libssl-dev", // required for pip3 cryptography module
	"python3-dev", // required for pip3 cryptography module
	"build-essential",
	"clang",
	"cmake",
	"git",
	"lcov",
	"python3-catkin-pkg-modules",
	"python3-pip",
	"python3-rosinstall-generator",
	"python3-vcstool",
	"wget",
	// FastRTPS dependencies
	"libasio-dev",
	"libtinyxml2-dev",
];

const distributionSpecificAptDependencies = {
	bionic: [
		// OpenSplice
		"libopensplice69",

		// python3-rosdep is conflicting with ros-melodic-desktop-full,
		// and should not be used here. See ros-tooling/setup-ros#74
		"python-rosdep",
		// python required for sourcing setup.sh
		"python",
		"libc++-dev",
		"libc++abi-dev",
	],
	focal: [
		// python-rosdep does not exist on Focal, so python3-rosdep is used.
		// The issue with ros-melodic-desktop-full is also non-applicable.
		"python3-rosdep",
		// python required for sourcing setup.sh
		"python",
		"libc++-dev",
		"libc++abi-dev",
	],
	jammy: [
		// python-rosdep does not exist on Jammy, so python3-rosdep is used.
		// The issue with ros-melodic-desktop-full is also non-applicable.
		"python3-rosdep",
		// libc++-dev and libc++abi-dev installs intentionally removed because https://github.com/ros-tooling/setup-ros/issues/506
	],
};

const aptRtiConnextDds = {
	bionic: "rti-connext-dds-5.3.1",
	focal: "rti-connext-dds-5.3.1",
	jammy: "rti-connext-dds-6.0.1",
};

/**
 * Run apt-get install on list of specified packages.
 *
 * This invokation guarantees that APT install will be non-blocking.
 *
 * In particular, it automatically accepts the RTI Connext license, which would block forever otherwise.
 * Skipping the license agreement page requires RTI_NC_LICENSE_ACCEPTED to be set to "yes".
 * This package would normally be installed automatically by rosdep, but
 * there is no way to pass RTI_NC_LICENSE_ACCEPTED through rosdep.
 *
 * @param   packages        list of Debian pacakges to be installed
 * @returns Promise<number> exit code
 */
export async function runAptGetInstall(packages: string[]): Promise<number> {
	return utils.exec("sudo", aptCommandLine.concat(packages));
}

/**
 * Run ROS 2 APT dependencies.
 *
 * @returns Promise<number> exit code
 */
export async function installAptDependencies(
	installConnext = false
): Promise<number> {
	const distribCodename = await utils.determineDistribCodename();
	let aptPackages: string[] = installConnext
		? aptDependencies.concat(aptRtiConnextDds[distribCodename] || [])
		: aptDependencies;
	const additionalAptPackages =
		distributionSpecificAptDependencies[distribCodename] || [];
	aptPackages = aptPackages.concat(additionalAptPackages);
	return runAptGetInstall(aptPackages);
}