audi-app/companion-app/scripts/ios-teilen-einrichten.mjs

#!/usr/bin/env node
/**
 * Hängt die Share-Erweiterung ins erzeugte Xcode-Projekt.
 *
 * WARUM ES DIESES SKRIPT GIBT
 * ---------------------------
 * `companion-app/ios/` ist absichtlich gitignored — `npx cap add ios` baut den
 * Ordner aus dem Webbündel jederzeit neu. Damit verschwindet aber auch jedes
 * Ziel, das man in Xcode von Hand anlegt. Dieselbe Falle, die schon die
 * Team-Kennung und den Standort-Schlüssel in `ios-signieren.sh` getrieben hat:
 * was den nächsten `cap add` überleben soll, muss versioniert sein und bei
 * jedem Bau neu eingespielt werden.
 *
 * Die Quellen liegen deshalb unter `companion-app/native/`; dieses Skript
 * kopiert sie nach `ios/App/` und trägt das Erweiterungsziel in die
 * `project.pbxproj` ein.
 *
 * WAS ES ANLEGT
 * -------------
 * - Ziel `DataMetric360Share` (App-Erweiterung, Bundle-ID
 *   `app.datametric360.teilen`)
 * - dessen Quelldateien, Info.plist und Entitlements
 * - die App-Gruppe `group.app.datametric360` auf BEIDEN Zielen
 * - die Einbettung der Erweiterung in die App (Build-Phase
 *   „Embed App Extensions")
 * - das URL-Schema `datametric360://`, über das die Erweiterung die App holt
 *
 * IDEMPOTENT
 * ----------
 * Ein zweiter Lauf über ein bereits eingerichtetes Projekt ändert nichts und
 * meldet das. Wichtig, weil `ios-signieren.sh` bei jedem Bau durchläuft und
 * `ios/` nicht immer neu erzeugt wird.
 *
 * NICHT GETESTET AUF EINEM MAC
 * ----------------------------
 * Geschrieben ohne Zugriff auf macOS/Xcode. Die pbxproj-Bearbeitung folgt der
 * API des npm-Pakets `xcode`; scheitert sie, bricht das Skript mit einer
 * klaren Meldung ab und `docs/SHARE_EXTENSION.md` beschreibt die Handgriffe,
 * die dasselbe in Xcode erledigen. Lieber ein lauter Abbruch mit Anleitung
 * als ein halb eingerichtetes Projekt.
 */

import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync } from "node:fs"
import { dirname, join } from "node:path"
import { fileURLToPath } from "node:url"

import xcode from "xcode"

const HIER = dirname(fileURLToPath(import.meta.url))
const APP = dirname(HIER)

const ZIEL_NAME = "DataMetric360Share"
const BUNDLE_ID = "app.datametric360.teilen"
const GRUPPE = "group.app.datametric360"
const SCHEMA = "datametric360"

const iosApp = join(APP, "ios", "App")
const pbxPfad = join(iosApp, "App.xcodeproj", "project.pbxproj")
const quelleErw = join(APP, "native", "teilen")
const zielErw = join(iosApp, ZIEL_NAME)

function melden(text) {
  console.log("  " + text)
}

function abbruch(text) {
  console.error("")
  console.error("FEHLER: " + text)
  console.error("")
  console.error("Die Share-Erweiterung ist damit NICHT eingerichtet. Die App selbst")
  console.error("baut und läuft weiterhin - nur der Eintrag im Teilen-Blatt fehlt.")
  console.error("Von Hand nachziehen: companion-app/docs/SHARE_EXTENSION.md")
  process.exit(1)
}

if (!existsSync(pbxPfad)) {
  abbruch(`${pbxPfad} nicht gefunden - erst 'npx cap sync ios' laufen lassen.`)
}

/* ---------------------------------------------------------------- Dateien */

mkdirSync(zielErw, { recursive: true })
for (const datei of ["ShareViewController.swift", "Info.plist", `${ZIEL_NAME}.entitlements`]) {
  copyFileSync(join(quelleErw, datei), join(zielErw, datei))
}
copyFileSync(join(APP, "native", "App.entitlements"), join(iosApp, "App", "App.entitlements"))
melden(`Quellen nach ios/App/${ZIEL_NAME}/ kopiert`)

/* ------------------------------------------------------------- URL-Schema */

/* Ohne dieses Schema kann die Erweiterung die App nicht holen - sie legt den
   Beleg zwar ab, aber niemand merkt es, bis die App das nächste Mal von Hand
   geöffnet wird. */
