CoDesigner for PTC Creoのコマンドラインインストール
概略
- 従来のコマンドと、UIを表示しないサイレント登録の使い分けを理解します。
- Creoのバージョンと、「config.pro」を含む正しいtextフォルダーを指定する方法を学びます。
- サイレントモードの終了コードを理解し、引数の指定漏れ、スイッチの競合、パスの誤りを回避します。
コマンドラインでのインストール手順
バージョン3.16以降、PTC Creo用のAltium MCAD CoDesignerインストーラーは、以下をサポートしています。
-
CoDesignerのサイレントインストール/1行のコマンドによるインストール。
-
UIを操作せずにCreoのバージョンとカスタムインストールパスを指定。
概要
Altium.Designer.PtcCreo.InstallUI.exeでは、次の3種類のコマンドライン操作をサポートしています。
-
従来の強制インストール
-
従来の強制アンインストール
-
サイレントモードでの手動ターゲット登録
このドキュメントでは、各モードの引数、必要な入力、および実際の使用方法を説明します。
実行ファイルの場所
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
コマンドモード
従来の強制インストール
Long form:
Altium.Designer.PtcCreo.InstallUI.exe -i "<plugin-install-root>"
Purpose:
-
内部処理/パッケージ化されたインストーラーのブートストラップ処理
-
指定したCoDesignerインストールルートにプラグインファイルをコピーします
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:
-
これは従来の強制実行処理です
-
-creo-versionまたは-creo-path -
を受け付けません。サイレントモードの引数と組み合わせないでください
従来の強制アンインストール
Short form:
Altium.Designer.PtcCreo.InstallUI.exe -u
Alternative uninstall switch used in some places:
Altium.Designer.PtcCreo.InstallUI.exe -uninstall
Purpose:
-
内部処理/パッケージ化されたアンインストール処理
-
現在のアンインストールロジックに従って、プラグインの登録とインストール内容を削除します
Example:
& "C:\Program Files (x86)\Altium CoDesigner PTC Creo Plugin\register\Altium.Designer.PtcCreo.InstallUI.exe"`
-u
Notes:
-
これは従来の強制実行処理です
-
サイレントモードの引数と組み合わせないでください
サイレントモードでの手動ターゲット登録
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:
-
インストーラーUIの「追加」に代わるヘッドレス操作
-
明示的に指定したCreoターゲットパスを1つ追加し、UIを開かずに通常のインストール/更新ロジックを実行します
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%
引数リファレンス
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
パス指定に関する重要な要件
サイレントモードでは、-creo-path / -cpは、config.proを含むCreoのtextディレクトリを指している必要があります。
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
現在のバックエンドでは、config.proを直接含むフォルダーを指定する必要があります。
サイレントモードの動作
サイレントモードは、UIでの手動のAdd操作を置き換えることを目的としています。
Behavior:
-
UIは表示されません
-
明示的に指定したCreoターゲットを1つ、プログラムで追加します
-
UI経由の場合と同じインストール/更新ロジックが実行されます
-
その呼び出しでは、指定したCreoターゲットのみが選択されます
Quiet mode should not be combined with:
-
-i -
-u -
-uninstall
終了コード
Current quiet-mode exit code contract:
0 = success
1 = invalid arguments
2 = invalid Creo target input
3 = registration failure
4 = unexpected internal error
無効な使用例
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"
実用上の注意事項
-
サイレントモードでは、コマンドごとにCreoターゲットを1つ明示的に指定します。
-
同じバージョンのCreoターゲットが複数あっても、
textのパスが異なれば有効です。 -
手動/サイレントモードで追加したターゲットは、アクティブなCoDesignerインストールルート配下の
installations.datに永続的に保存されます。 -
従来の強制実行モードと通常のUI/サイレント処理では、レジストリルートに関して従来との互換性を維持する動作があるため、トラブルシューティング時には、実際の実行ファイルのパスとアクティブなインストールルートを慎重に確認してください。