Datoteke specifikacija vanjskih alata

Datoteka specifikacije vanjskog alata opisuje alat koji se može pokrenuti iz izbornika Tools > External. Ona navodi naziv alata, izvršnu datoteku za pokretanje, opcionalne argumente i način obrade izlaza alata.

Naziv datoteke

<yourtoolname>.xml

Lokacija

Alati specifični za korisnika nalaze se u $HOME/.config/QtProject/qtcreator/externaltools na Macu i Linuxu te u %APPDATA%\QtProject\qtcreator\externaltools na Windowsu.

Sistemski alati nalaze se u <Qt Creator install>/share/qtcreator/externaltools na Windowsu i Linuxu, i u Qt Creator.app/Contents/Resources/externaltools na Macu.

Format datoteke

Specifikacije vanjskih alata su XML datoteke sa sljedećom strukturom.

Glavna oznaka

Korenetska oznaka je externaltool. Ima obavezni atribut id.

Oznaka	Značenje
externaltool	Koren elementa u XML datoteci koji specificira vanjski alat.

Atribut	Značenje
id	Niz koji identificira vanjski alat. Dva alata ne mogu imati isti id. Obavezno.

Oznake opisa

Morate navesti opis, prikazano ime i kategoriju alata. Možete prevesti njihove vrijednosti na različite jezike dodavanjem više oznaka description, displayname i category koje sadrže kodove jezika.

Oznaka	Značenje
opis	Kratak, jednolinijski opis namjene alata. Obavezno.
prikaznoime	Naziv koji se prikazuje u stavci izbornika alata. Obavezno.
kategorija	Naziv kategorije u kojoj se alat prikazuje. Ovo je naziv podizbornika izbornika `Tools > External` u kojem se alat postavlja. Na primjer, navedite vrijednost `"Text"` kako biste prikazali alat u izborniku `Tools > External > Text`. Obavezno.

Atribut	Značenje
xml:lang	Kod jezika (npr. `"en"` ili `"de"`) jezika koji se koristi za opis, prikazano ime ili kategoriju. Neobavezno.

Oznaka za specifikaciju izvršne datoteke

Morate dodati oznaku executable ispod korijenske oznake, koja specificira izvršnu datoteku za pokretanje, opcionalne argumente i način rukovanja izlazom.

Oznaka	Značenje
izvršna datoteka	Obuhvaća podoznake koje specificiraju što pokrenuti i koje parametre koristiti. Obavezno.

Atribut	Značenje
izlaz	Određuje kako postupati sa standardnim izlaznim tokom alata. Zadano je `ShowInPane`. Izborno.
errorSpecificira kako postupati sa standardnim tokom pogrešaka alata. Zadano je xml-ph-0000@deepl.internal	Određuje kako postupati sa standardnim tokom pogrešaka alata. Zadano je `ShowInPane`. Opcionalno.
modificira dokument	Određuje treba li Qt Creator očekivati promjene u trenutnom dokumentu. Ako je ova zastavica postavljena, Qt Creator potiče korisnike da spremaju promjene u trenutnom dokumentu prije pokretanja alata i tiho ponovno učitava trenutni dokument nakon završetka rada alata. Moguće vrijednosti su: `"yes"` ili `"no"` (zadano je `"no"`). Izborno.

Oznaka executable omogućuje sljedeće podoznake. Morate navesti barem jednu path. Sve podoznake mogu sadržavati posebne varijableQt Creator.

Podoznaka	Značenje
putanja	Staza do izvršne datoteke za pokretanje, uključujući naziv datoteke. Ako navedete naziv izvršne datoteke bez staze, Qt Creator provjerava sustavnu varijablu okruženja PATH kako bi pronašao stazu do izvršne datoteke. Stazu možete navesti više puta. Qt Creator pokušava riješiti reference u navedenom redoslijedu i pokrenuti prvu izvršnu datoteku koju pronađe. Obavezno.
argumentima	Argumenti naredbenog retka za izvršnu datoteku. Navedite niz u istom formatu (npr. što se tiče navodnika i razdvajanja argumenata) kao što biste ga naveli na naredbenom retku platforme na kojoj se alat pokreće. Izborno.
radni_direktorij	Radni direktorij za izvršnu datoteku. Izborno.
ulaz	Potencijalno višestruki niz znakova koji se prosljeđuje alatu putem standardnog ulaznog toka.

Primjer

<?xml version="1.0" encoding="UTF-8"?>
<externaltool id="sort">
    <description>Sorts the selected text</description>
    <description xml:lang="de">Sortiert den ausgewaehlten Text</description>
    <displayname>Sort Selection</displayname>
    <displayname xml:lang="de">Auswahl Sortieren</displayname>
    <category>Text</category>
    <category xml:lang="de">Text</category>
    <executable output="replaceselection" error="ignore">
        <path>sort</path>
        <input>%{CurrentDocument:Selection}</input>
        <workingdirectory>%{CurrentDocument:Path}</workingdirectory>
    </executable>
</externaltool>

Qt Creator Pravila kodiranja

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.