const appPlistPfad = join(iosApp, "App", "Info.plist")
let appPlist = readFileSync(appPlistPfad, "utf8")
if (!appPlist.includes("CFBundleURLTypes")) {
  const eintrag = [
    "\t<key>CFBundleURLTypes</key>",
    "\t<array>",
    "\t\t<dict>",
    "\t\t\t<key>CFBundleURLName</key>",
    `\t\t\t<string>app.datametric360</string>`,
    "\t\t\t<key>CFBundleURLSchemes</key>",
    "\t\t\t<array>",
    `\t\t\t\t<string>${SCHEMA}</string>`,
    "\t\t\t</array>",
    "\t\t</dict>",
    "\t</array>",
    "</dict>",
  ].join("\n")
  const letztes = appPlist.lastIndexOf("</dict>")
  if (letztes < 0) abbruch("ios/App/App/Info.plist hat keine schließende <dict>-Marke.")
  appPlist = appPlist.slice(0, letztes) + eintrag + appPlist.slice(letztes + "</dict>".length)
  writeFileSync(appPlistPfad, appPlist, "utf8")
  melden(`URL-Schema ${SCHEMA}:// eingetragen`)
} else {
  melden("URL-Schema war bereits eingetragen")
}

/* ---------------------------------------------------------------- Projekt */

const projekt = xcode.project(pbxPfad)
projekt.parseSync()

const vorhanden = Object.values(projekt.pbxNativeTargetSection()).some(
  (z) => z && typeof z === "object" && z.name === ZIEL_NAME,
)
if (vorhanden) {
  melden(`Ziel ${ZIEL_NAME} war bereits im Projekt - nichts geändert`)
  process.exit(0)
}

let ziel
try {
  ziel = projekt.addTarget(ZIEL_NAME, "app_extension", ZIEL_NAME, BUNDLE_ID)

  // Eigene Build-Phasen: ohne sie hat das Ziel keine Quelldateien und keine
  // Ressourcen, und Xcode baut ein leeres Bündel.
  projekt.addBuildPhase([], "PBXSourcesBuildPhase", "Sources", ziel.uuid)
  projekt.addBuildPhase([], "PBXResourcesBuildPhase", "Resources", ziel.uuid)
  projekt.addBuildPhase([], "PBXFrameworksBuildPhase", "Frameworks", ziel.uuid)

  const gruppe = projekt.addPbxGroup(
    ["ShareViewController.swift", "Info.plist", `${ZIEL_NAME}.entitlements`],
    ZIEL_NAME,
    ZIEL_NAME,
  )
  // In die Projektwurzel einhängen, sonst taucht die Gruppe in Xcode nicht auf.
  const wurzel = Object.keys(projekt.hash.project.objects.PBXGroup).find(
    (k) => projekt.hash.project.objects.PBXGroup[k].name === "CustomTemplate",
  )
  if (wurzel) projekt.addToPbxGroup(gruppe.uuid, wurzel)

  projekt.addSourceFile("ShareViewController.swift", { target: ziel.uuid }, gruppe.uuid)

  // Einstellungen, die `addTarget` nicht selbst setzt.
  const konfigs = projekt.pbxXCBuildConfigurationSection()
  for (const schluessel of Object.keys(konfigs)) {
    const eintrag = konfigs[schluessel]
    if (!eintrag || typeof eintrag !== "object" || !eintrag.buildSettings) continue
    const s = eintrag.buildSettings
    if (s.PRODUCT_BUNDLE_IDENTIFIER === `"${BUNDLE_ID}"` || s.PRODUCT_NAME === `"${ZIEL_NAME}"`) {
      s.INFOPLIST_FILE = `"${ZIEL_NAME}/Info.plist"`
      s.CODE_SIGN_ENTITLEMENTS = `"${ZIEL_NAME}/${ZIEL_NAME}.entitlements"`
      s.IPHONEOS_DEPLOYMENT_TARGET = "14.0"
      s.SWIFT_VERSION = "5.0"
      s.TARGETED_DEVICE_FAMILY = `"1,2"`
      s.SKIP_INSTALL = "YES"
    }
    // Die App selbst braucht ihre neue Entitlements-Datei.
    if (s.PRODUCT_BUNDLE_IDENTIFIER === `"app.datametric360"`) {
      s.CODE_SIGN_ENTITLEMENTS = `"App/App.entitlements"`
    }
  }

  // Erweiterung in die App einbetten - ohne diese Phase liegt sie zwar im
  // Projekt, wandert aber nicht mit ins fertige .ipa.
  projekt.addBuildPhase(
    [`${ZIEL_NAME}.appex`],
    "PBXCopyFilesBuildPhase",
    "Embed App Extensions",
    projekt.getFirstTarget().uuid,
    "app_extension",
  )

  writeFileSync(pbxPfad, projekt.writeSync(), "utf8")
} catch (fehler) {
  abbruch(`Das Xcode-Projekt ließ sich nicht bearbeiten: ${fehler.message}`)
}

melden(`Ziel ${ZIEL_NAME} angelegt und eingebettet`)
melden(`App-Gruppe ${GRUPPE} auf beiden Zielen`)
console.log("")
console.log("  Einmalig im Apple-Entwicklerportal nötig, sonst schlägt das Signieren fehl:")
console.log(`    - App-Gruppe ${GRUPPE} anlegen`)
console.log(`    - App-ID ${BUNDLE_ID} anlegen und der Gruppe zuordnen`)
console.log(`    - App-ID app.datametric360 ebenfalls der Gruppe zuordnen`)
console.log("")