Om du skapar en tillämpning som inte är baserad på Eclipse-ramverket kan du ändå använda Eclipse-hjälpsystemet. Tillämpningen kan paketera och installera det fristående hjälpsystemet, en mycket liten version av Eclipse där allt utom hjälpsystemet har tagits bort. Sedan kan tillämpningen göra API-anrop från hjälpmenyn eller från användargränssnittsobjekt för att starta hjälpwebbläsaren. Det fristående hjälpsystemet har samma funktioner som det inbyggda hjälpsystemet, förutom arbetsmiljöintegrerad sammanhangsberoende hjälp, hjälpvyn och aktiv hjälp. När en tillämpning inte är Java-baserad, eller om hjälp behövs när en tillämpning inte körs, är det möjligt att använda den fristående hjälpen från ett systemskal, ett skalskript eller en skrivbordsgenväg och använda kommandoradsalternativ i stället för att anropa Java-API:er.
För fristående hjälpsystemet går det att överföra ett antal alternativ för anpassning av olika aspekter av hjälpsystemet. Följande alternativ finns:
-nl fr_FR
startas hjälpsystemet på franska i stället för det språk som anges av språkmiljön för datorn.d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar
finns i klassökvägen där [version]
är versionen för det insticksprogram du använder
(till exempel org.eclipse.help.base_3.2.0.jar
). Den klass du använder till att stara och stänga hjälpsystemet är org.eclipse.help.standalone.Help
. String
-objekt som innehåller alternativ som du vill överföra till hjälpsystemfunktionerna. Vanligen krävs alternativet eclipsehome
.
String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" };
Help
genom att överföra alternativen. Det här objektet bör sparas tills tillämpningen är klar. Help helpSystem = new Help(options);
helpSystem.start();
helpSystem.displayHelp();
Du kan även anropa hjälp för specifika primära innehållsförteckningsfiler eller -avsnitt:
helpSystem.displayHelp("/com.mycompany.mytool.doc/toc.xml"); helpSystem.displayHelp("/com.mycompany.mytool.doc/tasks/task1.htm");
När tillämpningen är klar stänger du av systemet på följande sätt:
helpSystem.shutdown();
Klassen org.eclipse.help.standalone.Help
har en huvudmetod som du kan använda till att starta fristående hjälp från kommandoraden. Syntaxen för kommandoradsargumentet är:
-command start | shutdown | (displayHelp [href]) [-eclipsehome eclipseInstallPath] [-data instanceArea] [-host helpServerHost] [-port helpServerPort] [-dir rtl] [platform options] [-vmargs JavaVMarguments]
Ett enkelt sätt att visa hjälpen är att anropa
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command displayHelp
från katalogen d:\myApp\eclipse directory, där version
är versionen för insticksprogrammet. Om du vill visa en specifik innehållsförteckningsfil eller -avsnitt använder du
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command displayHelp /com.mycompany.mytool.doc/tasks/task1.htm
Anropen ovan för visning av hjälp gör att hjälpsystemet startar och hjälpen visas och hjälpen fortsätter att vara öppen så att användaren kan fortsätta söka i hjälpen efter att kommandot har utförts. Du kan kontrollera livscykeln för hjälpsystemet med hjälp av start- och avstängningskommandona, förutom kommandot displayHelp. Du kan till exempel anropa
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command start
För fråstående hjälp krävs inte hela Eclipse-plattformspaketet.
Det är möjligt att köra den fristående hjälpen med RCP Runtime Binary med följande insticksprogram tillagda i katalogen eclipse/plugins
):
org.apache.lucene
org.eclipse.help
org.eclipse.help.appserver
org.eclipse.help.base
org.eclipse.help.ui
org.eclipse.help.webapp
org.eclipse.tomcat
org.eclipse.ui.forms
Obs! Du måste se till att följande rad ingår i filen eclipse/configuration/config.ini
:
osgi.bundles=org.eclipse.equinox.common@2:start, org.eclipse.update.configurator@3:start, org.eclipse.core.runtime@start
Vissa insticksprogram för dokumentation kan ha beroenden för andra insticksprogram, vanligen genom att de anger nödvändiga insticksprogrammen i manifestet.
De beroende insticksprogrammen måste också installeras.
Dessutom krävs implicit för insticksprogram som skapades för tidigare versioner än 3.0 av Eclipse att insticksprogrammet org.eclipse.core.runtime.compatibility
används för att de ska fungera.
Mer information om anpassning av hjälpsystemet finns i avsnittet om produktanpassning.