Per la creazione di un file addin dal file dll si necessita del programma "Siemens.Engineering.AddIn.Publisher.exe", disponibile nella directory di installazione di TIA Portal, nella cartella "PublicAPI". È inoltre necessario un file di configurazione valido in formato XML. Per la conversione di file dll in un file addin, sono disponibili le seguente opzioni:
-
Il programma "Siemens.Engineering.AddIn.Publisher.exe" può essere eseguito con il prompt (CMD) di Windows con i rispettivi parametri.
-
Il programma "Siemens.Engineering.AddIn.Publisher.exe" può essere inserito in Visual Studio come post-build event ed eseguito ogni volta che si genera un file dll.
La seguente tabella mostra i parametri che possono essere utilizzati per l'esecuzione del programma:
|
Parametro |
Descrizione |
Esempi |
|---|---|---|
|
--configuration oppure -f <configuration> |
Percorso del file di configurazione di Publisher |
-f D:\Configuration.xml |
|
--certificatepassword oppure -p <certificatepassword> |
Password per il certificato E' richiesta se nell' elemento "SigningCertificate", nel file di configurazione, è stato indicato un certificato. |
--certificatepassword MyPassword -p MyPassword |
|
--logfile oppure -l <logfile> |
Percorso di un file Log Questo file Log indica ad es. il motivo per cui conversione in un file addin non è riuscita. |
--logfile D:\Logfile.txt -l D:\Logfile.txt |
|
--outfile oppure -o <out> |
Indicazione di percorso e nome del file addin dal quale creare il file dll. In assenza di indicazioni, il file addin viene salvato con lo stesso nome e nella stessa cartella del file dll. |
--outfile D:\MyAddin.addin -o D:\MyAddin.addin |
|
--verbose oppure -v |
Selezionando quest'opzione, nel file Log vengono scritti dettagli aggiuntivi. |
-verbose -v |
|
--console oppure -c |
Selezionando quest'opzione, i dettagli registrati su protocollo vengono visualizzati nella consolle. |
--console -c |
|
--pause oppure -x |
Lascia aperto il prompt dopo l'esecuzione dell'apparecchio di Publisher. |
--pause -x |
|
--help oppure -h |
Visualizza i parametri e la relativa descrizione direttamente nel prompt. |
--help -h |
|
--skipEngMemberCheck o -s |
Se questa opzione è disponibile, il controllo dell'esistenza delle variabili membro dell'engineering viene saltato durante la pubblicazione Add-In. Questo consente agli autori Add-In di pubblicare i propri Add-Ins anche quando le variabili membro di engineering sono definite sui livelli della classe o della struttura. |
--skipEngMemberCheck -s |
Presupposti
Disponibilità di un file di configurazione valido in formato XML.
Generazione del file addin tramite il prompt (CMD)
Per la generazione del file addin tramite il prompt (CMD) di Windows, procedere come indicato nel seguito:
-
Apre il prompt di Windows (CMD).
-
Navigare alla directory di installazione di TIA Portal e aprire la cartella "PublicAPI".
-
Inserire il richiamo del programma con i parametri desiderati, quindi confermare premendo Invio. Un richiamo semplice può presentarsi ad es. nel modo seguente:
Siemens.Engineering.AddIn.Publisher.exe --configuration "D:\Configuration.xml" --logfile "D:\Logfile.txt" --verbose
Generazione del file addin con un post-build event
Per generare un fileaddin con un post-build event procedere nel seguente modo:
-
Aprire il progetto C# in Visual Studio.
-
Nell'Explorer, nella cartella del progetto, fare clic sul progetto con il tasto destro del mouse.
-
Selezionare il comando "Proprietà" nel menu di scelta rapida.
Si apre la finestra con le proprietà dell'oggetto.
-
Fare clic su "Build event".
-
Fare clic su "Modifica post-build".
Si apre la riga di comando per il post-build event.
-
Inserire qui il richiamo del programma per il Publisher assieme ai parametri desiderati. Accertarsi di indicare il percorso completo di Publisher. Esempio:
"D:\Publisher\Siemens.Engineering.AddIn.Publisher.exe" --configuration Configuration.xml --logfile Log.txt --verbose -
Confermare i dati immessi con "OK".
La riga di comando per il post-build event viene chiusa.
-
Nei casi in cui debba essere eseguito post-build event, nella casella di riepilogo selezionare "Esegui post-build event".
Quando si crea un file dll ora viene avviato anche il processo Publishing e generato il file addin.