CoDesigner für PTC Creo – Installation über die Befehlszeile

Anleitung zur Installation über die Befehlszeile

Ab Version 3.16 unterstützt das Installationsprogramm von Altium MCAD CoDesigner für PTC Creo:

• Die unbeaufsichtigte Installation von CoDesigner über eine einzelne Befehlszeile.

• Die Angabe der Creo-Version und eines benutzerdefinierten Creo-Installationspfads ohne Interaktion mit der Benutzeroberfläche.

Übersicht

Altium.Designer.PtcCreo.InstallUI.exe unterstützt drei Arten der Befehlszeilennutzung:

• Erzwungene Installation im Legacy-Modus

• Erzwungene Deinstallation im Legacy-Modus

• Registrierung eines manuell angegebenen Ziels im unbeaufsichtigten Modus

Dieses Dokument beschreibt die Argumente, die erwarteten Eingaben und die praktische Verwendung der einzelnen Modi.

Speicherort der ausführbaren Datei

Typical installed location:

C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe

Depending on environment and deployment history, the product may also exist under:

C:\Program Files\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe

Befehlsmodi

Erzwungene Installation im Legacy-Modus

Long form:

Altium.Designer.PtcCreo.InstallUI.exe -i "<plugin-install-root>"

Purpose:

• Interner bzw. paketierter Bootstrap-Ablauf des Installationsprogramms

• Kopiert Plugin-Dateien in das angegebene CoDesigner-Installationsstammverzeichnis

Example:

& "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe" `
 -i "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin"

Notes:

• Dies ist ein erzwungener Ablauf im Legacy-Modus

• Akzeptiert weder -creo-version noch -creo-path

• Sollte nicht mit Argumenten für den unbeaufsichtigten Modus kombiniert werden

Erzwungene Deinstallation im Legacy-Modus

Short form:

Altium.Designer.PtcCreo.InstallUI.exe -u

Alternative uninstall switch used in some places:

Altium.Designer.PtcCreo.InstallUI.exe -uninstall

Purpose:

• Interner bzw. paketierter Deinstallationsablauf

• Entfernt die Plugin-Registrierung und die Installationsinhalte gemäß der aktuellen Deinstallationslogik

Example:

& "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe"`
 -u

Notes:

• Dies ist ein erzwungener Ablauf im Legacy-Modus

• Sollte nicht mit Argumenten für den unbeaufsichtigten Modus kombiniert werden

Registrierung eines manuell angegebenen Ziels im unbeaufsichtigten Modus

Long form:

Altium.Designer.PtcCreo.InstallUI.exe -quiet -creo-version <version> -creo-path "<path>"

Short form:

Altium.Designer.PtcCreo.InstallUI.exe -q -cv <version> -cp "<path>"

Purpose:

• Ersatz ohne Benutzeroberfläche für die Verwendung von „Hinzufügen“ in der Benutzeroberfläche des Installationsprogramms

• Fügt einen expliziten Creo-Zielpfad hinzu und führt die normale Installations-/Aktualisierungslogik aus, ohne die Benutzeroberfläche zu öffnen

Examples:

& "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe" `
 -quiet `
 -creo-version "11.0" `
 -creo-path "C:\PTC\Creo 11.0.1.0\Common Files\text"

& "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe" `
 -q `
 -cv "11.0" `
 -cp "C:\PTC\Creo 11.0.1.0\Common Files\text"

"C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer. PtcCreo.InstallUI.exe" -quiet -creo-version "11.0" -creo-path "C:\PTC\Creo 11.0.1.0\ Common Files\text" echo %ERRORLEVEL%

Argumentreferenz

-i

-u

-uninstall​​

-quiet

-q

-creo-version

-cv

-creo-path

-cp

Wichtige Vorgabe für den Pfad

Im unbeaufsichtigten Modus muss -creo-path / -cp auf das Creo-Verzeichnis text verweisen, das config.pro enthält.

Correct style:

C:\PTC\Creo 11.0.1.0\Common Files\text

Not the higher-level install root:

C:\PTC\Creo 11.0.1.0

Das aktuelle Backend erwartet den Ordner, der config.pro direkt enthält.

Verhalten im unbeaufsichtigten Modus

Der unbeaufsichtigte Modus soll das manuelle Add in der Benutzeroberfläche ersetzen.

Behavior:

• Es wird keine Benutzeroberfläche angezeigt

• Ein explizites Creo-Ziel wird programmgesteuert hinzugefügt

• Es wird dieselbe Installations-/Aktualisierungslogik wie bei der Verwendung der Benutzeroberfläche ausgeführt

• Für diesen Aufruf wird nur das angegebene Creo-Ziel ausgewählt

Quiet mode should not be combined with:

• -i

• -u

• -uninstall

Exitcodes

Current quiet-mode exit code contract:

0 = success
1 = invalid arguments
2 = invalid Creo target input
3 = registration failure
4 = unexpected internal error

Beispiele für ungültige Verwendung

Missing quiet switch:

Altium.Designer.PtcCreo.InstallUI.exe -creo-version "11.0" -creo-path "C:\PTC\Creo 11.0.1.0\Common Files\text"

Missing version:

Altium.Designer.PtcCreo.InstallUI.exe -quiet -creo-path "C:\PTC\Creo 11.0.1.0\CommonFiles\text"

Missing path:

Altium.Designer.PtcCreo.InstallUI.exe -quiet -creo-version "11.0"

Conflicting modes:

Altium.Designer.PtcCreo.InstallUI.exe -i "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin" -quiet -creo-version "11.0" -creo-path "C:\PTC\Creo 11.0.1.0\Common Files\ text"

Wrong path level:

Altium.Designer.PtcCreo.InstallUI.exe -quiet -creo-version "11.0" -creo-path "C:\PTC\Creo 11.0.1.0"

Praktische Hinweise

• Der unbeaufsichtigte Modus ist für ein explizites Creo-Ziel pro Befehl vorgesehen.

• Mehrere Creo-Ziele mit derselben Version sind zulässig, sofern sie unterschiedliche text-Pfade verwenden.

• Manuell bzw. im unbeaufsichtigten Modus angegebene Ziele werden dauerhaft in installations.dat unter dem aktiven CoDesigner-Installationsstammverzeichnis gespeichert.

• Die erzwungenen Legacy-Modi und die normalen Abläufe über die Benutzeroberfläche bzw. im unbeaufsichtigten Modus weisen historisch bedingte Kompatibilitätsmechanismen hinsichtlich der Registry-Stammschlüssel auf. Daher sollten bei der Fehlerbehebung der tatsächliche Pfad der ausführbaren Datei und das aktive Installationsstammverzeichnis sorgfältig überprüft werden.