Jäljitysvälilehti

Jäljitysvälilehden avulla voit asettaa käyttöympäristön vianmääritystilaan ja ottaa käyttöön jäljityksen, jolloin konsoliin tulee vianmäärityslauseita.

Jäljitysvälilehti

 

Jäljitys

Käyttöympäristöön kuuluu mekanismi, jonka avulla lisäosan toimintaa voidaan jäljittää ajon aikana. Sen avulla voit käyttää jäljitysmääritteitä, joiden avulla jäljitystiedot tulostetaan konsoliin.

Nämä määritteet on määritetty .options-tiedostoissa. Näiden ominaisuustiedostojen on sijaittava lisäosan juuressa, ja niillä on oltava seuraava syntaksi:

Esimerkiksi edellä valitulla org.eclipse.ui.ide-tiedostolla on .options-tiedosto, joka sisältää kolme avain/arvo-paria:

Voit tarkistaa koodissa, onko lisäosa vianmääritystilassa (eli tarkistaa päävalitsimen tilan) tarkistamalla <Activator>.isDebugging()-metodin paluuarvon. <Activator> on se luokka, joka on määritetty lisäosan MANIFEST.MF-tiedoston Bundle-Activator-otsikossa.

Yksittäisten määritteiden nimien arvot voi noutaa kutsumalla metodia Platform.getDebugOption(optionName).

 

Jäljityksen käyttöönotto

Kun asetus Ota valittujen lisäosien jäljitys käyttöön on valittu, PDE aloitetaan -debug <tiedostonimi> -ohjelma-argumentin kera. Ohjelma-argumentin<tiedostonimi>-osa on PDE:n luoma ominaisuustiedosto, joka sisältää sekä jäljitettävien lisäosien avain/arvo-pareja että kunkin jäljitysmääritteen tilan.

Huomaa, että jäljitysmääritteiden vaihdosta jäljitysvälilehdessä ei seuraa muutoksia .options-tiedostoon. Jäljitysmääritteiden arvot tallennetaan metatietoina aloituskokoonpanoon ja kopioidaan pääominaisuustiedostoon, joka välitetään ajonaikaiselle ympäristölle -debug-argumentin avulla.