Paul Nothaft
1f87f6d1c7
An der fertigen .ipa gemessen: die Erweiterung trug
com.apple.security.application-groups, die App nicht. Der Beleg waere also
abgelegt, aber nie gefunden worden - Teilen meldet Erfolg, die Tanken-Seite
bleibt leer. Genau die Sorte stiller Ausfall, gegen die dieses Projekt sonst
ueberall anbaut.
Ursache: die pbxproj fuehrt Werte mal mit, mal ohne Anfuehrungszeichen. Was
addTarget schreibt, ist gequotet ("app.datametric360.teilen"); was Capacitor
fuer die App erzeugt, steht nackt da (app.datametric360). Der Vergleich auf
die gequotete Form lief damit fuer die App immer ins Leere, und
CODE_SIGN_ENTITLEMENTS wurde dort nie gesetzt.
Jetzt wird entquotet verglichen. Belegt am neu erzeugten Projekt: vier
CODE_SIGN_ENTITLEMENTS statt zwei - Debug und Release beider Ziele.
212 lines
8.6 KiB
JavaScript
212 lines
8.6 KiB
JavaScript
#!/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"
|
|
|
|
/** pbxproj-Wert ohne die optionalen Anfuehrungszeichen. */
|
|
const entquotet = (wert) => String(wert ?? "").replace(/^"|"$/g, "")
|
|
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
|
|
// Ohne Anfuehrungszeichen vergleichen: die pbxproj fuehrt Werte mal mit,
|
|
// mal ohne. Was `addTarget` schreibt, ist gequotet ("app.datametric360.
|
|
// teilen"), was Capacitor fuer die App erzeugt, steht nackt da
|
|
// (app.datametric360). Der Vergleich auf die gequotete Form traf deshalb
|
|
// die App nie - sie wurde ohne App-Gruppe signiert, waehrend die
|
|
// Erweiterung sie hatte. Ergebnis waere ein stiller Ausfall gewesen:
|
|
// teilen meldet Erfolg, die App findet nichts (2026-09-02 an der
|
|
// fertigen .ipa gemessen - Entitlements der App ohne
|
|
// application-groups).
|
|
if (entquotet(s.PRODUCT_BUNDLE_IDENTIFIER) === BUNDLE_ID || entquotet(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 (entquotet(s.PRODUCT_BUNDLE_IDENTIFIER) === "app.datametric360") {
|
|
s.CODE_SIGN_ENTITLEMENTS = `"App/App.entitlements"`
|
|
}
|
|
}
|
|
|
|
// Eingebettet wird die Erweiterung bereits von `addTarget`: die Bibliothek
|
|
// legt fuer den Typ "app_extension" von sich aus eine Copy-Phase nach
|
|
// PlugIns am ersten Ziel an. Hier noch eine zweite anzulegen, hat genau das
|
|
// erzeugt, wogegen Xcode sich wehrt (2026-09-02, erster Lauf ueberhaupt auf
|
|
// einem Mac):
|
|
// error: Unexpected duplicate tasks
|
|
// note: Target 'App': ValidateEmbeddedBinary .../DataMetric360Share.appex
|
|
// note: Target 'App': ValidateEmbeddedBinary .../DataMetric360Share.appex
|
|
// Beide Phasen zeigten auf dieselbe Datei und dasselbe Ziel - die .appex
|
|
// waere zweimal an denselben Ort kopiert worden.
|
|
|
|
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("")
|