feat: install doxygen via official Dmg files

Author: aminya

dist/actions/setup-cpp.js

@@ -76,6 +76,7 @@
     "@actions/io": "^1.1.3",
     "@actions/tool-cache": "^2.0.1",
     "@babel/cli": "^7.23.4",
+    "@shockpkg/hdi-mac": "^3.1.1",
     "@swc/jest": "^0.2.31",
     "@types/cross-spawn": "^6.0.6",
     "@types/eslint": "^8.56.2",

dist/actions/setup-cpp.js.map

@@ -18,6 +18,7 @@ import { pathExists } from "path-exists"
 import retry from "retry-as-promised"
 import { ubuntuVersion } from "../utils/env/ubuntu_version"
 import { macosVersion } from "../utils/env/macos_version"
+import { setupDmg } from "../utils/setup/setupDmg"
 
 /** Get the platform data for cmake */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -43,6 +44,16 @@ function getDoxygenPackageInfo(version: string, platform: NodeJS.Platform, _arch
         url: `https://www.doxygen.nl/files/${folderName}.windows.x64.bin.zip`,
       }
     }
+    case "darwin": {
+      const folderName = `Doxygen-${version}`
+      return {
+        binRelativeDir: "bin/",
+        binFileName: addExeExt("doxygen"),
+        extractedFolderName: folderName,
+        extractFunction: setupDmg,
+        url: `https://doxygen.nl/files/${folderName}.dmg`,
+      }
+    }
     default:
       throw new Error(`Unsupported platform '${platform}'`)
   }
@@ -64,7 +75,12 @@ export async function setupDoxygen(version: string, setupDir: string, arch: stri
       return installationInfo
     }
     case "darwin": {
-      const installationInfo = await setupBrewPack("doxygen", undefined)
+      let installationInfo: InstallationInfo
+      try {
+        installationInfo = await setupBin("doxygen", version, getDoxygenPackageInfo, setupDir, arch)
+      } catch {
+        installationInfo = await setupBrewPack("doxygen", undefined)
+      }
       // only install graphviz if the macOS version is greater than 11
       if (macosVersion()[0] > 11) {
         await setupGraphviz(getVersion("graphviz", undefined), "", arch)
@@ -87,7 +103,11 @@ export async function setupDoxygen(version: string, setupDir: string, arch: stri
         try {
           // doxygen on stable Ubuntu repositories is very old. So, we use get the binary from the website itself
           installationInfo = await setupBin("doxygen", version, getDoxygenPackageInfo, setupDir, arch)
-          await setupAptPack([{ name: "libclang-cpp9" }])
+          try {
+            await setupAptPack([{ name: "libclang-cpp9" }])
+          } catch (err) {
+            info(`Failed to download libclang-cpp9 that might be needed for running doxygen. ${err}`)
+          }
         } catch (err) {
           notice(`Failed to download doxygen binary. ${err}. Falling back to apt-get.`)
           installationInfo = await setupAptPack([{ name: "doxygen" }])

dist/legacy/setup-cpp.js

@@ -26,7 +26,7 @@ export type PackageInfo = {
   binFileName: string
   /** The function to extract the downloaded archive. It can be `undefined`, if the binary itself is downloaded directly. */
   extractFunction?: {
-    (file: string, dest: string): Promise<string> | Promise<void>
+    (file: string, dest: string): Promise<unknown>
   }
 }